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
404	Not Found — resource does not exist or belongs to another org
413	Payload Too Large — exceeds max payload size (256 KB Starter / 512 KB Pro)
429	Too Many Requests — rate limit exceeded
500	Internal Server Error — unexpected failure (no details leaked)

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 delete the API key used to authenticate this request"}

Last Key Deletion Prevention

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