---
url: /errors.md
description: Error response structure, error codes, and HTTP status reference
---

# Error Handling

Use this page to understand:

* How API errors are structured
* How to use `code`, `message`, and `doc_url`

## Error Response Body

| Field              | Type     | Description                                                                                 |
| ------------------ | -------- | ------------------------------------------------------------------------------------------- |
| `errors`           | `array`  | List of one or more error objects.                                                          |
| `errors[].code`    | `string` | Stable machine-readable code for client handling.                                           |
| `errors[].message` | `string` | Human-readable detail of what failed.                                                       |
| `errors[].doc_url` | `string` | Absolute URL to the matching error-code page (domain depends on deployed docs environment). |

## Error Code Directory

## HTTP Status Code Reference

| HTTP status                 | Meaning in current API behavior                         |
| --------------------------- | ------------------------------------------------------- |
| `200 OK`                    | Successful cancellation response                        |
| `201 Created`               | Resource created successfully                           |
| `400 Bad Request`           | Request validation or client input error                |
| `401 Unauthorized`          | Missing or invalid authentication, or unknown identity  |
| `403 Forbidden`             | Authenticated caller lacks required permission or claim |
| `404 Not Found`             | Referenced entity or request does not exist             |
| `409 Conflict`              | Operation rejected due to state conflict                |
| `422 Unprocessable Content` | Request is valid JSON but violates business rules       |
| `500 Internal Server Error` | Unexpected server error                                 |