> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-docs-es/dforms/developers/api-keys.md).

# Llaves de API y MCP

El panel ya no crea ni revoca llaves de API. Las llaves que ya tienes siguen funcionando con la API REST v1. Para conectar un agente de IA, usa el conector MCP e inicia sesión con tu cuenta. Reglas, l

{% hint style="info" %}
**El panel ya no crea, lista ni revoca llaves de API.** Las llaves que ya tienes siguen funcionando con la API REST v1, con las mismas reglas de antes. Para conectar un agente de IA (Claude, ChatGPT, Claude Code, Codex, Cursor, OpenClaw, Hermes), usa el [conector MCP](https://docs.dapta.ai/dapta-docs-es/dforms/developers/mcp-connector.md): inicias sesión con tu cuenta y no hay llave que crear.
{% endhint %}

***

## Conectar un agente de IA: usa el conector

La forma recomendada de que un agente de IA trabaje en tu workspace es el conector MCP de dForms. Abre **Conecta tu agente** en el menú de la izquierda, elige tu app y sigue los pasos. El agente inicia sesión con tu cuenta, trabaja en todos los workspaces que puedes abrir y actúa con tu rol en cada uno.

Mira [Conecta tu agente de IA (MCP)](https://docs.dapta.ai/dapta-docs-es/dforms/developers/mcp-connector.md) para los pasos de cada app, y **Herramientas** en el menú de la izquierda para ver lo que puede hacer el agente.

***

## Las llaves que ya tienes

Una llave de API deja que un script o un agente llame a la API REST v1 como la persona que la creó: crear formularios, editarlos y publicarlos, volver a la versión anterior y leer respuestas y analíticas.

* **Sigue funcionando.** Envíala como `Authorization: Bearer <llave>`, igual que antes. El servidor MCP de dForms también la sigue aceptando.
* **Actúa como quien la creó.** Tiene el rol de esa persona. Si el rol cambia, o la persona sale del workspace, la llave la sigue.
* **Trátala como una contraseña.** Quien la tenga puede actuar como tú en ese workspace.

| Regla                      | Valor                                                                                |
| -------------------------- | ------------------------------------------------------------------------------------ |
| Workspaces por llave       | Uno: el workspace donde se creó                                                      |
| Llaves activas por persona | 10 por workspace                                                                     |
| Solicitudes por llave      | 120 por minuto; después de eso la API responde `429` con un encabezado `Retry-After` |
| Nombre                     | De 1 a 60 caracteres                                                                 |

### Listar y revocar

Las rutas `/v1/api-keys` de la API todavía listan, crean y revocan llaves, pero solo con una sesión iniciada: una llave nunca puede listar, crear ni revocar llaves. Un member ve y revoca sus propias llaves; un owner o admin ve y puede revocar todas las llaves activas del workspace. Revocar detiene una llave al instante y no se puede deshacer.

Si necesitas revocar una llave y no puedes llamar esa ruta, escribe a <josue@daptatech.com>.

***

## Qué puede llamar una llave

Una llave llega a las rutas que un agente necesita para crear y operar formularios, y a nada que administre el workspace. Cualquier otra ruta responde `403` con `KEY_NOT_ALLOWED`.

| Una llave puede                                                                                                                                             | Una llave no puede                                                                                   |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Crear, leer, editar, publicar, revertir, duplicar, mover y borrar formularios, y cambiar su enlace                                                          | Listar, crear ni revocar llaves                                                                      |
| Carpetas                                                                                                                                                    | Miembros, invitaciones y workspaces                                                                  |
| Definir los destinos de un formulario y probar su webhook                                                                                                   | Escribir tu perfil, tu idioma o el código de enlace del workspace                                    |
| Leer y borrar respuestas, sus archivos, las entregas y el CSV                                                                                               | Conectar o desconectar una integración                                                               |
| Analíticas y el resumen por pregunta                                                                                                                        | Listar los tipos de evento de dCal                                                                   |
| El kit de marca, las páginas del workspace y los correos de notificación                                                                                    | Las rutas de configuración de Google Sheets, Salesforce y HighLevel que usa el editor del formulario |
| Leer las integraciones: `GET /v1/integrations`, `/v1/integrations/webhooks`, `/v1/integrations/hubspot/properties`, `/v1/integrations/calendly/event-types` |                                                                                                      |

Las rutas de integraciones que una llave no puede llamar necesitan a una persona en un navegador:

* **Conectar o desconectar** una app es una pantalla de consentimiento (Google) o una credencial que escribe un owner o admin (Salesforce, HighLevel, HubSpot, Calendly), así que pasa en la página de **Integraciones**.
* **Los tipos de evento de dCal** se leen con la sesión de Dapta de la persona que inició sesión, que dForms le pasa a dCal. Una llave es una credencial solo para dForms, así que no tiene sesión que pasar. Elige el evento de dCal en el editor del formulario.
* **Configurar una tarjeta de Google Sheets, Salesforce o HighLevel** (elegir o crear la hoja, listar sus pestañas, los campos de Salesforce o los de HighLevel) le corresponde a la pestaña **Conectar** del formulario.

Solo owners y admins, también con una llave, como en el panel: los cambios al kit de marca, los correos de notificación y la prueba de webhook. La llave de un member recibe `403` con `FORBIDDEN` ahí.

***

## Destinos: Google Sheets, Salesforce y HighLevel necesitan una conexión

`PUT /v1/forms/{id}/destinations` reemplaza la lista completa de destinos de un formulario, y `POST /v1/forms` puede traer destinos en su config. Un destino de Google Sheets, de Salesforce o de HighLevel entrega a través de la conexión del propio workspace. Con una llave, dForms no guarda uno que no entregaría nada:

| Lo que envía la llave                           | Proveedor conectado | Proveedor sin conectar                                    |
| ----------------------------------------------- | ------------------- | --------------------------------------------------------- |
| Una entrada **nueva o cambiada**, activa        | Se guarda           | `400` con `INTEGRATION_NOT_CONNECTED`. No se guarda nada. |
| Una entrada **devuelta tal como está guardada** | Se guarda           | Se guarda, y aparece en `warnings`                        |
| Una entrada apagada (`"enabled": false`)        | Se guarda           | Se guarda                                                 |

"Tal como está guardada" ignora diferencias que no cambian nada, como un campo que no se envía en lugar de `null`, o un campo de Salesforce escrito como `"Email"` en lugar de `["Email"]`. En `POST /v1/forms` todavía no hay nada guardado, así que toda entrada activa de Google Sheets, Salesforce o HighLevel cuenta como nueva. Los destinos de webhook y de HubSpot no cambian. A una persona con sesión iniciada en el panel nunca se le rechaza, solo se le avisa, porque la pestaña **Conectar** guarda una tarjeta activada antes de que su app esté conectada.

Por ejemplo, un destino de Salesforce en un workspace que no ha conectado Salesforce:

{% code overflow="wrap" %}

```bash
curl -X PUT "https://api.dforms.ai/v1/forms/$FORM_ID/destinations" \
  -H "Authorization: Bearer $DFORMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destinations":[{"type":"salesforce","enabled":true,"fieldMappings":{"email_1":"Email"},"staticFields":{"LeadSource":"Web"}}]}'
```

{% endcode %}

```json
{
  "error": "INTEGRATION_NOT_CONNECTED",
  "message": "Destination 1 is a new or changed Salesforce destination, and Salesforce is not connected in this workspace, so it would deliver nothing. ...",
  "provider": "salesforce",
  "index": 0,
  "integrationsUrl": "https://app.dforms.ai/admin/integrations"
}
```

`provider` es `google-sheets`, `salesforce` o `gohighlevel`, `index` es la posición de la entrada en la lista que enviaste e `integrationsUrl` es la página donde alguien conecta la app desde un navegador. Pásale ese enlace a una persona y luego envía la misma petición otra vez. En un despliegue que no puede conectar Google Sheets, el mensaje lo dice y el cuerpo agrega `"unavailable": true`: no hay página que entregar, así que deja el destino fuera o apagado. El `message` siempre viene en inglés.

Un guardado que pasa responde con el formulario tal como quedó, más:

| Campo          | Cuándo aparece                                                                                                                                                                                                                                                                                                                                                                                                                             |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `warnings`     | Cuando una entrada activa se guardó pero todavía no entrega nada. Cada aviso trae un `code` (`INTEGRATION_NOT_CONNECTED` para una entrada que se mantuvo con su app desconectada, `DESTINATION_INCOMPLETE` para una entrada de Google Sheets todavía sin hoja o sin columna con encabezado), el `index` y el `type` de la entrada, un `message` y, si el problema es de conexión, `integrationsUrl`. `POST /v1/forms` también los reporta. |
| `sheetHeaders` | Cuando el guardado tocó la fila 1 de la hoja de un destino de Google Sheets. Su `outcome` es `written`, `unchanged`, `stale`, `foreign` o `failed`, como se explica en la [referencia de herramientas MCP](https://docs.dapta.ai/dapta-docs-es/dforms/developers/mcp-tools.md#destinos).                                                                                                                                                   |

`GET /v1/integrations` te dice antes qué está conectado: `providers`, `serverProvided`, `unavailable` (las apps que este despliegue no puede conectar, como `google-sheets` sin cliente OAuth de Google), `googlePicker` (si se puede elegir una hoja existente) y `dcal` (`{ "createEventUrl": "..." }`, o `null` cuando el despliegue no tiene dCal).

{% hint style="info" %}
Un destino de Google Sheets solo escribe en hojas que dForms creó o que alguien eligió en el panel (el permiso `drive.file` de Google). Toma el `spreadsheetId` de `GET /v1/forms/{id}`, no de un enlace a la hoja.
{% endhint %}

***

## La referencia de la API

La API publica su propio documento OpenAPI 3.1 en `https://api.dforms.ai/openapi.json`, generado desde la misma API, así que siempre está al día. Documenta `PUT /v1/forms/{id}/destinations` con su cuerpo, `warnings` y `sheetHeaders`, el rechazo `INTEGRATION_NOT_CONNECTED` y los `warnings` de `POST /v1/forms`, y marca con el esquema `apiKey` cada ruta que puede llamar una llave.

Los campos `signatureHeader` y `timeoutMs` de un webhook se configuran solo en el panel. Con una llave de API, una entrada de webhook que trae cualquiera de los dos se rechaza con `400` (código de problema `UNSUPPORTED_FIELD`), aunque coincida con lo guardado, así que déjalos fuera. Mira [API pública y límites de tasa](https://docs.dapta.ai/dapta-docs-es/dforms/developers/public-api.md#el-documento-openapi).

Los endpoints sin autenticar que usa cada formulario público están en [API pública y límites de tasa](https://docs.dapta.ai/dapta-docs-es/dforms/developers/public-api.md).

## Qué sigue

* [Conecta tu agente de IA (MCP)](https://docs.dapta.ai/dapta-docs-es/dforms/developers/mcp-connector.md): la forma recomendada de conectar un agente, sin llave.
* [Referencia de herramientas MCP](https://docs.dapta.ai/dapta-docs-es/dforms/developers/mcp-tools.md): las mismas reglas para un agente conectado por MCP.
* [Privacidad del conector MCP](https://docs.dapta.ai/dapta-docs-es/dforms/developers/mcp-privacy.md): qué lee y qué registra el conector.
* [API pública y límites de tasa](https://docs.dapta.ai/dapta-docs-es/dforms/developers/public-api.md): los endpoints abiertos detrás de cada formulario público.
* [Webhooks](https://docs.dapta.ai/dapta-docs-es/dforms/connect/webhooks.md): envía cada respuesta a tus propios sistemas sin consultar a cada rato.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dapta.ai/dapta-docs-es/dforms/developers/api-keys.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
