Errors
Hydracept uses HTTP status codes plus a stable public error envelope on failed control-plane calls.
Typical statuses
| Status | Meaning |
|---|---|
400 | Invalid request / policy rejection |
401 | Missing or invalid Hydracept API key / session |
402 | Budget exceeded |
403 | Not allowed for this principal / project / environment |
404 | Capability, job, or resource not found |
409 | Conflict (including idempotency conflicts) |
422 | Request validation failed |
429 | Rate limited |
503 | Provider unavailable |
Envelope
Error bodies commonly include:
code— stable Hydracept error codemessage— human-readable explanation- optional detail fields for validation failures
Do not parse provider-native error strings as the primary contract. Prefer Hydracept code values from the public OpenAPI and runtime responses.
Idempotency
Durable job submits accept idempotencyKey. Replaying the same key with a conflicting payload returns 409 rather than creating a second job.