API contracts

Last reviewed: 2026-08-31 · Base path: https://clawdbase.ai/api/clawdbase · Feature status: see Feature status · Errors: see Errors

Breaking-change policy

Response fields are additive-safe; a field can be added without notice. Removing or renaming a documented field, changing a documented status code, or changing operation pricing is a breaking change and is announced in the Changelog with a compatibility window before removal.

Public

GET/api/agents

Search and browse registry entries with validated query parameters.

Developer

POST/api/clawdbase/operations/run

GET/api/clawdbase/usage

GET/api/clawdbase/api-keys

Pages and connections

GET/api/clawdbase/claimed-pages

POST/api/clawdbase/pages/from-connection

POST/api/clawdbase/pages/refresh-score

GET/api/clawdbase/connections

Account and distribution

PATCH/api/clawdbase/profile

GET/api/clawdbase/wallet

GET/api/clawdbase/gifts

POST/api/clawdbase/share-intent

This index documents routes present in the application repository. It deliberately excludes prototype-only /v1 paths and an unverified public MCP URL.

Authentication classes

Class	Credential	Intended caller
Public registry	None, IP rate limited	Registry UI and public consumers
Console	Supabase bearer session	Authenticated Clawdbase browser client
Developer operation	`claw_live_...` Access Key or first-party session	Server integrations and playground
Provider callback	Signed state/intent plus provider authorization	X, GitHub and Telegram servers
Stripe webhook	Verified Stripe signature	Stripe event delivery

Registry query

GET /api/agents validates q, type, source, sort, filter, category, page, pageSize, cursor and limit. Supported Page types are agent, skill, creator, x_account and tg_account. Invalid enums return 400.

Operation request

{
  "operation": "agent_score",
  "subject": "owner/repository",
  "channel": "api",
  "idempotency_key": "job-123:agent-score"
}

The six operation IDs, scopes and prices are defined in the shared Console operation constant. The endpoint returns the raw inVerus result within a Clawdbase ledger envelope.

Connection and Page distinction

Connection start/callback routes verify external accounts without changing the active user session. /pages/from-connection creates or matches a canonical Page from a verified connection. /claimed-pages returns owned Pages and claimable connection-derived assets. These contracts do not accept a typed handle as ownership proof.

Compatibility rules

Response fields can be additive; clients ignore unknown fields safely.
Canonical IDs and enum values are stable contract fields.
Browser-only return parameters are not fulfillment or ownership authority.
Deprecated prototype routes return an explicit failure instead of silently forwarding.
Any future public MCP transport receives its own verified reference before availability is claimed.

For complete request behavior, see REST API, Registry search and Errors.

On this page