Error Codes

PromptJang uses standard HTTP status codes with JSON error bodies.

Error Response Format

{
  "error": "Human-readable error message"
}

HTTP Status Codes

Code	Meaning
400	Bad Request — invalid input, missing required fields, endpoint disabled
401	Unauthorized — missing or invalid API key / session token, invalid signature
402	Payment Required — billing is pending or suspended
403	Forbidden — self-service signup is disabled or the caller lacks access
404	Not Found — resource does not exist or belongs to another org
409	Conflict — limit reached or idempotency key reused with a different payload
413	Payload Too Large — exceeds the fixed 256 KB limit
429	Too Many Requests — rate limit exceeded
500	Internal Server Error — unexpected failure (no details leaked)
503	Service Unavailable — billing activation is disabled or unavailable

Common Error Scenarios

Invalid API Key

HTTP 401
{"error": "unauthorized"}

Invalid HMAC Signature

HTTP 401
{"error": "signature verification failed"}

Missing Signature Header

HTTP 401
{"error": "missing signature header"}

SSRF-Blocked URL

HTTP 400
{"error": "validation error: invalid webhook URL: private IP address"}

Payload Too Large

HTTP 413
{"error": "payload 524288 bytes exceeds limit of 262144 bytes"}

Endpoint Disabled

HTTP 400
{"error": "endpoint is disabled"}

Rate Limit Exceeded

HTTP 429
{"error": "rate limit exceeded for this endpoint"}

Auth Rate Limit Exceeded

HTTP 429
{"error": "too many login attempts, please try again later"}

Self-Deletion Prevention

HTTP 400
{"error": "cannot revoke the API key currently in use"}

Last Key Deletion Prevention

HTTP 400
{"error": "cannot revoke the last API key"}