Endor Labs uses conventional gRPC and HTTP response codes to indicate the success or failure of an API request.
gRPC status codes
| Value | Code Name | Description |
|---|---|---|
| 0 | OK | Not an error; returned on success. |
| 1 | CANCELLED | The operation was cancelled, typically by the caller. |
| 2 | UNKNOWN | Unknown error; typically indicates an unexpected error. |
| 3 | INVALID_ARGUMENT | The client specified an invalid argument. |
| 4 | DEADLINE_EXCEEDED | The deadline expired before the operation could complete. |
| 5 | NOT_FOUND | The requested entity, such as a file or directory, was not found. |
| 6 | ALREADY_EXISTS | The entity that a client attempted to create already exists. |
| 7 | PERMISSION_DENIED | The caller does not have permission to execute the specified operation. |
| 8 | RESOURCE_EXHAUSTED | Some resource has been exhausted, perhaps a per-user quota, or the entire file system is out of space. |
| 9 | FAILED_PRECONDITION | The system is not in a state required for the operation’s execution. |
| 10 | ABORTED | The operation was aborted, typically due to a concurrency issue like a sequencer check failure. |
| 11 | OUT_OF_RANGE | The operation was attempted beyond the valid range, such as seeking past the end of a file. |
| 12 | UNIMPLEMENTED | The operation is not implemented or is not supported or enabled in this service. |
| 13 | INTERNAL | Internal errors; invariants expected by the underlying system are broken. |
| 14 | UNAVAILABLE | The service is currently unavailable. This is most likely a transient condition and may be corrected by retrying with a backoff. |
| 15 | DATA_LOSS | Unrecoverable data loss or corruption. |
| 16 | UNAUTHENTICATED | The request does not have valid authentication credentials for the operation. |
For more information, see the gRPC status code documentation.
HTTP status codes
| Value | Code Name | Description |
|---|---|---|
| 200 | OK | Everything worked as expected. |
| 400 | Bad Request | The request was unacceptable, often due to missing a required parameter. |
| 401 | Unauthorized | No valid API key provided. |
| 402 | Request Failed | The parameters were valid but the request failed. |
| 403 | Forbidden | The API key doesn’t have permissions to perform the request. |
| 404 | Not Found | The requested resource doesn’t exist. |
| 409 | Conflict | The request conflicts with another request, possibly due to using the same key. |
| 429 | Too Many Requests | Too many API requests were sent to Endor Labs in a short time. We recommend using an exponential backoff strategy for your requests. |
| 500 , 502, 503, 504 | Server Errors | Something went wrong on the Endor Labs side (these are rare). |