Error format

All errors share one shape:

{
  "errors": [
    { "code": "validation_error", "message": "boardId is required.", "field": "boardId" }
  ]
}

Status	When
400	Validation failed or the operation was rejected by business rules (e.g. a mandatory field is missing, a state transition is not allowed).
401	Missing, invalid, revoked or expired API key; workspace license not active.
403	The key lacks the scope, or the service account's role may not perform the action.
404	The record does not exist or is not visible to the key's role.
422	Idempotency-Key reused with a different request.
429	Rate limit exceeded.
5xx	Unexpected error — retry with backoff.

code values are stable identifiers you can branch on; message is human-readable English and may change.