# root_key_required (/docs/errores/root_key_required)

Este endpoint solo acepta una llave root o una sesión de cuenta.

|                    |                                                      |
| ------------------ | ---------------------------------------------------- |
| **Código**         | `root_key_required`                                  |
| **Tipo**           | `permission_error` — Credencial válida, no permitida |
| **HTTP**           | `403`                                                |
| **¿Reintentable?** | No                                                   |

## Qué hacer [#qué-hacer]

Administrar llaves es una potestad de la llave root. Acuña una desde una sesión de cuenta con `POST /dashboard/api_keys \{"name": "…", "root": true\}`; vuelve como `sk_live_root_…` / `sk_test_root_…` y es la credencial que toma `POST /v1/api_keys`.

> **Advertencia**
>
> Reintentar el mismo request va a fallar igual. Cambia el request, no la frecuencia.

## El sobre [#el-sobre]

```json
{
  "error": {
    "type": "permission_error",
    "code": "root_key_required",
    "message": "…",
    "hint": "Key management is a root-key power. Mint a root key from an account session with `POST /dashboard/api_keys {\"name\": \"…\", \"root\": true}`; it comes back as `sk_live_root_…` / `sk_test_root_…` and is the credential `POST /v1/api_keys` takes.",
    "retriable": false,
    "doc_url": "https://docs.facturia.cl/errors/root_key_required",
    "request_id": "req_01K2R7Q9M4T2VB"
  }
}
```

Programa contra `code`, nunca contra `message` — la prosa se puede reescribir, el código no (§5.8).

`hint` y `retriable` llegan en la respuesta, con estos mismos valores: son función del `code` y salen del mismo diccionario que sirve `GET /v1/error_codes`, así que el sobre y el diccionario no pueden discrepar. `hint` va en inglés a propósito — el español de este código es esta ficha. Más en [El sobre de error](/docs/errores).

## También [#también]

- [Todos los códigos](/docs/errores/codigos): La tabla completa, agrupada por dónde te la vas a encontrar.

- [El sobre de error](/docs/errores): Los nueve tipos, el request_id y cómo manejarlos en la práctica.

La copia legible por máquina de esta ficha vive en `GET /v1/error_codes`, sin autenticación.