# Gestión de API Keys

> URL: https://foura.ai/es/docs/dashboard/api-keys
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

La página API Keys te permite crear, ver y administrar las claves que tus aplicaciones usan para llamar a la API de FourA.

## Cómo ver tus claves

La página muestra cada clave a la que tienes acceso: tus claves personales y cada clave propiedad de una organización a la que perteneces. La membresía es lo que otorga el acceso, por lo que un miembro común también ve las claves de la organización.

| Columna | Qué muestra |
|--------|---------------|
| Nombre | Nombre para mostrar y, si definiste una, la descripción |
| Propietario | `Personal` o el nombre de la organización |
| Prefijo de la clave | Los primeros caracteres de la clave seguidos de una máscara (`pk_live_a1b2••••••••`), con un botón Mostrar o un icono de candado en una clave heredada |
| Estado | Activa o Inactiva |
| Creada | Cuándo se creó la clave |
| Último uso | Cuándo realizó una solicitud la clave por última vez |

Busca por nombre o descripción, filtra por Activa o Inactiva y ordena por Nombre, Propietario, Estado, Creada o Último uso. La dirección de ordenamiento alterna entre descendente, ascendente y desactivado.

### El filtro de propietario

Si perteneces al menos a una organización, aparece un menú desplegable **Propietario** junto al cuadro de búsqueda: **Todo**, **Personal** o una entrada por organización. Esto restringe la lista a las claves con ese propietario, y el mismo control en Información general, Métricas, Actividad y Proxy sigue tu selección, para que las cinco páginas siempre coincidan sobre el tráfico de quién estás viendo.

## Crear una clave

Haz clic en **Crear clave** sobre la lista (**Crear clave de API** en la página vacía antes de tu primera clave) y completa lo siguiente:

| Campo | Requerido | Descripción |
|-------|----------|-------------|
| Nombre | Sí | Una etiqueta descriptiva, por ejemplo "production-scraper" o "staging-test" |
| Descripción | No | Notas sobre el uso de esta clave |
| Propietario | Sí, si estás en una organización | Personal o cualquier organización a la que pertenezcas. El selector solo aparece cuando tienes al menos una. |

Cualquier miembro de una organización puede crear una clave que le pertenezca a esta, sin importar su rol. Ese es el propósito del ajuste: el consumo de una clave de la organización se factura al propietario de la organización, de modo que un desarrollador no necesita una clave personal que le facture en silencio a él en lugar de a la empresa.

La clave completa se muestra una vez justo después de la creación en un cuadro de diálogo listo para copiar. Puedes volver a verla más tarde con **Mostrar**. Las claves usan el prefijo `pk_live_` y tienen el formato `pk_live_a1b2c3d4e5f6...`. Recibirás un correo electrónico confirmando que la clave fue creada.

Tu plan define cuántas claves activas puedes tener: tus claves personales más las claves de las organizaciones de las que eres propietario. Una clave creada para una organización se descuenta del plan de su propietario. Al llegar al límite, la creación de claves se rechaza con un mensaje que indica el número de tu plan, así que desactiva o elimina una clave que ya no uses, o mejora tu plan.

## Revelar una clave

Haz clic en el icono del ojo junto al prefijo enmascarado de una clave para ver su secreto completo nuevamente. El panel te pedirá confirmación y luego abrirá un diálogo con la clave en texto plano, un botón para copiar y una breve cuenta regresiva. Después de la cuenta regresiva, el diálogo borra el secreto de la página.

Cada visualización se registra en el log de auditoría, ya que expone una credencial activa.

Cualquier persona con la que se comparta la key puede revelarla: su propietario personal o cualquier miembro de la organización a la que pertenece.

### Keys heredadas

Las keys creadas antes del lanzamiento de la función para revelar muestran el icono de un candado en lugar del ojo y no se pueden revelar. Solo se almacenó su hash, por lo que el secret original es irrecuperable. Para actualizar una key heredada, abre el menú de acciones y selecciona **Regenerate**. El nuevo secret se podrá revelar a partir de ese momento.

## Qué puede hacer cada rol

En una key personal puedes hacer todo. En una key de organización, se aplican tres niveles:

| Acción | Miembro | Administrador | Propietario |
|--------|--------|-------|-------|
| Usar la key y revelarla | Sí | Sí | Sí |
| Renombrarla, editar la descripción | Sí | Sí | Sí |
| Habilitarla o deshabilitarla | No | Sí | Sí |
| Regenerar el secret | No | Sí | Sí |
| Eliminarla | No | Sí | Sí |
| Moverla fuera de la organización | No | No | Sí |

Disable y Edit permanecen en la fila pero aparecen en gris con una nota que explica el motivo. Regenerate, Transfer y Delete no aparecen en el menú si tu rol no puede usarlos. La API rechaza las mismas acciones, por lo que una integración no puede eludir la interfaz.

La división responde al impacto de cada acción para quienes comparten la key. Cambiar el nombre es inofensivo. Regenerar o deshabilitar detiene la integración de cada compañero en el instante en que ocurre. Mover una key fuera de la empresa la retira de ella y asigna su uso al plan propio de quien la toma, por lo que esa acción corresponde únicamente al propietario.

## Editar una key

Haz clic en **Edit** para actualizar el nombre y la descripción. La propiedad no se cambia en este cuadro de diálogo: usa **Transfer**.

**View Metrics** en el menú de acciones abre Overview filtrado por esa key.

## Activar y desactivar

Usa **Disable** o **Enable** en la fila. Desactivar una key bloquea cada API request que la utilice, y puedes reactivarla en cualquier momento. El cambio surte efecto en menos de un minuto.

## Regenerar una key

Si sospechas que una key ha quedado expuesta, abre el menú de acciones y elige **Regenerate**. Esto genera un nuevo secret para el mismo ID de key. El secret anterior deja de funcionar en cuestión de un minuto. El nombre, el propietario y todas las demás opciones de configuración se mantienen iguales.

El nuevo secret sigue estando disponible para revelarse después de cerrar el cuadro de diálogo, por lo que no necesitas copiarlo a la perfección en el primer intento.

## Transferir una key

**Transfer** en el menú de acciones transfiere una key entre la propiedad personal y la de la organización sin regenerar el secret. Se conservan el ID de la key, sus métricas y su historial de actividad. Solo cambia el propietario y, con ello, a quién se factura el uso.

| Movimiento | Quién puede hacerlo |
|------|---------------|
| Key personal hacia una organización | Cualquier persona que pertenezca a esa organización |
| Key de la organización hacia ti mismo | El propietario de la organización |
| Entre dos organizaciones | El propietario de la organización de la que sale la key |

Una key que se mueve a una organización se une a su equipo predeterminado "Everyone", que es lo que la hace visible para los miembros. Una key que se transfiere hacia afuera sale de todos los equipos en los que estaba.

## Eliminar una key

Abre el menú de acciones y elige **Eliminar**. Eliminar una clave que ya has usado antes la inhabilita: la clave deja de autenticar y permanece en la lista como **Inactiva**, por lo que su historial de Actividad y Métricas conserva su nombre. Las claves que nunca se han usado se eliminan por completo.

Recibirás un correo electrónico cuando se elimine una clave.

## Claves de organización y facturación

El uso de una clave perteneciente a una organización se descuenta del plan del **propietario de la organización**, sin importar quién haya ejecutado la request. La página de [Uso y límites](https://foura.ai/docs/dashboard/quota) del propietario contabiliza esas claves junto con las personales y separa ambas categorías.

## Relacionado

- [Autenticación](https://foura.ai/docs/getting-started/authentication): Cómo funcionan las claves API con la API
- [Organizaciones](https://foura.ai/docs/dashboard/teams-and-orgs): Roles, miembros y acceso compartido
- [Uso y límites](https://foura.ai/docs/dashboard/quota): Qué claves se descuentan de tu plan
- [Resumen del panel](https://foura.ai/docs/dashboard/overview): Todas las secciones del panel
