Cursor – Admin API

Admin API, ekip üye bilgileri, kullanım metrikleri ve harcama ayrıntıları da dahil olmak üzere ekibinin verilerine programatik olarak erişmeni sağlar. Özel panolar ve izleme araçları oluşturabilir ya da mevcut iş akışlarına entegre edebilirsin.

API ilk sürümünde. Geri bildirimlere göre yetenekleri 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ğrulaması gerektirir. API anahtarlarını yalnızca ekip yöneticileri oluşturup yönetebilir. API anahtarları organizasyona bağlıdır, tüm yöneticiler tarafından görüntülenebilir ve ilk oluşturan kişinin hesap durumundan etkilenmez.

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örüntülenmeyecek

Biçim: key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API Anahtarını Kullanma

API anahtarını basic authentication’da kullanıcı adı olarak kullan: Basic auth ile 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

Takım Üyelerini Getir

Tüm takım üyelerini ve ayrıntılarını getirir.

GET /teams/members

Yanıt

Takım üyesi nesnelerinden oluşan bir dizi döner:

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

Örnek Yanıt

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

Örnek İstek

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

Günlük Kullanım Verilerini Getir

Belirli bir tarih aralığında takımın için ayrıntılı günlük kullanım metriklerini getirir. Kod düzenlemeleri, AI 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ü aşamaz. Daha uzun dönemler için birden fazla istek yap.

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ı

Alan	Açıklama
`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 öneri sayısı
`totalRejects`	Reddedilen öneri sayısı
`totalTabsShown`	Gösterilen tab tamamlama sayısı
`totalTabsAccepted`	Kabul edilen tab tamamlama sayısı
`composerRequests`	Composer istekleri
`chatRequests`	Sohbet istekleri
`agentRequests`	Agent istekleri
`cmdkUsages`	Komut paleti (Cmd+K) kullanımları
`subscriptionIncludedReqs`	Aboneliğe dahil istekler
`apiKeyReqs`	API anahtarıyla yapılan istekler
`usageBasedReqs`	Kullanım bazlı (pay-per-use) istekler
`bugbotUsages`	Hata tespiti kullanımları
`mostUsedModel`	En sık kullanılan AI modeli
`applyMostUsedExtension`	Apply için en çok kullanılan dosya uzantısı
`tabMostUsedExtension`	Tab 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,
      "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
  }
}

Örnek İstek

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

Harcama Verilerini Al

Geçerli takvim ayına ait harcama bilgilerini arama, sıralama ve sayfalama ile getirir.

POST /teams/spend

İstek Gövdesi

Parameter	Type	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şlar). 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`	Üyenin adı
`email`	Üyenin e-postası
`role`	Takımdaki rol
`hardLimitOverrideDollars`	Özel harcama limiti geçersiz kılma değeri
`subscriptionCycleStart`	Abonelik döngüsü başlangıcı (epoch milisaniye)
`totalMembers`	Toplam takım üyesi
`totalPages`	Toplam sayfa

Ö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 İstekler

Temel harcama verileri:

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

Sayfalamayla belirli bir kullanıcıyı ara:

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

Kullanım Olayı Verilerini Al

Ekibin için ayrıntılı kullanım olaylarını kapsamlı filtreleme, arama ve sayfalama seçenekleriyle getir. Bu uç nokta, tekil API çağrıları, model kullanımı, token tüketimi ve maliyetlere dair ayrıntılı içgörüler sağlar.

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ı ID’sine 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: {
    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;
  };
}

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

Alan	Açıklama
`totalUsageEventsCount`	Sorguyla eşleşen toplam kullanım olayı sayısı
`pagination`	Sonuçlarda gezinmek için sayfalama metaverisi
`timestamp`	Olay zaman damgası (epoch milisaniye)
`model`	İstek için kullanılan yapay zeka modeli
`kind`	Kullanım kategorisi (örn. “Usage-based”, “Included in Business”)
`maxMode`	Max modun etkin olup olmadığı
`requestsCosts`	İstek birimi cinsinden maliyet
`isTokenBasedCall`	Olay kullanım bazlı ücretlendirildiğinde true
`tokenUsage`	Ayrıntılı token tüketimi (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 dayalı",
      "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 dayalı",
      "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 planına 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 olaylarını 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 "Content-Type: application/json" \
  -d '{
    "startDate": 1748411762359,
    "endDate": 1751003762359,
    "email": "developer@company.com",
    "page": 1,
    "pageSize": 25
  }'

Özel sayfalamayla belirli bir kullanıcının kullanım olaylarını getir:

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 Engelleme Listeleri API

Takımın için depolar ve desenler ekleyerek dosya veya dizinlerin dizine eklenmesini ya da bağlam olarak kullanılmasını engelle.

Takım Repo Engelleme Listelerini Getir

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

GET /settings/repo-blocklists/repos

Yanıt

Repo engelleme listesi nesnelerinden oluşan bir dizi döner:

{
  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 YOUR_API_KEY:

Repo Engelleme Listelerini Ekle/Güncelle (Upsert)

Sağlanan repolar için mevcut repo engelleme listelerini değiştir. Not: Bu uç nokta yalnızca sağlanan repoların desenlerini üzerine yazar. Diğer tüm repolar etkilenmez.

POST /settings/repo-blocklists/repos/upsert

İstek Gövdesi

Parametre	Tür	Gerekli	Açıklama
repos	array	Evet	Depo engel listesi nesnelerinin dizisi

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 desenlerinin dizisi (glob desenleri desteklenir)

Yanıt

Güncellenmiş depo engel listelerini 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 Engel Listesini Sil

Belirli bir depoyu engel listesinden kaldır.

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

Parametreler

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

Yanıt

Başarılı silme işleminde 204 No Content döner.

Örnek İstek

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

Desen Örnekleri

Yaygın engel listesi desenleri:

* - 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şlayalım

Çekirdek

Bağlam

Entegrasyonlar

Modeller

Yapılandırma

Hesap

Sorun Giderme

​Kimlik Doğrulama

​API Anahtarı Oluşturma

​API Anahtarını Kullanma

​Temel URL

​Uç Noktalar

​Takım Üyelerini Getir

​Yanıt

​Örnek Yanıt

​Örnek İstek

​Günlük Kullanım Verilerini Getir

​İ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 İstekler

​Kullanım Olayı Verilerini Al

​İstek Gövdesi

​Yanıt

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

​Örnek Yanıt

​Örnek İstekler

​Repo Engelleme Listeleri API

​Takım Repo Engelleme Listelerini Getir

Yanıt

Örnek Yanıt

Örnek İstek

​Repo Engelleme Listelerini Ekle/Güncelle (Upsert)

İstek Gövdesi

Yanıt

Örnek İstek

​Depo Engel Listesini Sil

Parametreler

Yanıt

Örnek İstek

​Desen Örnekleri

Kimlik Doğrulama

API Anahtarı Oluşturma

API Anahtarını Kullanma

Temel URL

Uç Noktalar

Takım Üyelerini Getir

Yanıt

Örnek Yanıt

Örnek İstek

Günlük Kullanım Verilerini Getir

İ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 İstekler

Kullanım Olayı Verilerini Al

İstek Gövdesi

Yanıt

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

Örnek Yanıt

Örnek İstekler

Repo Engelleme Listeleri API

Takım Repo Engelleme Listelerini Getir

Repo Engelleme Listelerini Ekle/Güncelle (Upsert)

Depo Engel Listesini Sil

Desen Örnekleri