Core Conceptsv1

Errors and request IDs

Interpret structured errors and use request IDs for troubleshooting.

Updated 12/07/2026

On this page

Error response

Amakora APIs return a structured error with a stable category, a safe message, and a request ID.

json

{
  "error": "validation_failed",
  "message": "The request payload is invalid.",
  "requestId": "req_example"
}

Confirm the selected application and environment.

Validate the request against the published API schema.

Check credential status and required scopes.

Use the request ID to locate the redacted request log.

Retry only transient failures and use idempotency controls for mutating operations.

Amakora AI can explain authorized, redacted error details but never receives raw credentials.

Ask Nexra AI for implementation steps or error guidance.