Skip to main content

​
Base URL

All API endpoints are served under: 
https://api.agenticwallet.cobo.com

​
Authentication

Pass your API key in the X-API-Key request header: 
curl https://api.agenticwallet.cobo.com/api/v1/wallets \
  -H "X-API-Key: <your-api-key>"
API keys are scoped to a principal and optionally to a pact. To create one, use the Create API key endpoint or the caw CLI.

​
Response format

Every response is wrapped in a standard envelope: 
{
  "success": true,
  "result": { ... },
  "message": "",
  "suggestion": "",
  "meta": null
}
FieldTypeDescription
successbooleantrue on success, false on error.
resultobjectThe response payload.
messagestringOptional human-readable message.
suggestionstringOptional hint for agents on how to proceed.
metaobject | nullPagination metadata for list endpoints (see below).
On error, the envelope uses error instead of result: 
{
  "success": false,
  "error": "Not found",
  "suggestion": ""
}

​
Pagination

List endpoints support cursor-based pagination via after and before query parameters, and an optional limit.
ParameterDescription
limitMaximum number of items to return.
afterReturn items after this cursor (next page).
beforeReturn items before this cursor (previous page).
Cursors are returned in the meta field of the response: 
{
  "success": true,
  "result": [ ... ],
  "meta": {
    "has_more": true,
    "after": "cursor-token",
    "before": null
  }
}
To fetch the next page, pass the returned after value as the after parameter in your next request. When has_more is false, you have reached the end of the list.

​
Policy denials

When an operation is blocked by a policy, the API returns HTTP 403 with a machine-readable error body. See Handle policy denial for the full error structure and retry patterns.