API errors

internal_error

Something failed on Firsty's side. The request may or may not have taken effect, so check the resource's state before trying again.

500application/problem+json

What it means

The request was valid, but the platform failed to process it. The outcome is unknown: the operation may have completed just before the failure, or not started.

A retry with the same X-Idempotency-Key within 48 hours returns this same response rather than running the operation again.

500 · application/problem+json

{
  "type": "https://developers.firsty.app/errors/internal_error",
  "title": "Internal server error",
  "status": 500,
  "detail": "An unexpected error occurred",
  "code": "internal_error"
}

How to handle it

Retry reads with exponential backoff and jitter.
For a write, read the resource's state first. Retry with a fresh X-Idempotency-Key only if the operation did not take effect.
If the error persists, contact Firsty support with the X-Request-Id response header value and the time of the request.

Errors reference