Every API error has the shape { "error": "HEN-xxxx", "message": "...", "request_id": "..." }. The first digit of the code identifies the family: 1 for malformed requests, 2 for auth, 3 for missing things, 4 for conflicts, 5 for limits, 6 for server trouble, 7 for webhooks, and 8 for regions.
HTTP 400
HEN-1001: Egg not well formed
The request body could not be parsed.
HTTP 400
HEN-1002: Missing required field
A required field was absent from the request.
HTTP 400
HEN-1003: Invalid field value
A field was present but its value was out of range or the wrong type..
HTTP 400
HEN-1004: Unknown field
The request included a field that this endpoint does not recognize..
HTTP 413
HEN-1005: Payload too large
The request body exceeded the 10 MB limit for this endpoint..
HTTP 401
HEN-2001: Not logged in
No credentials were supplied.
HTTP 401
HEN-2002: Token expired
The API token has passed its expiry time..
HTTP 401
HEN-2003: Token revoked
The token was revoked by a rooster, or by an automated rotation policy..
HTTP 403
HEN-2004: Insufficient pecking order
Your role does not permit this action.
HTTP 403
HEN-2005: IP not allowed
The request came from an address outside the coop's allowlist..
HTTP 403
HEN-2006: SSO required
This coop enforces single sign-on, and password or token logins are disabled..
HTTP 404
HEN-3001: Coop not found
No coop exists with that ID, or you do not have permission to see it..
HTTP 404
HEN-3002: Hen not found
The instance ID does not exist.
HTTP 404
HEN-3003: Egg not found
The artifact was never published, or has been garbage-collected after its retention window..
HTTP 410
HEN-3004: Resource gone
The resource was deleted.
HTTP 409
HEN-4001: Name already taken
A coop, flock, or service with that name already exists in this scope..
HTTP 409
HEN-4002: Deployment in progress
Another deployment is already rolling out for this service..
HTTP 409
HEN-4003: Version conflict
The resource was modified by someone else since you read it..
HTTP 422
HEN-4004: Dependency not satisfied
You tried to delete or change a resource that others still depend on..
HTTP 504
HEN-4101: Database timeout
A service waited too long for the database to respond..
HTTP 429
HEN-5001: Too many pecks
You exceeded the rate limit for your plan..
HTTP 429
HEN-5002: Quota exceeded
You reached your plan's limit for a resource, such as seats or coops..
HTTP 402
HEN-5003: Payment required
The account has an overdue invoice and certain actions are suspended..
HTTP 500
HEN-6001: Internal fox
Something went wrong on our side.
HTTP 502
HEN-6002: Bad gateway
An upstream service sent an invalid response..
HTTP 503
HEN-6003: Coop temporarily closed
The service is under maintenance or overloaded..
HTTP 504
HEN-6004: Gateway timeout
The request took longer than 30 seconds to process..
HTTP 400
HEN-7001: Invalid webhook signature
The signature header did not match the computed HMAC..
HTTP 400
HEN-7002: Webhook endpoint unreachable
Pollosoft could not connect to the URL when verifying it..
HTTP 400
HEN-8001: Region unavailable
The requested region is not accepting new coops..
HTTP 409
HEN-8002: Replication lag too high
A failover was refused because the replica is too far behind..