# Claves de API de la organización Conecta tus programas y automatizaciones con la misma API que usa UTILIA OS, con una clave que actúa con los permisos de una persona de tu equipo. Una clave de API de la organización deja que un programa de tu empresa (un script, un cuadro de mando o una automatización que corre en un servidor) trabaje con UTILIA OS por **la misma API que usa la aplicación**, en `https://os.utilia.ai/api`. La clave actúa en nombre de una **persona responsable** de tu equipo, con sus permisos y recortada a lo que marques al crearla, y todo lo que hace queda a nombre de esa persona. La pantalla donde se crean, paso a paso, está en la guía [Crear y gestionar claves de API](https://os.utilia.ai/docs/guides/security/api-keys). ## Cuándo usar esta clave Cada credencial de UTILIA OS abre su propia puerta. Esta es la que necesitas si el programa es de tu empresa y trabaja con los datos de tu organización: **¿Qué credencial necesitas?** ¿Qué va a llamar a UTILIA OS? - Un programa de tu empresa: **Clave de API de la organización** (`Authorization: Bearer utk_…`). La misma API que la aplicación, con los permisos de una persona. Es esta sección. - Tu app, para tus usuarios: [**Clave de aplicación externa**](https://os.utilia.ai/docs/developers/getting-started/authentication) (`X-Api-Key`). Sus propios usuarios, tickets y facturas, por la API externa. - Tu web, solo para leads: [**Clave para enviar leads**](https://os.utilia.ai/docs/developers/lead-forms/leads-api) (`X-API-Key`). Solo da de alta leads en tu CRM. - Un asistente de IA: [**Conexión MCP**](https://os.utilia.ai/docs/developers/mcp/quickstart). Claude, ChatGPT o Cursor, con los permisos de quien lo conecta. _Una credencial no sirve en el sitio de otra: cada una abre solo su puerta._ Si tu aplicación tiene que actuar en nombre de cada persona que la usa, con su propio consentimiento, lo tuyo es [Iniciar sesión con UTILIA](https://os.utilia.ai/docs/developers/oauth/overview). La comparación completa de las credenciales está en [Autenticación con clave de acceso](https://os.utilia.ai/docs/developers/getting-started/authentication#qué-credencial-abre-cada-puerta). ## Antes de empezar - **El aplicativo Integraciones en el plan.** Si sale del plan, las claves dejan de funcionar (`403 MODULE_NOT_ENABLED`), pero se siguen viendo y se pueden revocar. - **El permiso «Gestionar las claves de API»** para crearlas. Con «Ver las claves de API» solo se consultan. De partida, el Super Administrador tiene los dos y el Gerente, solo el de ver. - **Una persona responsable activa.** De partida eres tú. Solo un Super Administrador puede poner una clave a nombre de otra persona. - **Un servidor donde guardarla.** UTILIA OS rechaza la clave cuando la petición llega desde un navegador. ## Crear la clave En **Ajustes › Claves de API**, pulsa **Nueva clave** y, si te pregunta para qué la quieres, elige **Acceso a la API**. Le das un nombre, eliges los permisos y la caducidad y, en **Opciones avanzadas**, el límite de peticiones por hora. Si tienes la verificación en dos pasos, te pide el código antes de crearla. Al pulsar **Crear la clave** ves el secreto entero **una sola vez**: `utk_` seguido de 43 caracteres. Guárdalo en el gestor de secretos de tu servidor. UTILIA OS solo conserva su huella, y en la lista verás sus 12 primeros caracteres (`utk_Ab12Cd34`), que bastan para reconocerla. ## De la clave a tu programa Una clave pasa por cuatro momentos, y cada uno tiene su página en esta sección: **La vida de una clave** 1. [**Créala**](https://os.utilia.ai/docs/guides/security/api-keys) (Ajustes › Claves de API): Persona responsable, permisos, caducidad y límite. 2. [**Pruébala**](https://os.utilia.ai/docs/developers/organization-api-keys/first-request) (Tu servidor): Pregúntale quién es y qué puede hacer. 3. [**Úsala**](https://os.utilia.ai/docs/developers/organization-api-keys/permissions) (Tu servidor): Las rutas de la aplicación, con los permisos de la clave. 4. [**Renuévala o retírala**](https://os.utilia.ai/docs/developers/organization-api-keys/expiry-renewal-revocation) (Ajustes › Claves de API): Antes de que caduque, si se filtra o cuando sobre. _Cada paso lleva a la página que lo explica._ Los cupos de peticiones y dónde queda anotado lo que hace la clave están en [Límites, uso y auditoría](https://os.utilia.ai/docs/developers/organization-api-keys/limits-and-usage). Las rutas con las que la pantalla crea, cambia y revoca claves, para quien quiera automatizar esa gestión con la sesión de una persona, están en [La API de gestión de claves](https://os.utilia.ai/docs/developers/organization-api-keys/management-api). > **Atención: Trátala como una contraseña** > > Una clave no pide la verificación en dos pasos: quien la tenga puede usarla. Guárdala en un gestor de secretos, nunca en el código de una web ni en un repositorio, y revócala en cuanto sospeches que se ha filtrado. Una clave sin caducidad vale hasta que la revoques. ## Siguiente paso - [Crear y gestionar claves de API](https://os.utilia.ai/docs/guides/security/api-keys): La pantalla paso a paso, para quien administra la organización. - [Autenticación con clave de acceso](https://os.utilia.ai/docs/developers/getting-started/authentication): Qué credencial abre cada puerta de UTILIA OS.