Handle API Errors

Queue API errors use:

{
  "error": {
    "code": "SERVICE_NOT_ALLOWED",
    "message": "Credential is not authorized for this service."
  }
}

Never parse the human-readable message.

Status	Representative codes
400	`REPLAY_PROTECTION_REQUIRED`, `IDEMPOTENCY_KEY_REQUIRED`, `INVALID_JSON`
401	`AUTHENTICATION_REQUIRED`, `INVALID_CREDENTIAL`, `STALE_REQUEST`
403	`INSUFFICIENT_SCOPE`, `LOCATION_NOT_ALLOWED`, `SERVICE_NOT_ALLOWED`
404	`SERVICE_NOT_FOUND`, `TICKET_NOT_FOUND`
409	`REPLAY_DETECTED`, `IDEMPOTENCY_CONFLICT`, `QUEUE_UNIT_EDGE_MANAGED`
413	`REQUEST_TOO_LARGE`
422	`VALIDATION_ERROR`
429	`RATE_LIMITED`

Log the stable code, HTTP status, correlation ID, and operation identity. Do not log API keys, raw PINs, or webhook secrets. Structured Widget Push uses the same { "error": { "code", "message" } } shape and can include details for schema issues.

Status	Representative codes
400	`INVALID_JSON`, `INVALID_IDEMPOTENCY_KEY`
401	`AUTHENTICATION_REQUIRED`
403	`WIDGET_NOT_FOUND_OR_FORBIDDEN`
404	`WIDGET_UNAVAILABLE`
409	`IDEMPOTENCY_KEY_REUSED`, `STALE_SOURCE_SEQUENCE`
413	`PAYLOAD_TOO_LARGE`
415	`UNSUPPORTED_CONTENT_TYPE`
422	`SCHEMA_VALIDATION_FAILED`, `UNSUPPORTED_WIDGET_TYPE`, `WIDGET_TYPE_MISMATCH`
429	`RATE_LIMITED`

Schema errors can include an issue list under error.details. Correct those fields before retrying.

Build with Layarva

Queue API Reference

Structured Widget API Reference

Prayer Schedule API Reference

Structured Widget Push errors

​Structured Widget Push errors

​Related guides

Structured Widget Push errors

Related guides