Cursor – API de Administración

La API de Administración te permite acceder programáticamente a los datos de tu equipo, incluyendo información de miembros, métricas de uso y detalles de gastos. Construye paneles personalizados, herramientas de monitoreo o integra con flujos de trabajo existentes.

La API está en su primera versión. Estamos expandiendo las capacidades basándonos en comentarios - ¡déjanos saber qué endpoints necesitas!

Autenticación

Todas las solicitudes de API requieren autenticación usando una clave de API. Solo los administradores del equipo pueden crear y gestionar claves de API. Las claves de API están vinculadas a la organización, son visibles para todos los administradores y no se ven afectadas por el estado de la cuenta del creador original.

Crear una Clave de API

Navega a cursor.com/dashboard → pestaña Settings → Cursor Admin API Keys
Haz clic en Create New API Key
Dale a tu clave un nombre descriptivo (ej., “Integración del Panel de Uso”)
Copia la clave generada inmediatamente - no la verás de nuevo

Formato: key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Usar tu Clave de API

Usa tu clave de API como el nombre de usuario en la autenticación básica: Usando curl con autenticación básica:

curl https://api.cursor.com/{route} -u API_KEY:

O establece el encabezado Authorization directamente:

Authorization: Basic {base64_encode('API_KEY:')}

URL Base

Todos los endpoints de la API utilizan:

https://api.cursor.com

Endpoints

Obtener Miembros del Equipo

Recupera todos los miembros del equipo y sus detalles.

GET /teams/members

Respuesta

Devuelve un array de objetos de miembros del equipo:

{
  teamMembers: {
    name: string;
    email: string;
    role: 'owner' | 'member' | 'free-owner';
  }[];
}

Ejemplo de Respuesta

{
  "teamMembers": [
    {
      "name": "Alex",
      "email": "developer@company.com",
      "role": "member"
    },
    {
      "name": "Sam",
      "email": "admin@company.com",
      "role": "owner"
    }
  ]
}

Ejemplo de Solicitud

curl -X GET https://api.cursor.com/teams/members \
  -u YOUR_API_KEY:

Obtener Datos de Uso Diario

Recupera métricas detalladas de uso diario para tu equipo dentro de un rango de fechas. Proporciona información sobre ediciones de código, uso de asistencia de IA y tasas de aceptación.

POST /teams/daily-usage-data

Cuerpo de la Solicitud

Parámetro	Tipo	Requerido	Descripción
`startDate`	number	Sí	Fecha de inicio en milisegundos epoch
`endDate`	number	Sí	Fecha de fin en milisegundos epoch

El rango de fechas no puede exceder 90 días. Realiza múltiples solicitudes para períodos más largos.

Respuesta

{
  data: {
    date: number;
    isActive: boolean;
    totalLinesAdded: number;
    totalLinesDeleted: number;
    acceptedLinesAdded: number;
    acceptedLinesDeleted: number;
    totalApplies: number;
    totalAccepts: number;
    totalRejects: number;
    totalTabsShown: number;
    totalTabsAccepted: number;
    composerRequests: number;
    chatRequests: number;
    agentRequests: number;
    cmdkUsages: number;
    subscriptionIncludedReqs: number;
    apiKeyReqs: number;
    usageBasedReqs: number;
    bugbotUsages: number;
    mostUsedModel: string;
    applyMostUsedExtension?: string;
    tabMostUsedExtension?: string;
    clientVersion?: string;
    email?: string;
  }[];
  period: {
    startDate: number;
    endDate: number;
  };
}

Campos de Respuesta

Campo	Descripción
`date`	Fecha en milisegundos epoch
`isActive`	Usuario activo en este día
`totalLinesAdded`	Líneas de código agregadas
`totalLinesDeleted`	Líneas de código eliminadas
`acceptedLinesAdded`	Líneas agregadas de sugerencias de IA aceptadas
`acceptedLinesDeleted`	Líneas eliminadas de sugerencias de IA aceptadas
`totalApplies`	Operaciones de aplicación
`totalAccepts`	Sugerencias aceptadas
`totalRejects`	Sugerencias rechazadas
`totalTabsShown`	Completaciones de tab mostradas
`totalTabsAccepted`	Completaciones de tab aceptadas
`composerRequests`	Solicitudes de Composer
`chatRequests`	Solicitudes de chat
`agentRequests`	Solicitudes de agente
`cmdkUsages`	Usos de la paleta de comandos (Cmd+K)
`subscriptionIncludedReqs`	Solicitudes de suscripción
`apiKeyReqs`	Solicitudes de clave API
`usageBasedReqs`	Solicitudes de pago por uso
`bugbotUsages`	Usos de detección de errores
`mostUsedModel`	Modelo de IA más frecuente
`applyMostUsedExtension`	Extensión de archivo más usada para aplicaciones
`tabMostUsedExtension`	Extensión de archivo más usada para tabs
`clientVersion`	Versión de Cursor
`email`	Email del usuario

Ejemplo de Respuesta

{
  "data": [
    {
      "date": 1710720000000,
      "isActive": true,
      "totalLinesAdded": 1543,
      "totalLinesDeleted": 892,
      "acceptedLinesAdded": 1102,
      "acceptedLinesDeleted": 645,
      "totalApplies": 87,
      "totalAccepts": 73,
      "totalRejects": 14,
      "totalTabsShown": 342,
      "totalTabsAccepted": 289,
      "composerRequests": 45,
      "chatRequests": 128,
      "agentRequests": 12,
      "cmdkUsages": 67,
      "subscriptionIncludedReqs": 180,
      "apiKeyReqs": 0,
      "usageBasedReqs": 5,
      "bugbotUsages": 3,
      "mostUsedModel": "gpt-4",
      "applyMostUsedExtension": ".tsx",
      "tabMostUsedExtension": ".ts",
      "clientVersion": "0.25.1",
      "email": "developer@company.com"
    },
    {
      "date": 1710806400000,
      "isActive": true,
      "totalLinesAdded": 2104,
      "totalLinesDeleted": 1203,
      "acceptedLinesAdded": 1876,
      "acceptedLinesDeleted": 987,
      "totalApplies": 102,
      "totalAccepts": 91,
      "totalRejects": 11,
      "totalTabsShown": 456,
      "totalTabsAccepted": 398,
      "composerRequests": 67,
      "chatRequests": 156,
      "agentRequests": 23,
      "cmdkUsages": 89,
      "subscriptionIncludedReqs": 320,
      "apiKeyReqs": 15,
      "usageBasedReqs": 0,
      "bugbotUsages": 5,
      "mostUsedModel": "claude-3-opus",
      "applyMostUsedExtension": ".py",
      "tabMostUsedExtension": ".py",
      "clientVersion": "0.25.1",
      "email": "developer@company.com"
    }
  ],
  "period": {
    "startDate": 1710720000000,
    "endDate": 1710892800000
  }
}

Solicitud de Ejemplo

curl -X POST https://api.cursor.com/teams/daily-usage-data \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": 1710720000000,
    "endDate": 1710892800000
  }'

Obtener Datos de Gastos

Recupera información de gastos para el mes calendario actual con búsqueda, ordenamiento y paginación.

POST /teams/spend

Cuerpo de la Solicitud

Parámetro	Tipo	Requerido	Descripción
`searchTerm`	string	No	Buscar en nombres de usuario y correos electrónicos
`sortBy`	string	No	Ordenar por: `amount`, `date`, `user`. Por defecto: `date`
`sortDirection`	string	No	Dirección de ordenamiento: `asc`, `desc`. Por defecto: `desc`
`page`	number	No	Número de página (indexado desde 1). Por defecto: `1`
`pageSize`	number	No	Resultados por página

Respuesta

{
  teamMemberSpend: {
    spendCents: number;
    fastPremiumRequests: number;
    name: string;
    email: string;
    role: 'owner' | 'member' | 'free-owner';
    hardLimitOverrideDollars: number;
  }[];
  subscriptionCycleStart: number;
  totalMembers: number;
  totalPages: number;
}

Campos de la Respuesta

Campo	Descripción
`spendCents`	Gasto total en centavos
`fastPremiumRequests`	Solicitudes de modelo premium rápido
`name`	Nombre del miembro
`email`	Correo electrónico del miembro
`role`	Rol en el equipo
`hardLimitOverrideDollars`	Anulación de límite de gasto personalizado
`subscriptionCycleStart`	Inicio del ciclo de suscripción (milisegundos de época)
`totalMembers`	Total de miembros del equipo
`totalPages`	Total de páginas

Respuesta de Ejemplo

{
  "teamMemberSpend": [
    {
      "spendCents": 2450,
      "fastPremiumRequests": 1250,
      "name": "Alex",
      "email": "developer@company.com",
      "role": "member",
      "hardLimitOverrideDollars": 100
    },
    {
      "spendCents": 1875,
      "fastPremiumRequests": 980,
      "name": "Sam",
      "email": "admin@company.com",
      "role": "owner",
      "hardLimitOverrideDollars": 0
    },
  ],
  "subscriptionCycleStart": 1708992000000,
  "totalMembers": 15,
  "totalPages": 1
}

Solicitudes de Ejemplo

Datos básicos de gasto:

curl -X POST https://api.cursor.com/teams/spend \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{}'

Buscar usuario específico con paginación:

curl -X POST https://api.cursor.com/teams/spend \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "searchTerm": "alex@company.com",
    "page": 2,
    "pageSize": 25
  }'

Obtener Datos de Eventos de Uso

Recupera eventos de uso detallados para tu equipo con opciones completas de filtrado, búsqueda y paginación. Este endpoint proporciona información granular sobre llamadas individuales a la API, uso de modelos, consumo de tokens y costos.

POST /teams/filtered-usage-events

Cuerpo de la Solicitud

Parámetro	Tipo	Requerido	Descripción
`startDate`	number	No	Fecha de inicio en milisegundos epoch
`endDate`	number	No	Fecha de fin en milisegundos epoch
`userId`	number	No	Filtrar por ID de usuario específico
`page`	number	No	Número de página (indexado desde 1). Por defecto: `1`
`pageSize`	number	No	Número de resultados por página. Por defecto: `10`
`email`	string	No	Filtrar por dirección de correo electrónico del usuario

Respuesta

{
  totalUsageEventsCount: number;
  pagination: {
    numPages: number;
    currentPage: number;
    pageSize: number;
    hasNextPage: boolean;
    hasPreviousPage: boolean;
  };
  usageEvents: {
    timestamp: string;
    model: string;
    kindLabel: string;
    maxMode: boolean;
    requestsCosts: number;
    isTokenBasedCall: boolean;
    tokenUsage?: {
      inputTokens: number;
      outputTokens: number;
      cacheWriteTokens: number;
      cacheReadTokens: number;
      totalCents: number;
    };
    isFreeBugbot: boolean;
    userEmail: string;
  }[];
  period: {
    startDate: number;
    endDate: number;
  };
}

Campos de Respuesta Explicados

Campo	Descripción
`totalUsageEventsCount`	Número total de eventos de uso que coinciden con la consulta
`pagination`	Metadatos de paginación para navegar por los resultados
`timestamp`	Marca de tiempo del evento en milisegundos epoch
`model`	Modelo de IA utilizado para la solicitud
`kindLabel`	Categoría de uso (ej., “Usage-based”, “Included in Business”)
`maxMode`	Si el modo máximo estaba habilitado
`requestsCosts`	Costo en unidades de solicitud
`isTokenBasedCall`	Verdadero cuando el evento se cobra como un evento basado en uso
`tokenUsage`	Consumo detallado de tokens (disponible cuando isTokenBasedCall es verdadero)
`isFreeBugbot`	Si este fue un uso gratuito de bugbot
`userEmail`	Correo electrónico del usuario que hizo la solicitud
`period`	Rango de fechas de los datos consultados

Respuesta de Ejemplo

{
  "totalUsageEventsCount": 113,
  "pagination": {
    "numPages": 12,
    "currentPage": 1,
    "pageSize": 10,
    "hasNextPage": true,
    "hasPreviousPage": false
  },
  "usageEvents": [
    {
      "timestamp": "1750979225854",
      "model": "claude-4-opus",
      "kindLabel": "Usage-based",
      "maxMode": true,
      "requestsCosts": 5,
      "isTokenBasedCall": true,
      "tokenUsage": {
        "inputTokens": 126,
        "outputTokens": 450,
        "cacheWriteTokens": 6112,
        "cacheReadTokens": 11964,
        "totalCents": 20.18232
      },
      "isFreeBugbot": false,
      "userEmail": "developer@company.com"
    },
    {
      "timestamp": "1750979173824",
      "model": "claude-4-opus",
      "kindLabel": "Usage-based",
      "maxMode": true,
      "requestsCosts": 10,
      "isTokenBasedCall": true,
      "tokenUsage": {
        "inputTokens": 5805,
        "outputTokens": 311,
        "cacheWriteTokens": 11964,
        "cacheReadTokens": 0,
        "totalCents": 40.16699999999999
      },
      "isFreeBugbot": false,
      "userEmail": "developer@company.com"
    },
    {
      "timestamp": "1750978339901",
      "model": "claude-4-sonnet-thinking",
      "kindLabel": "Included in Business",
      "maxMode": true,
      "requestsCosts": 1.4,
      "isTokenBasedCall": false,
      "isFreeBugbot": false,
      "userEmail": "admin@company.com"
    }
  ],
  "period": {
    "startDate": 1748411762359,
    "endDate": 1751003762359
  }
}

Solicitudes de Ejemplo

Obtener todos los eventos de uso con paginación predeterminada:

curl -X POST https://api.cursor.com/teams/filtered-usage-events \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{}'

Filtrar por rango de fechas y usuario específico:

curl -X POST https://api.cursor.com/teams/filtered-usage-events \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": 1748411762359,
    "endDate": 1751003762359,
    "email": "developer@company.com",
    "page": 1,
    "pageSize": 25
  }'

Obtener eventos de uso para un usuario específico con paginación personalizada:

curl -X POST https://api.cursor.com/teams/filtered-usage-events \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "userId": 12345,
    "page": 2,
    "pageSize": 50
  }'

API de Listas de Bloqueo de Repositorios

Agrega repositorios y usa patrones para evitar que archivos o directorios sean indexados o utilizados como contexto para tu equipo.

Obtener Listas de Bloqueo de Repositorios del Equipo

Recupera todas las listas de bloqueo de repositorios configuradas para tu equipo.

GET /settings/repo-blocklists/repos

Respuesta

Devuelve un array de objetos de lista de bloqueo de repositorios:

{
  repos: {
    id: string;
    url: string;
    patterns: string[];
  }[];
}

Respuesta de Ejemplo

{
  "repos": [
    {
      "id": "repo_123",
      "url": "https://github.com/company/sensitive-repo",
      "patterns": ["*.env", "config/*", "secrets/**"]
    },
    {
      "id": "repo_456",
      "url": "https://github.com/company/internal-tools",
      "patterns": ["*"]
    }
  ]
}

Solicitud de Ejemplo

curl -X GET https://api.cursor.com/settings/repo-blocklists/repos \
  -u YOUR_API_KEY:

Insertar o Actualizar Listas de Bloqueo de Repositorios

Reemplaza las listas de bloqueo de repositorios existentes para los repositorios proporcionados. Nota: Este endpoint solo sobrescribirá los patrones para los repositorios proporcionados. Todos los demás repositorios no se verán afectados.

POST /settings/repo-blocklists/repos/upsert

Cuerpo de la Solicitud

Parámetro	Tipo	Requerido	Descripción
repos	array	Sí	Array de objetos de lista de bloqueo de repositorios

Cada objeto de repositorio debe contener:

Campo	Tipo	Requerido	Descripción
url	string	Sí	URL del repositorio a bloquear
patterns	string[]	Sí	Array de patrones de archivos a bloquear (se admiten patrones glob)

Respuesta

Devuelve la lista actualizada de listas de bloqueo de repositorios:

{
  repos: {
    id: string;
    url: string;
    patterns: string[];
  }[];
}

Ejemplo de Solicitud

curl -X POST https://api.cursor.com/settings/repo-blocklists/repos/upsert \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "repos": [
      {
        "url": "https://github.com/company/sensitive-repo",
        "patterns": ["*.env", "config/*", "secrets/**"]
      },
      {
        "url": "https://github.com/company/internal-tools", 
        "patterns": ["*"]
      }
    ]
  }'

Eliminar Lista de Bloqueo de Repositorio

Eliminar un repositorio específico de la lista de bloqueo.

DELETE /settings/repo-blocklists/repos/:repoId

Parámetros

Parámetro	Tipo	Requerido	Descripción
repoId	string	Sí	ID de la lista de bloqueo de repositorio a eliminar

Respuesta

Devuelve 204 No Content al eliminar exitosamente.

Ejemplo de Solicitud

curl -X DELETE https://api.cursor.com/settings/repo-blocklists/repos/repo_123 \
  -u YOUR_API_KEY:

Ejemplos de Patrones

Patrones comunes de lista de bloqueo:

* - Bloquear todo el repositorio
*.env - Bloquear todos los archivos .env
config/* - Bloquear todos los archivos en el directorio config
**/*.secret - Bloquear todos los archivos .secret en cualquier subdirectorio
src/api/keys.ts - Bloquear archivo específico

Comenzar

Núcleo

Contexto

Integraciones

Modelos

Configuración

Cuenta

Solución de problemas

​Autenticación

​Crear una Clave de API

​Usar tu Clave de API

​URL Base

​Endpoints

​Obtener Miembros del Equipo

​Respuesta

​Ejemplo de Respuesta

​Ejemplo de Solicitud

​Obtener Datos de Uso Diario

​Cuerpo de la Solicitud

​Respuesta

​Campos de Respuesta

​Ejemplo de Respuesta

​Solicitud de Ejemplo

​Obtener Datos de Gastos

​Cuerpo de la Solicitud

​Respuesta

​Campos de la Respuesta

​Respuesta de Ejemplo

​Solicitudes de Ejemplo

​Obtener Datos de Eventos de Uso

​Cuerpo de la Solicitud

​Respuesta

​Campos de Respuesta Explicados

​Respuesta de Ejemplo

​Solicitudes de Ejemplo

​API de Listas de Bloqueo de Repositorios

​Obtener Listas de Bloqueo de Repositorios del Equipo

Respuesta

Respuesta de Ejemplo

Solicitud de Ejemplo

​Insertar o Actualizar Listas de Bloqueo de Repositorios

Cuerpo de la Solicitud

Respuesta

Ejemplo de Solicitud

​Eliminar Lista de Bloqueo de Repositorio

Parámetros

Respuesta

Ejemplo de Solicitud

​Ejemplos de Patrones

Autenticación

Crear una Clave de API

Usar tu Clave de API

URL Base

Endpoints

Obtener Miembros del Equipo

Respuesta

Ejemplo de Respuesta

Ejemplo de Solicitud

Obtener Datos de Uso Diario

Cuerpo de la Solicitud

Respuesta

Campos de Respuesta

Ejemplo de Respuesta

Solicitud de Ejemplo

Obtener Datos de Gastos

Cuerpo de la Solicitud

Respuesta

Campos de la Respuesta

Respuesta de Ejemplo

Solicitudes de Ejemplo

Obtener Datos de Eventos de Uso

Cuerpo de la Solicitud

Respuesta

Campos de Respuesta Explicados

Respuesta de Ejemplo

Solicitudes de Ejemplo

API de Listas de Bloqueo de Repositorios

Obtener Listas de Bloqueo de Repositorios del Equipo

Insertar o Actualizar Listas de Bloqueo de Repositorios

Eliminar Lista de Bloqueo de Repositorio

Ejemplos de Patrones