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

# Crear y revocar API keys

> Generá una clave en el back office, copiala una vez y revocala cuando deje de usarse.

## Qué es

Las API keys se administran en el back office de la empresa. Un **administrador** de esa empresa (o un superadmin) puede crearlas y revocarlas. Quien tiene rol **Solo lectura** puede ver la lista, pero no crear ni revocar.

Tero no vuelve a mostrar el secreto. En la tabla queda el nombre, el prefijo (`tero_live_xxxxxxxx…`), el alcance, las fechas y el estado.

## Dónde está

La ruta es **Back office → Configuración → Equipo → API keys**.

Si no ves la entrada, desplegá el grupo **Configuración** en la barra lateral y abrí **Equipo**. Ahí está la pestaña **API keys**, junto a **Empleados** y **Usuarios**.

## Cómo se usa

**1. Abrí API keys**

Entrá a la empresa, desplegá **Configuración → Equipo** y tocá la pestaña **API keys**.

**2. Creá la clave**

Tocá **Crear API key**. Completá un nombre opcional (por ejemplo `Carga inicial`), el alcance y, si querés, una fecha de vencimiento.

**3. Copiá la clave completa**

Aparece un diálogo **Copiá la API key ahora**. Tocá **Copiar** y guardala en un lugar seguro. Es la única vez que se muestra.

**4. Revocala cuando corresponda**

En la fila activa, tocá **Revocar** y confirmá. Las llamadas siguientes responden `api_key_revoked`.

## Configuración

* **Nombre:** etiqueta para reconocer el uso. No viaja en las llamadas.
* **Alcance:** `Solo lectura` o `Lectura y escritura`. Ver [Alcances](https://docs.pos.terominds.com/api/alcances.md).
* **Vencimiento:** opcional. Si lo dejás vacío, la clave no vence. Al vencer, las llamadas responden `api_key_expired`.
* **Creada por:** correo de quien la generó.
* **Último uso:** se actualiza cuando la clave autentica una llamada.

Hay un máximo de 50 claves por empresa. Si llegás al tope, revocá las que ya no uses.

## Tips y advertencias

> [!WARNING]
>
> Si cerrás el diálogo de copia sin guardar la clave, no hay forma de recuperarla. Creá otra y revocá la anterior si quedó sin uso.

* Una clave revocada no se reactiva.
* No compartas la misma clave entre equipos que no deban verse. Creá una por integración.
* El superadmin puede administrar las claves de cualquier empresa desde el mismo menú, con esa empresa seleccionada.

## Relacionado

> **[Autenticación](https://docs.pos.terominds.com/api/autenticacion.md)**
>
> Cómo enviar la clave a pos-api.

> **[Usuarios del back office](https://docs.pos.terominds.com/backoffice/configuracion/usuarios.md)**
>
> Quién puede crear claves.

> **[Ejemplos](https://docs.pos.terominds.com/api/ejemplos.md)**
>
> Tareas habituales con curl.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.