API error reference

40 problem types

Every Driftstack API error is an RFC 9457 application/problem+json body whose type URI points at one of these pages.

4xx — client errors

Bad Request 400 · /bad-request
Invalid auth token 400 · /invalid-auth-token
Validation Failed 400 · /validation-failed
API key expired 401 · /expired-key
Invalid credentials 401 · /invalid-credentials
Invalid API key 401 · /invalid-key
API key revoked 401 · /revoked-key
Unauthorized 401 · /unauthorized
AI credits exhausted 402 · /ai-credits-exhausted
Bundled-LLM monthly cap reached 402 · /bundled-llm-budget-exhausted
Bundled-LLM consent required 402 · /bundled-llm-consent-required
Trial ended 402 · /trial-ended
Dashboard only 403 · /dashboard-only
Email not verified 403 · /email-not-verified
Forbidden 403 · /forbidden
MFA step-up required 403 · /mfa-step-up-required
Not Found 404 · /not-found
Conflict 409 · /conflict
Device unavailable 409 · /device-unavailable
Email already registered 409 · /email-already-registered
Legal acceptance required 409 · /legal-acceptance-required
Pair-mode takeover already in flight 409 · /pair-mode-conflict
Invalid pair-mode transition 409 · /pair-mode-invalid-transition
Profile already in use 409 · /profile-in-use
Session not ready 409 · /session-not-ready
Storage quota reached 409 · /storage-quota-exceeded
Session destroyed 410 · /session-destroyed
Payload too large 413 · /payload-too-large
Proxy required 422 · /proxy-required
Proxy validation failed 422 · /proxy-validation-failed
Upgrade required 426 · /upgrade-required
Concurrent session limit reached 429 · /concurrency-limit
Too Many Requests 429 · /rate-limited
Tier limit reached 429 · /tier-limit

5xx — server / upstream errors

Internal Server Error 500 · /internal
Anthropic key required, or refused 502 · /byok-anthropic-required
Driver error 502 · /driver-error
Driver not integrated 503 · /driver-not-integrated
Feature unavailable 503 · /feature-unavailable
Session timeout 504 · /session-timeout