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
- MCP server for your store (cope-mcp): let Claude, Cursor or another MCP client read your store with your API key. On npm as
cope-mcp. - MCP for AI shopping agents (cope-sdk/mcp): let a buyer’s AI agent build a cart in your store and hand the buyer a checkout link. Ships in
cope-sdk.