Purpl Documentation
Handle errors
Use HTTP status and stable error codes to handle failed server requests.
Error response
JSON
{
"error": "APPLICATION_API_SCOPE_FORBIDDEN"
}Error responses include an HTTP status and machine-readable error code.
Common statuses
- 400 — Invalid request or store data
- 401 — Missing or invalid credential
- 403 — Missing required scope
- 404 — App, customer, or configuration not found
- 409 — Customer identity or sales configuration conflict
Retry policy
Retry only network failures and temporary server errors with limits. Fix invalid input and authorization failures before sending another request.