ShortyShorty
Developer APIErrors

Error reference

Every error the Shorty API can return, as RFC 9457 problem responses with a stable machine-readable code. Switch on the code, not the HTTP status.

Every error is an RFC 9457 application/problem+json body carrying a stable code. Switch on code, never on the human title or (alone) the HTTP status. Each code links to a page explaining when it happens and how to fix it.

CodeHTTPMeaning
unauthorized401Unauthorized
invalid_api_key401Invalid API key
insufficient_scope403Insufficient scope
feature_not_enabled403Feature not enabled
rate_limited429Rate limit exceeded
quota_exhausted429Quota exhausted
idempotency_conflict409Idempotency conflict
idempotency_key_reused422Idempotency key reused
idempotency_in_progress409Idempotency request in progress
resource_not_found404Resource not found
resource_not_ready409Resource not ready
validation_failed400Validation failed
request_too_large413Request too large
service_unavailable503Service unavailable
internal_error500Internal server error

All operations

Every endpoint of the Shorty developer API, grouped by resource, with request and response schemas and curl + TypeScript examples.

unauthorized

Unauthorized (HTTP 401): when the Shorty API returns the unauthorized error, why, and how to fix it.