> ## Documentation Index
> Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> Every secrets error code, what it means, and the state that produces it.

## Errors

| Code                             | Status | Means                                                                         |
| -------------------------------- | ------ | ----------------------------------------------------------------------------- |
| `SECRET_NOT_FOUND`               | 404    | No secret with that id **in your account**.                                   |
| `SECRET_VERSION_NOT_FOUND`       | 404    | `?version=` names a version that does not exist.                              |
| `SECRET_NAME_EXISTS`             | 409    | Another secret of yours already holds the name.                               |
| `SECRET_DELETED`                 | 409    | Reading or writing a secret that is in the recovery window. Restore it first. |
| `SECRET_PLATFORM_MANAGED`        | 403    | Writing the value or metadata of a `managed: true` secret.                    |
| `SECRET_VALUE_TOO_LARGE`         | 400    | Value over 65536 bytes.                                                       |
| `SECRET_INVALID_RECOVERY_WINDOW` | 400    | `recovery_window_seconds` outside 86400–2592000.                              |
| `KMS_KEY_NOT_FOUND`              | 404    | `kms_key_id` names no key of yours.                                           |
| `KMS_KEY_DISABLED`               | 409    | The bound key is disabled — enable it and reads resume.                       |
| `KMS_KEY_PENDING_DELETION`       | 409    | The bound key is inside its deletion window.                                  |
| `KMS_INVALID_KEY_SPEC`           | 400    | The bound key cannot bind an encryption context. Use an `aes-256` key.        |