Errors & pagination

Response envelopes

List endpoints return a page envelope:

1
{ "data": [ … ], "page": 1, "pageSize": 25, "total": 42 }

Single-resource endpoints return { "data": { … } }.

Pagination

total is the unfiltered count for the current query, so you can compute the page count as ceil(total / pageSize).

Errors

All non-2xx responses share one shape:

1
{ "error": { "code": "not_found", "message": "Customer not found." } }

Cross-organization isolation: an id that belongs to another organization always returns 404 — the API never reveals whether it exists.

Idempotency & side effects

Mutations (/assign, /release) reuse the same atomic, audit-logged services the portal and Ops Copilot use. Re-issuing an assign that already holds is safe; releasing an already-released item is a no-op.