Cursor – Admin API

Admin API, üye bilgileri, kullanım metrikleri ve harcama detayları dahil olmak üzere ekibinin verilerine programatik olarak erişmeni sağlar. Özel panolar, izleme araçları oluştur ya da mevcut iş akışlarınla entegre et.

API ilk sürümünde. Yetenekleri geri bildirimlere göre genişletiyoruz — hangi endpoint’lere ihtiyacın olduğunu bize söyle!

Kimlik doğrulama

Tüm API istekleri bir API anahtarıyla kimlik doğrulamayı gerektirir. API anahtarlarını yalnızca ekip yöneticileri oluşturabilir ve yönetebilir. API anahtarları kuruluşa bağlıdır, tüm yöneticiler tarafından görüntülenebilir ve ilk oluşturanın hesap durumundan etkilenmez.

Bir API Anahtarı Oluşturma

cursor.com/dashboard → Settings sekmesi → Cursor Admin API Keys bölümüne git
Create New API Key’e tıkla
Anahtarına açıklayıcı bir ad ver (ör. “Usage Dashboard Integration”)
Oluşturulan anahtarı hemen kopyala — bir daha gösterilmeyecek

Biçim: key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API Anahtarını Kullanma

API anahtarını temel kimlik doğrulamada kullanıcı adı olarak kullan: Temel kimlik doğrulamayla curl kullanma:

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

Ya da Authorization başlığını doğrudan ayarla:

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

Temel URL

Tüm API uç noktaları şu adresi kullanır:

https://api.cursor.com

Uç Noktalar

Ekip Üyelerini Getir

Tüm ekip üyelerini ve ayrıntılarını al.

GET /teams/members

Yanıt

Ekip üyesi nesnelerinden oluşan bir dizi döndürür:

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

Örnek Yanıt

{
  "teamMembers": [
    {
      "name": "Alex",
      "email": "developer@company.com",
      "role": "üye"
    },
    {
      "name": "Sam",
      "email": "admin@company.com",
      "role": "sahip"
    }
  ]
}

Örnek İstek

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

Günlük Kullanım Verilerini Al

Belirli bir tarih aralığında ekibin için ayrıntılı günlük kullanım metriklerini getir. Kod düzenlemeleri, yapay zeka yardımı kullanımı ve kabul oranları hakkında içgörüler sunar.

POST /teams/daily-usage-data

İstek Gövdesi

Parametre	Tür	Gerekli	Açıklama
`startDate`	number	Evet	Epoch milisaniye cinsinden başlangıç tarihi
`endDate`	number	Evet	Epoch milisaniye cinsinden bitiş tarihi

Tarih aralığı 90 günü geçemez. Daha uzun dönemler için birden fazla istek gönder.

Yanıt

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

Yanıt Alanları

Field	Description
`date`	Epoch milisaniye cinsinden tarih
`isActive`	Kullanıcı bu gün aktif mi
`totalLinesAdded`	Eklenen kod satırı
`totalLinesDeleted`	Silinen kod satırı
`acceptedLinesAdded`	Kabul edilen AI önerilerinden eklenen satır
`acceptedLinesDeleted`	Kabul edilen AI önerilerinden silinen satır
`totalApplies`	Apply işlemleri
`totalAccepts`	Kabul edilen öneriler
`totalRejects`	Reddedilen öneriler
`totalTabsShown`	Gösterilen sekme tamamlama sayısı
`totalTabsAccepted`	Kabul edilen sekme tamamlama sayısı
`composerRequests`	Composer istekleri
`chatRequests`	Sohbet istekleri
`agentRequests`	Agent istekleri
`cmdkUsages`	Komut paleti (Cmd+K) kullanımı
`subscriptionIncludedReqs`	Abonelik kapsamındaki istekler
`apiKeyReqs`	API anahtarı istekleri
`usageBasedReqs`	Kullanım başına ödeme istekleri
`bugbotUsages`	Hata bulma kullanımları
`mostUsedModel`	En sık kullanılan yapay zeka modeli
`applyMostUsedExtension`	Apply için en çok kullanılan dosya uzantısı
`tabMostUsedExtension`	Sekme için en çok kullanılan dosya uzantısı
`clientVersion`	Cursor sürümü
`email`	Kullanıcı e-postası

Örnek Yanıt

{
  "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,
      "enCokKullanilanModel": "gpt-4",
      "applyEnCokKullanilanUzanti": ".tsx",
      "tabEnCokKullanilanUzanti": ".ts",
      "istemciSurumu": "0.25.1",
      "ePosta": "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,
      "enCokKullanilanModel": "claude-3-opus",
      "applyEnCokKullanilanUzanti": ".py",
      "tabEnCokKullanilanUzanti": ".py",
      "istemciSurumu": "0.25.1",
      "ePosta": "developer@company.com"
    }
  ],
  "period": {
    "startDate": 1710720000000,
    "endDate": 1710892800000
  }
}

Örnek İstek

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

Harcama Verilerini Al

Geçerli takvim ayı için arama, sıralama ve sayfalama ile harcama bilgilerini getir.

POST /teams/spend

İstek Gövdesi

Parametre	Tür	Gerekli	Açıklama
`searchTerm`	string	Hayır	Kullanıcı adları ve e-postalarda ara
`sortBy`	string	Hayır	Şuna göre sırala: `amount`, `date`, `user`. Varsayılan: `date`
`sortDirection`	string	Hayır	Sıralama yönü: `asc`, `desc`. Varsayılan: `desc`
`page`	number	Hayır	Sayfa numarası (1’den başlayarak). Varsayılan: `1`
`pageSize`	number	Hayır	Sayfa başına sonuç sayısı

Yanıt

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

Yanıt Alanları

Alan	Açıklama
`spendCents`	Toplam harcama (sent)
`fastPremiumRequests`	Hızlı premium model istekleri
`name`	Üye adı
`email`	Üye e-postası
`role`	Ekipteki rol
`hardLimitOverrideDollars`	Özel harcama sınırı geçersiz kılma
`subscriptionCycleStart`	Abonelik döngüsü başlangıcı (epoch milisaniye)
`totalMembers`	Toplam ekip üyesi sayısı
`totalPages`	Toplam sayfa sayısı

Örnek Yanıt

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

Örnek istekler

Temel harcama verileri:

curl -X POST https://api.cursor.com/teams/spend \
  -u API_ANAHTARIN: \
  -H "İçerik Türü: application/json" \
  -d '{}'

Belirli bir kullanıcıyı sayfalamayla ara:

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

Kullanım Olayları Verilerini Al

Takımın için kapsamlı filtreleme, arama ve sayfalama seçenekleriyle ayrıntılı kullanım olaylarını getir. Bu uç nokta, tekil API çağrıları, model kullanımı, token tüketimi ve maliyetler hakkında daha ayrıntılı içgörüler sunar.

POST /teams/filtered-usage-events

İstek Gövdesi

Parametre	Tip	Gerekli	Açıklama
`startDate`	number	Hayır	Epoch milisaniye cinsinden başlangıç tarihi
`endDate`	number	Hayır	Epoch milisaniye cinsinden bitiş tarihi
`userId`	number	Hayır	Belirli kullanıcı kimliğine göre filtrele
`page`	number	Hayır	Sayfa numarası (1’den başlar). Varsayılan: `1`
`pageSize`	number	Hayır	Sayfa başına sonuç sayısı. Varsayılan: `10`
`email`	string	Hayır	Kullanıcı e-posta adresine göre filtrele

Yanıt

{
  totalUsageEventsCount: number;
  pagination: {
    numPages: number;
    currentPage: number;
    pageSize: number;
    hasNextPage: boolean;
    hasPreviousPage: boolean;
  };
  usageEvents: {
    zamanDamgasi: string;
    model: string;
    tur: string;
    maxMode: boolean;
    istekMaliyetleri: number;
    isTokenBasedCall: boolean;
    belirteçKullanimi?: {
      girisBelirtecleri: number;
      cikisBelirtecleri: number;
      önbellekYazmaBelirtecleri: number;
      önbellekOkumaBelirtecleri: number;
      toplamSent: number;
    };
    isFreeBugbot: boolean;
    kullaniciEpostasi: string;
  }[];
  period: {
    baslangicTarihi: number;
    bitisTarihi: number;
  };
}

Yanıt Alanlarının Açıklaması

Alan	Açıklama
`totalUsageEventsCount`	Sorguyla eşleşen kullanım olaylarının toplam sayısı
`pagination`	Sonuçlar arasında gezinmeye yönelik sayfalama üst verisi
`timestamp`	Olay zaman damgası (epoch milisaniyeler)
`model`	İstek için kullanılan yapay zeka modeli
`kind`	Kullanım kategorisi (ör. “Usage-based”, “Included in Business”)
`maxMode`	Maks modun etkin olup olmadığı
`requestsCosts`	İstek birimleri cinsinden maliyet
`isTokenBasedCall`	Olay kullanım bazlı olarak ücretlendirildiğinde true
`tokenUsage`	Ayrıntılı token kullanımı (isTokenBasedCall true olduğunda mevcut)
`isFreeBugbot`	Bunun ücretsiz bugbot kullanımı olup olmadığı
`userEmail`	İsteği yapan kullanıcının e-posta adresi
`period`	Sorgulanan verinin tarih aralığı

Örnek Yanıt

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

Örnek İstekler

Varsayılan sayfalamayla tüm kullanım etkinliklerini getir:

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

Tarih aralığına ve belirli bir kullanıcıya göre filtrele:

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

Özel sayfalama ile belirli bir kullanıcının kullanım etkinliklerini al:

curl -X POST https://api.cursor.com/teams/filtered-usage-events \
  -u API_ANAHTARIN: \
  -H "İçerik Türü: application/json" \
  -d '{
    "userId": 12345,
    "page": 2,
    "pageSize": 50
  }'

Kullanıcı Harcama Limitini Ayarla

Tek tek ekip üyeleri için harcama limitleri belirle. Böylece ekibindeki her kullanıcının AI kullanımı için ne kadar harcayabileceğini kontrol edebilirsin.

POST /teams/user-spend-limit

Oran sınırlaması: ekip başına dakikada 60 istek

İstek Gövdesi

Parametre	Tür	Gerekli	Açıklama
`userEmail`	string	Evet	Ekip üyesinin e-posta adresi
`spendLimitDollars`	number	Evet	Dolar cinsinden harcama limiti (yalnızca tam sayı, ondalık yok).

Kullanıcı zaten senin ekibinin bir üyesi olmalı
Yalnızca tam sayı değerleri kabul edilir (ondalık tutar kabul edilmez)
spendLimitDollars değerini 0 olarak ayarlamak limiti $0 yapar

Yanıt

Başarı ya da başarısızlığı belirten standart bir yanıt döndürür:

{
  outcome: 'başarılı' | 'hata';
  message: string;
}

Örnek Yanıtlar

Limit başarıyla belirlendi:

{
  "outcome": "başarılı",
  "message": "developer@company.com kullanıcısının harcama limiti $100 olarak ayarlandı"
}

Hata yanıtı:

{
  "outcome": "error",
  "message": "Geçersiz e-posta formatı"
}

Örnek İstekler

Harcama limiti belirle:

curl -X POST https://api.cursor.com/teams/user-spend-limit \
  -u API_ANAHTARIN: \
  -H "Content-Type: application/json" \
  -d '{
    "userEmail": "developer@company.com",
    "spendLimitDollars": 100
  }'

Repo Blocklists API

Takımın için dosya veya dizinlerin dizine alınmasını ya da bağlam olarak kullanılmasını önlemek üzere depolar ve eşleşme kalıpları ekle.

Takım Depo Engelleme Listelerini Al

Takımın için yapılandırılmış tüm depo engelleme listelerini al.

GET /settings/repo-blocklists/repos

Yanıt

Bir dizi depo engelleme listesi (blocklist) nesnesi döndürür:

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

Örnek Yanıt

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

Örnek İstek

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

Repo Engelleme Listelerini (Blocklist) Yükselt/İçer

Sağlanan repolar için mevcut repo engelleme listelerini (blocklist) yenisiyle değiştir. Not: Bu uç nokta yalnızca sağlanan repoların desenlerini (pattern) geçersiz kılar. Diğer tüm repolar etkilenmeden kalır.

POST /settings/repo-blocklists/repos/upsert

İstek Gövdesi

Parametre	Tür	Gerekli	Açıklama
repos	array	Evet	Depo engel listesi nesnelerinden oluşan dizi

Her depo nesnesi şunları içermelidir:

Alan	Tür	Gerekli	Açıklama
url	string	Evet	Engel listesine eklenecek depo URL’si
patterns	string[]	Evet	Engellenecek dosya kalıplarının dizisi (glob kalıpları desteklenir)

Yanıt

Güncellenmiş depo engel listelerinin listesini döndürür:

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

Örnek İstek

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

Depo Engelleme Listesinden Kaldır

Engelleme listesinden belirli bir depoyu kaldır.

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

Parametreler

Parametre	Tür	Gerekli	Açıklama
repoId	string	Evet	Silinecek depo engel listesinin (blocklist) kimliği

Yanıt

Başarıyla silindiğinde 204 No Content döndürür.

Örnek İstek

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

Kalıp Örnekleri

Yaygın blocklist kalıpları:

* - Tüm depoyu engelle
*.env - Tüm .env dosyalarını engelle
config/* - config dizinindeki tüm dosyaları engelle
**/*.secret - Herhangi bir alt dizindeki tüm .secret dosyalarını engelle
src/api/keys.ts - Belirli bir dosyayı engelle

Başla

Çekirdek

Bağlam

Entegrasyonlar

Modeller

Yapılandırma

Güvenlik

Hesap

Sorun giderme

​Kimlik doğrulama

​Bir API Anahtarı Oluşturma

​API Anahtarını Kullanma

​Temel URL

​Uç Noktalar

​Ekip Üyelerini Getir

​Yanıt

​Örnek Yanıt

​Örnek İstek

​Günlük Kullanım Verilerini Al

​İstek Gövdesi

​Yanıt

​Yanıt Alanları

​Örnek Yanıt

​Örnek İstek

​Harcama Verilerini Al

​İstek Gövdesi

​Yanıt

​Yanıt Alanları

​Örnek Yanıt

​Örnek istekler

​Kullanım Olayları Verilerini Al

​İstek Gövdesi

​Yanıt

​Yanıt Alanlarının Açıklaması

​Örnek Yanıt

​Örnek İstekler

​Kullanıcı Harcama Limitini Ayarla

​İstek Gövdesi

​Yanıt

​Örnek Yanıtlar

​Örnek İstekler

​Repo Blocklists API

​Takım Depo Engelleme Listelerini Al

Yanıt

Örnek Yanıt

Örnek İstek

​Repo Engelleme Listelerini (Blocklist) Yükselt/İçer

İstek Gövdesi

Yanıt

Örnek İstek

​Depo Engelleme Listesinden Kaldır

Parametreler

Yanıt

Örnek İstek

​Kalıp Örnekleri

Kimlik doğrulama

Bir API Anahtarı Oluşturma

API Anahtarını Kullanma

Temel URL

Uç Noktalar

Ekip Üyelerini Getir

Yanıt

Örnek Yanıt

Örnek İstek

Günlük Kullanım Verilerini Al

İstek Gövdesi

Yanıt

Yanıt Alanları

Örnek Yanıt

Örnek İstek

Harcama Verilerini Al

İstek Gövdesi

Yanıt

Yanıt Alanları

Örnek Yanıt

Örnek istekler

Kullanım Olayları Verilerini Al

İstek Gövdesi

Yanıt

Yanıt Alanlarının Açıklaması

Örnek Yanıt

Örnek İstekler

Kullanıcı Harcama Limitini Ayarla

İstek Gövdesi

Yanıt

Örnek Yanıtlar

Örnek İstekler

Repo Blocklists API

Takım Depo Engelleme Listelerini Al

Repo Engelleme Listelerini (Blocklist) Yükselt/İçer

Depo Engelleme Listesinden Kaldır

Kalıp Örnekleri