Docs

Errors and conventions

Shared behavior for authentication, writes, pagination, and failures.

Idempotency

Send a unique Idempotency-Key for create and import requests. Reusing a key with a different payload returns a conflict.

Common errors

  • 400 invalid input
  • 401 invalid, expired, or revoked credential
  • 403 missing scope or workspace permission
  • 404 resource not found in the token workspace
  • 409 idempotency or state conflict
  • 429 rate limit exceeded

Pagination

Collection endpoints document their own cursor or page parameters and return metadata alongside items.