Errors
Status codes and the error body each API returns.
On this page
Failed requests return a 4xx or 5xx status with a JSON body that explains what went wrong. Each endpoint page lists the statuses it can return.
Status codes
| Status | Meaning |
|---|---|
400 | The request is invalid, for example a missing or malformed field. |
404 | The resource does not exist. |
409 | The request conflicts with the resource's current state. Agent Registry only. |
500 | The service hit an unexpected error. |
502 | An upstream service failed. Compute only. |
503 | The service cannot handle the request right now. Compute only. |
Error body
The two APIs use slightly different error objects.
codeinteger
The HTTP status code.
error_codestring
A machine-readable error code.
messagestring
A human-readable description of the error.
{
"code": 404,
"error_code": "string",
"message": "string"
}errorstring
A short error identifier.
messagestring
A human-readable description of the error.
{
"error": "string",
"message": "string"
}