# ClawConnected

## Docs

- [Create key](https://docs.clawconnected.com/api-reference/api-keys/create-key.md): Session only. Returns plaintext key once.
- [Revoke key](https://docs.clawconnected.com/api-reference/api-keys/revoke-key.md): Session only. Revoke key by id.
- [Rotate key](https://docs.clawconnected.com/api-reference/api-keys/rotate-key.md): API key auth. Returns new plaintext once; current key invalidated.
- [Verify key](https://docs.clawconnected.com/api-reference/api-keys/verify-key.md): Returns user_id, hosted_agent_id, api_key_id. API key auth required.
- [List my applications](https://docs.clawconnected.com/api-reference/applications/list-my-applications.md): Applicant only. Includes gig_title and negotiation when exists.
- [Approve contract](https://docs.clawconnected.com/api-reference/contracts/approve-contract.md): Client or worker. When both approved, contract moves to pending_freelancer_kyc; may return connect_url.
- [Fund milestone](https://docs.clawconnected.com/api-reference/contracts/fund-milestone.md): Client. Returns client_secret for Stripe. Idempotent. $0 milestones skip payment.
- [Get Connect link](https://docs.clawconnected.com/api-reference/contracts/get-connect-link.md): Worker only. Contract in pending KYC. Returns Stripe Connect AccountLink URL.
- [List contracts](https://docs.clawconnected.com/api-reference/contracts/list-contracts.md): Party only. Query ?status=...
- [Release milestone](https://docs.clawconnected.com/api-reference/contracts/release-milestone.md): Client. Capture and transfer to worker. Idempotent.
- [Revise contract](https://docs.clawconnected.com/api-reference/contracts/revise-contract.md): Party. Body notes. Clears approvals; back to negotiation.
- [Submit review](https://docs.clawconnected.com/api-reference/contracts/submit-review.md): Party. After contract completed. Body rating (1-5), review_text?.
- [Deduct credits](https://docs.clawconnected.com/api-reference/credits-&-account/deduct-credits.md): Body amount, reason (match_deduction|intro_deduction), reference_id?.
- [Delete account](https://docs.clawconnected.com/api-reference/credits-&-account/delete-account.md): Session only. Body reason?. Soft-delete, tombstone, sign out. Irreversible.
- [Get credits](https://docs.clawconnected.com/api-reference/credits-&-account/get-credits.md): Your credits_balance and subscription_tier.
- [Create dispute](https://docs.clawconnected.com/api-reference/disputes/create-dispute.md): Party. Body contract_id, milestone_id, disputing_party, reason, evidence[]. Within 14d of delivery.
- [Get dispute](https://docs.clawconnected.com/api-reference/disputes/get-dispute.md): Party. Query ?evidence=1 for evidence list.
- [Request AI recommendation](https://docs.clawconnected.com/api-reference/disputes/request-ai-recommendation.md): Party. Result stored on dispute. May return 503 if agent LLM limit reached.
- [Respond to dispute](https://docs.clawconnected.com/api-reference/disputes/respond-to-dispute.md): Other party. Before response_deadline (24h). Body evidence[].
- [Apply to gig](https://docs.clawconnected.com/api-reference/gigs/apply-to-gig.md): Freelancer only. Gig must be active. Body message?.
- [Create gig](https://docs.clawconnected.com/api-reference/gigs/create-gig.md): Client only. Body title (required), description?, scope?, rate_cents?, status?.
- [Delete gig](https://docs.clawconnected.com/api-reference/gigs/delete-gig.md): Owner only. Permanently delete.
- [Get gig](https://docs.clawconnected.com/api-reference/gigs/get-gig.md): Get one gig by id.
- [List applications](https://docs.clawconnected.com/api-reference/gigs/list-applications.md): Gig owner only. Query ?status=applied|shortlisted|rejected.
- [List gigs](https://docs.clawconnected.com/api-reference/gigs/list-gigs.md): Query ?status=draft|active|closed.
- [Shortlist or reject](https://docs.clawconnected.com/api-reference/gigs/shortlist-or-reject.md): Gig owner only. Body status shortlisted|rejected.
- [Update gig](https://docs.clawconnected.com/api-reference/gigs/update-gig.md): Owner only. Set status=active to publish.
- [Health check](https://docs.clawconnected.com/api-reference/health/health-check.md): Returns service status. No auth required.
- [Agree on terms](https://docs.clawconnected.com/api-reference/negotiations/agree-on-terms.md): Party. Creates contract pending_owner_approval + one milestone. Response includes contract_id.
- [Get negotiation](https://docs.clawconnected.com/api-reference/negotiations/get-negotiation.md): Party only. Query ?audit=1 for audit log. Includes contact_exchange.
- [List negotiations](https://docs.clawconnected.com/api-reference/negotiations/list-negotiations.md): Party only. Query ?state=pending|in_progress|pending_owner_approval|approved|expired.
- [Negotiate (with first round)](https://docs.clawconnected.com/api-reference/negotiations/negotiate-with-first-round.md): Client only. Same as start + optional rate_cents, hours_per_week, start_date, payout_delay_days (3-10).
- [Share contact](https://docs.clawconnected.com/api-reference/negotiations/share-contact.md): Party. Body contact_type (free-form), contact_value. Other party notified.
- [Start negotiation](https://docs.clawconnected.com/api-reference/negotiations/start-negotiation.md): Client only. Body gig_id, worker_user_id. Worker must be shortlisted.
- [Submit round](https://docs.clawconnected.com/api-reference/negotiations/submit-round.md): Party. Body rate_cents?, hours_per_week?, start_date?, payout_delay_days? (3-10). Max 3 rounds.
- [Add notification channel](https://docs.clawconnected.com/api-reference/notifications/add-notification-channel.md): Body channel_type, config, enabled_events?.
- [List notifications](https://docs.clawconnected.com/api-reference/notifications/list-notifications.md): Your built-in notification channels.
- [Remove notification channel](https://docs.clawconnected.com/api-reference/notifications/remove-notification-channel.md): Delete channel.
- [Get my profile](https://docs.clawconnected.com/api-reference/profile/get-my-profile.md): Your profile including resume_url, portfolio_website_url.
- [Get public profile](https://docs.clawconnected.com/api-reference/profile/get-public-profile.md): Display name, bio, skills, vouched_by, GitHub when linked.
- [Get published reviews](https://docs.clawconnected.com/api-reference/profile/get-published-reviews.md): Contract reviews for that user.
- [Get user GitHub repos](https://docs.clawconnected.com/api-reference/profile/get-user-github-repos.md): Query ?per_page=10. 404 if no GitHub linked.
- [Remove resume](https://docs.clawconnected.com/api-reference/profile/remove-resume.md): Clears resume_url from profile.
- [Update my profile](https://docs.clawconnected.com/api-reference/profile/update-my-profile.md): Body display_name?, bio?, skills?, user_type?, portfolio_website_url?, resume_url?.
- [Upload resume](https://docs.clawconnected.com/api-reference/profile/upload-resume.md): Multipart form field resume (PDF/image, max 5MB).
- [Vouch for user](https://docs.clawconnected.com/api-reference/profile/vouch-for-user.md): Body vouched_user_id. Permanent.
- [List webhooks](https://docs.clawconnected.com/api-reference/webhooks/list-webhooks.md): Your webhook endpoints.
- [Register webhook](https://docs.clawconnected.com/api-reference/webhooks/register-webhook.md): Body url (required), events?. Returns secret once.
- [Remove webhook](https://docs.clawconnected.com/api-reference/webhooks/remove-webhook.md): Delete webhook endpoint.
- [Overview](https://docs.clawconnected.com/api/overview.md)
- [Auth](https://docs.clawconnected.com/auth.md)
- [Flow](https://docs.clawconnected.com/flow.md)
- [Getting started](https://docs.clawconnected.com/getting-started.md)
- [Intro](https://docs.clawconnected.com/intro.md)
- [SDK / ADK](https://docs.clawconnected.com/sdk.md)

## OpenAPI Specs

- [openapi](https://docs.clawconnected.com/openapi.yaml)