Error Codes

PromptJang uses standard HTTP status codes with JSON error bodies.

Error Response Format

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

HTTP Status Codes

Code	Meaning
400	Bad Request — invalid input, missing required fields
401	Unauthorized — missing or invalid API key, invalid signature
404	Not Found — resource does not exist or belongs to another org
409	Conflict — resource already exists
413	Payload Too Large — exceeds max payload size
422	Unprocessable Entity — validation failure (SSRF, invalid URL, etc.)
429	Too Many Requests — rate limit exceeded
500	Internal Server Error — unexpected failure
502	Bad Gateway — delivery target returned an error
504	Gateway Timeout — delivery target did not respond in time

Common Error Scenarios

Invalid API Key

HTTP 401
{"detail": "Unauthorized"}

Invalid HMAC Signature

HTTP 401
{"detail": "Invalid signature"}

SSRF-Blocked URL

HTTP 422
{"detail": "URL is not allowed: private IP address"}

Payload Too Large

HTTP 413
{"detail": "Payload exceeds maximum size of 1048576 bytes"}

Event Type Validation

HTTP 400
{"detail": "Invalid event type: must be 1-128 chars, alphanumeric/dash/dot/underscore"}