Cursor – Admin-API

Die Admin-API ermöglicht dir den programmgesteuerten Zugriff auf die Daten deines Teams, einschließlich Mitgliederinformationen, Nutzungsmetriken und Ausgabendetails. Bau eigene Dashboards, Monitoring-Tools oder integrier sie in bestehende Workflows.

Die API ist in ihrer ersten Version. Wir erweitern die Funktionen basierend auf Feedback – sag uns, welche Endpunkte du brauchst!

Authentifizierung

Alle API-Requests erfordern eine Authentifizierung mit einem API-Schlüssel. Nur Team-Admins können API-Schlüssel erstellen und verwalten. API-Schlüssel sind der Organisation zugeordnet, für alle Admins sichtbar und bleiben vom Kontostatus des ursprünglichen Erstellers unberührt.

API-Schlüssel erstellen

Navigiere zu cursor.com/dashboard → Settings-Tab → Cursor Admin API Keys
Klicke auf Create New API Key
Gib deinem Schlüssel einen aussagekräftigen Namen (z. B. „Usage Dashboard Integration“)
Kopiere den generierten Schlüssel sofort – du wirst ihn später nicht mehr sehen

Format: key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Deinen API-Schlüssel verwenden

Verwende deinen API-Schlüssel als Benutzernamen bei der Basic-Authentifizierung: Mit curl und Basic Auth:

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

Oder setze den Authorization-Header direkt:

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

Basis-URL

Alle API-Endpunkte nutzen:

https://api.cursor.com

Endpunkte

Teammitglieder abrufen

Ruft alle Teammitglieder und deren Details ab.

GET /teams/members

Antwort

Gibt ein Array von Teammitgliedobjekten zurück:

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

Beispielantwort

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

Beispielanfrage

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

Tägliche Nutzungsdaten abrufen

Ruft detaillierte tägliche Nutzungsmetriken für dein Team innerhalb eines Datumsbereichs ab. Liefert Einblicke in Code-Änderungen, Nutzung der KI-Unterstützung und Annahmeraten.

POST /teams/daily-usage-data

Request Body

Parameter	Typ	Erforderlich	Beschreibung
`startDate`	number	Ja	Startdatum in Epoch-Millisekunden
`endDate`	number	Ja	Enddatum in Epoch-Millisekunden

Der Datumsbereich darf 90 Tage nicht überschreiten. Für längere Zeiträume mehrere Anfragen stellen.

Antwort

{
  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;
  };
}

Antwortfelder

Feld	Beschreibung
`date`	Datum in Epoch-Millisekunden
`isActive`	Nutzer an diesem Tag aktiv
`totalLinesAdded`	Hinzugefügte Codezeilen
`totalLinesDeleted`	Gelöschte Codezeilen
`acceptedLinesAdded`	Aus akzeptierten KI-Vorschlägen hinzugefügte Zeilen
`acceptedLinesDeleted`	Aus akzeptierten KI-Vorschlägen gelöschte Zeilen
`totalApplies`	Apply-Operationen
`totalAccepts`	Akzeptierte Vorschläge
`totalRejects`	Abgelehnte Vorschläge
`totalTabsShown`	Angezeigte Tab-Completions
`totalTabsAccepted`	Akzeptierte Tab-Completions
`composerRequests`	Composer-Anfragen
`chatRequests`	Chat-Anfragen
`agentRequests`	Agent-Anfragen
`cmdkUsages`	Nutzungen der Befehlsleiste (Cmd+K)
`subscriptionIncludedReqs`	Im Abo enthaltene Anfragen
`apiKeyReqs`	API-Key-Anfragen
`usageBasedReqs`	Nutzungsbasierte Anfragen
`bugbotUsages`	Nutzungen der Bug-Erkennung
`mostUsedModel`	Am häufigsten verwendetes KI-Modell
`applyMostUsedExtension`	Am häufigsten verwendete Dateierweiterung für Applies
`tabMostUsedExtension`	Am häufigsten verwendete Dateierweiterung für Tabs
`clientVersion`	Cursor-Version
`email`	Nutzer-E-Mail

Beispielantwort

{
  "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
  }
}

Beispielanfrage

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
  }'

Ausgaben abrufen

Rufe Ausgabeninformationen für den aktuellen Kalendermonat mit Suche, Sortierung und Paginierung ab.

POST /teams/spend

Request Body

Parameter	Typ	Erforderlich	Beschreibung
`searchTerm`	string	Nein	Suche in Benutzernamen und E-Mails
`sortBy`	string	Nein	Sortieren nach: `amount`, `date`, `user`. Standard: `date`
`sortDirection`	string	Nein	Sortierrichtung: `asc`, `desc`. Standard: `desc`
`page`	number	Nein	Seitennummer (1-basiert). Standard: `1`
`pageSize`	number	Nein	Ergebnisse pro Seite

Antwort

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

Antwortfelder

Feld	Beschreibung
`spendCents`	Gesamtausgaben in Cent
`fastPremiumRequests`	Anfragen an schnelle Premium-Modelle
`name`	Name des Mitglieds
`email`	E-Mail des Mitglieds
`role`	Teamrolle
`hardLimitOverrideDollars`	Benutzerdefinierte Überschreibung des Ausgabenlimits
`subscriptionCycleStart`	Beginn des Abrechnungszyklus (Epoch-Millisekunden)
`totalMembers`	Gesamtzahl der Teammitglieder
`totalPages`	Gesamtzahl der Seiten

Beispielantwort

{
  "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
}

Beispielanfragen

Grundlegende Ausgabedaten:

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

Bestimmten Benutzer mit Pagination suchen:

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
  }'

Nutzungsereignisdaten abrufen

Hol dir detaillierte Nutzungsereignisse für dein Team mit umfassenden Filter-, Such- und Paginierungsoptionen. Dieser Endpoint liefert granulare Einblicke in einzelne API-Calls, Modellnutzung, Tokenverbrauch und Kosten.

POST /teams/filtered-usage-events

Request Body

Parameter	Type	Required	Description
`startDate`	number	No	Startdatum in Epoch-Millisekunden
`endDate`	number	No	Enddatum in Epoch-Millisekunden
`userId`	number	No	Nach bestimmter Benutzer-ID filtern
`page`	number	No	Seitennummer (1-basiert). Standard: `1`
`pageSize`	number	No	Anzahl Ergebnisse pro Seite. Standard: `10`
`email`	string	No	Nach Benutzer-E-Mail-Adresse filtern

Response

{
  totalUsageEventsCount: number;
  pagination: {
    numPages: number;
    currentPage: number;
    pageSize: number;
    hasNextPage: boolean;
    hasPreviousPage: boolean;
  };
  usageEvents: {
    timestamp: string;
    model: string;
    kind: 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;
  };
}

Erläuterung der Response-Felder

Field	Description
`totalUsageEventsCount`	Gesamtzahl der zur Abfrage passenden Nutzungsereignisse
`pagination`	Paginierungsmetadaten zur Navigation der Ergebnisse
`timestamp`	Ereigniszeitstempel in Epoch-Millisekunden
`model`	Für die Anfrage verwendetes KI-Modell
`kind`	Nutzungskategorie (z. B. „Usage-based“, „Included in Business“)
`maxMode`	Ob Max Mode aktiviert war
`requestsCosts`	Kosten in Request-Einheiten
`isTokenBasedCall`	True, wenn das Ereignis nutzungsbasiert abgerechnet wird
`tokenUsage`	Detaillierter Tokenverbrauch (verfügbar, wenn isTokenBasedCall true ist)
`isFreeBugbot`	Ob dies eine kostenlose Bugbot-Nutzung war
`userEmail`	E-Mail der Benutzerin/des Benutzers, die/der die Anfrage gestellt hat
`period`	Datumsbereich der abgefragten Daten

Beispiel-Response

{
  "totalUsageEventsCount": 113,
  "pagination": {
    "numPages": 12,
    "currentPage": 1,
    "pageSize": 10,
    "hasNextPage": true,
    "hasPreviousPage": false
  },
  "usageEvents": [
    {
      "timestamp": "1750979225854",
      "model": "claude-4-opus",
      "kind": "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",
      "kind": "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",
      "kind": "Included in Business",
      "maxMode": true,
      "requestsCosts": 1.4,
      "isTokenBasedCall": false,
      "isFreeBugbot": false,
      "userEmail": "admin@company.com"
    }
  ],
  "period": {
    "startDate": 1748411762359,
    "endDate": 1751003762359
  }
}

Beispielanfragen

Alle Nutzungsereignisse mit Standard-Paginierung abrufen:

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

Nach Datumsbereich und bestimmtem Nutzer filtern:

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
  }'

Nutzungsereignisse für einen bestimmten Nutzer mit eigener Paginierung abrufen:

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
  }'

Repo-Blocklists API

Repos und Muster hinzufügen, um zu verhindern, dass Dateien oder Verzeichnisse für dein Team indexiert oder als Kontext verwendet werden.

Team-Repo-Blocklists abrufen

Alle für dein Team konfigurierten Repository-Blocklists abrufen.

GET /settings/repo-blocklists/repos

Response

Gibt ein Array von Repository-Blocklist-Objekten zurück:

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

Beispiel-Response

{
  "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": ["*"]
    }
  ]
}

Beispiel-Request

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

Repo-Blocklists upsert

Bestehende Repository-Blocklists für die angegebenen Repos ersetzen. Hinweis: Dieser Endpoint überschreibt nur die Patterns für die angegebenen Repositories. Alle anderen Repos bleiben unverändert.

POST /settings/repo-blocklists/repos/upsert

Request Body

Parameter	Type	Required	Description
repos	array	Yes	Array von Repository-Blocklist-Objekten

Jedes Repository-Objekt muss Folgendes enthalten:

Field	Type	Required	Description
url	string	Yes	Repository-URL zum Blocklisten
patterns	string[]	Yes	Array von Dateimustern, die blockiert werden sollen (Glob-Muster werden unterstützt)

Response

Gibt die aktualisierte Liste der Repository-Blocklisten zurück:

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

Example Request

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": ["*"]
      }
    ]
  }'

Delete Repo Blocklist

Ein bestimmtes Repository aus der Blocklist entfernen.

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

Parameters

Parameter	Type	Required	Description
repoId	string	Yes	ID der zu löschenden Repository-Blocklist

Response

Gibt bei erfolgreichem Löschen 204 No Content zurück.

Example Request

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

Pattern Examples

Häufige Blocklist-Muster:

* - Gesamtes Repository blockieren
*.env - Alle .env-Dateien blockieren
config/* - Alle Dateien im config-Verzeichnis blockieren
**/*.secret - Alle .secret-Dateien in beliebigen Unterverzeichnissen blockieren
src/api/keys.ts - Konkrete Datei blockieren

Loslegen

Kern

Kontext

Integrationen

Modelle

Konfiguration

Konto

Fehlerbehebung

​Authentifizierung

​API-Schlüssel erstellen

​Deinen API-Schlüssel verwenden

​Basis-URL

​Endpunkte

​Teammitglieder abrufen

​Antwort

​Beispielantwort

​Beispielanfrage

​Tägliche Nutzungsdaten abrufen

​Request Body

​Antwort

​Antwortfelder

​Beispielantwort

​Beispielanfrage

​Ausgaben abrufen

​Request Body

​Antwort

​Antwortfelder

​Beispielantwort

​Beispielanfragen

​Nutzungsereignisdaten abrufen

​Request Body

​Response

​Erläuterung der Response-Felder

​Beispiel-Response

​Beispielanfragen

​Repo-Blocklists API

​Team-Repo-Blocklists abrufen

Response

Beispiel-Response

Beispiel-Request

​Repo-Blocklists upsert

Request Body

Response

Example Request

​Delete Repo Blocklist

Parameters

Response

Example Request

​Pattern Examples

Authentifizierung

API-Schlüssel erstellen

Deinen API-Schlüssel verwenden

Basis-URL

Endpunkte

Teammitglieder abrufen

Antwort

Beispielantwort

Beispielanfrage

Tägliche Nutzungsdaten abrufen

Request Body

Antwort

Antwortfelder

Beispielantwort

Beispielanfrage

Ausgaben abrufen

Request Body

Antwort

Antwortfelder

Beispielantwort

Beispielanfragen

Nutzungsereignisdaten abrufen

Request Body

Response

Erläuterung der Response-Felder

Beispiel-Response

Beispielanfragen

Repo-Blocklists API

Team-Repo-Blocklists abrufen

Repo-Blocklists upsert

Delete Repo Blocklist

Pattern Examples