Guides

Guides

The rules every Koast API endpoint shares, and how to use webhooks, trackers, MCP and the CLI.

GuideWhat it covers
ErrorsThe error envelope, every code and what to do about it
Paginationlimit, cursor and nextCursor on every list
IdempotencyRetry a POST safely with Idempotency-Key, required when publishing
Rate limits300 reads and 60 writes a minute per organization, and handling 429
Metrics freshnessLive reads, the short cache and asOf
VersioningWhat can change inside v1, and what never will
WebhooksEvent types, endpoints, signature verification, retries and the delivery log
TrackersSpend push into RedTrack and ClickFlare, and campaign mapping
MCPConnect an AI assistant, and the MCP tool catalog
CLIInstall koast, sign in, flags and exit codes

Access and plans

Which Koast plans can use the REST API, webhooks, the CLI and the MCP server, and what a refused call looks like.

Errors

Every error has the same JSON envelope, a stable machine code and a request id. Here is every code, its HTTP status and what to do about it.