Skip to main content

Public API

COPE’s public REST API lets vendor integrations manage released COPE resources from a COPE business workspace using JSON over HTTPS.

Contract

Authenticate with a live COPE API key (ck_live_*; keys issued earlier as cope_sk_live_* keep working). A key is scoped to one business, so no business header is needed. Dashboard sign-in tokens are not accepted. Test-mode public API keys are reserved but not accepted yet; they currently return 401 invalid_token.

API Areas

Retry 429 rate_limited after the Retry-After seconds, and 409 idempotency_conflict for a request that is still processing, unchanged. Other 4xx responses are permanent for the same request unless the operation says otherwise: fix the input before sending it again. Treat 5xx responses as transient and retry with backoff, sending the same Idempotency-Key on a write.

AI agents and MCP