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

# Referencia de la API

> API de Enterprise para consultar datos de uso de Windsurf y administrar configuraciones con autenticación mediante clave de servicio.

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

La API de Windsurf permite a los clientes Enterprise acceder de forma programática a Analytics de uso detallados y gestionar las configuraciones de uso de sus equipos.

<Note>La API está disponible solo para planes Enterprise</Note>

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

Todas las solicitudes a la API deben realizarse en:

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

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

La API de Windsurf utiliza 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 configuración de tu equipo](https://windsurf.com/team/settings)
2. Entra en la sección "Claves de servicio"
3. Crea una nueva clave de servicio con los permisos adecuados
4. Copia la clave de servicio generada para utilizarla en solicitudes a la API

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

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

| Endpoint                                                                                                         | Permiso requerido |
| ---------------------------------------------------------------------------------------------------------------- | ----------------- |
| [Custom Analytics](/es/windsurf/accounts/api-reference/custom-analytics) (`/Analytics`)                          | Analytics Read    |
| [User Page Analytics](/es/windsurf/accounts/api-reference/user-page-analytics) (`/UserPageAnalytics`)            | Teams Read-Only   |
| [Cascade Analytics](/es/windsurf/accounts/api-reference/cascade-analytics) (`/CascadeAnalytics`)                 | Teams Read-Only   |
| [Set Usage Configuration](/es/windsurf/accounts/api-reference/usage-config) (`/UsageConfig`)                     | Billing Write     |
| [Get Usage Configuration](/es/windsurf/accounts/api-reference/get-usage-config) (`/GetUsageConfig`)              | Billing Read      |
| [Get Team Credit Balance](/es/windsurf/accounts/api-reference/get-team-credit-balance) (`/GetTeamCreditBalance`) | Billing Read      |

<div id="using-service-keys">
  ### Uso de Claves de servicio
</div>

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

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

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

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

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

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

Para recibir soporte de la API o resolver dudas, ponte en contacto con [Windsurf Support](https://windsurf.com/support).