workthin

Error Format

All errors return a consistent JSON structure:

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Knowledge 550e8400-e29b-41d4-a716-446655440000 not found",
    "status": 404
  }
}

Status	Code	Description
`400`	`VALIDATION_ERROR`	Invalid request body (missing fields, bad format)
`401`	`UNAUTHORIZED`	Missing or invalid API key
`403`	`FORBIDDEN`	Key lacks permission for this scope
`404`	`NOT_FOUND`	Knowledge or resource not found
`409`	`CONFLICT`	Concurrent update conflict (etag mismatch)
`429`	`RATE_LIMITED`	Too many requests. Retry after `Retry-After` header value

The 429 response includes a Retry-After header with seconds to wait.

All errors return a consistent JSON structure:

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Knowledge 550e8400-e29b-41d4-a716-446655440000 not found",
    "status": 404
  }
}

Status	Code	Description
`400`	`VALIDATION_ERROR`	Invalid request body (missing fields, bad format)
`401`	`UNAUTHORIZED`	Missing or invalid API key
`403`	`FORBIDDEN`	Key lacks permission for this scope
`404`	`NOT_FOUND`	Knowledge or resource not found
`409`	`CONFLICT`	Concurrent update conflict (etag mismatch)
`429`	`RATE_LIMITED`	Too many requests. Retry after `Retry-After` header value

The 429 response includes a Retry-After header with seconds to wait.