---
title: Errors
description: Error codes on the BreezeWish API.
canonical: https://breezewish.com/developers/errors
raw: https://breezewish.com/developers/errors.md
apiVersion: v1
lastUpdated: 2026-10-18
category: Reference
---

# Errors

Failures use HTTP status and this body:

```json
{"error":{"code":"NOT_FOUND","message":"Request was not found.","details":{},"requestId":"req_123"}}
```

Schema: [https://api.breezewish.com/schemas/v1/error.json](https://api.breezewish.com/schemas/v1/error.json).

| HTTP | Code |
| --- | --- |
| 401 | UNAUTHENTICATED, INVALID_CREDENTIAL |
| 403 | AGENT_SCOPE_DENIED, DELEGATION_LIMIT, FORBIDDEN, STEP_UP_REQUIRED |
| 404 | NOT_FOUND |
| 409 | IDEMPOTENCY_CONFLICT |
| 429 | RATE_LIMITED |
| 400 | INVALID_INPUT |


## Common errors

| Code | Meaning |
| --- | --- |
| UNAUTHENTICATED | Missing or invalid credential. |
| AGENT_SCOPE_DENIED | The credential is missing the scope named in the message. |
| DELEGATION_LIMIT | Autonomy is below the operation. COMMIT is required to accept, approve, or check out. TRANSACT is required to confirm closure. |
| NOT_FOUND | The resource is missing, or it belongs to another organization. |
| IDEMPOTENCY_CONFLICT | The same Idempotency-Key was reused with a different body. |
| RATE_LIMITED | The caller exceeded the public or authenticated limit. |