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

# Referencia de la API

> API Enterprise para consultar datos de uso de Devin Desktop y gestionar configuraciones con autenticación mediante clave de servicio.

<div id="overview">
  ## Descripción general
</div>

La API de Devin Desktop permite a los clientes empresariales acceder mediante programación a análisis detallados del uso y gestionar la configuración de uso de sus equipos.

<Note>La API está disponible únicamente en los planes Enterprise</Note>

<div id="base-url">
  ## URL base
</div>

Todas las solicitudes a la API deben enviarse a:

```
https://server.codeium.com/api/v1/
```

<div id="authentication">
  ## Autenticación
</div>

La API de Devin Desktop usa claves de servicio para la autenticación. Las claves de servicio deben incluirse en el cuerpo de la solicitud en todas las llamadas a la API.

<div id="creating-a-service-key">
  ### Crear una clave de servicio
</div>

1. Ve a la [página de Team Settings](https://windsurf.com/team/settings)
2. Ve a la sección "Service Keys"
3. Crea una nueva clave de servicio con los permisos adecuados
4. Copia la clave de servicio generada para usarla en las solicitudes a la API

<div id="required-permissions">
  ### Permisos requeridos
</div>

Los distintos endpoints de la API requieren permisos diferentes. Consulta la documentación de cada endpoint para conocer el permiso específico requerido:

| Endpoint                                                                                                                       | Permiso requerido |
| ------------------------------------------------------------------------------------------------------------------------------ | ----------------- |
| [Analytics personalizados](/es/desktop/accounts/api-reference/custom-analytics) (`/Analytics`)                                 | Analytics Read    |
| [Analytics de la página de usuario](/es/desktop/accounts/api-reference/user-page-analytics) (`/UserPageAnalytics`)             | Teams Read-Only   |
| [Cascade Analytics](/es/desktop/accounts/api-reference/cascade-analytics) (`/CascadeAnalytics`)                                | Teams Read-Only   |
| [Configurar la configuración de uso](/es/desktop/accounts/api-reference/usage-config) (`/UsageConfig`)                         | Billing Write     |
| [Obtener la configuración de uso](/es/desktop/accounts/api-reference/get-usage-config) (`/GetUsageConfig`)                     | Billing Read      |
| [Obtener el saldo de crédito del equipo](/es/desktop/accounts/api-reference/get-team-credit-balance) (`/GetTeamCreditBalance`) | Billing Read      |

<div id="using-service-keys">
  ### Cómo usar claves de servicio
</div>

Incluye tu clave de servicio en el cuerpo de la solicitud en todas las llamadas a la API:

```json theme={null}
{
  "service_key": "your_service_key_here",
  // ... otros parámetros
}
```

<Warning>Mantén tus claves de servicio seguras y no las expongas nunca en código del lado del cliente ni en repositorios públicos</Warning>

<div id="rate-limits">
  ## Límites de frecuencia
</div>

Las solicitudes a la API están sujetas a límites de frecuencia para garantizar la estabilidad del servicio. Si superas el límite de frecuencia, recibirás una respuesta `429 Too Many Requests`.

<div id="support">
  ## Soporte
</div>

Para obtener soporte sobre la API y resolver cualquier duda, ponte en contacto con [Soporte de Devin Desktop](https://windsurf.com/support).