API Reference

Authentication

All API requests require a Bearer token in the Authorization header:

curl -H "Authorization: Bearer capy_xxxx" https://capy.ai/api/v1/projects

Generate API tokens at capy.ai/settings/tokens.

All endpoints are served from https://capy.ai/api/v1/.

List endpoints support cursor-based pagination:

Responses include items, nextCursor (null if no more), and hasMore.

All errors return a consistent JSON structure:

{
  "error": {
    "code": "validation_error",
    "message": "Request body validation failed",
    "details": {}
  }
}

Status	Code	Description
401	`unauthorized`	Missing or invalid API token
403	`forbidden`	Token doesn’t have access to the resource
404	`not_found`	Resource not found
422	`validation_error`	Invalid request parameters
500	`internal_error`	Unexpected server error

Task IDs accept both formats:

⌘I