Cursor Admin API: как пользоваться API команды

Cursor Admin API — это HTTP API для данных вашей team: участники, usage-метрики, spending и доступ к моделям. Авторизация — Basic Auth, API key как username. Канон: Admin API.

Связка: spend limits, Teams Analytics, API keys. Pillar: n8n для начинающих.

Для кого этот разбор

• Platform/DevOps тянет usage в свой BI без ручного CSV.
• Finance хочет spend текущего цикла по members.
• Security смотрит audit logs (login, role changes, MCP…).
• Нужно выставлять member spend limits пачкой, не кликами в UI.

Авторизация и база

• Base: https://api.cursor.com.
• Auth: Basic, username = API key, password пустой (curl -u YOUR_API_KEY:).
• Создание ключей, rate limits и best practices — в API Overview (ссылка из docs Admin API).
• Org-wide across teams — отдельно Organizations / Organization API.

Эндпоинт	Зачем	Заметка docs
/teams/members	Список members (id, email, name, role, isRemoved)	GET
/teams/audit-logs	События безопасности и настроек	До 20 req/min/team; окно дат ≤ 30 дней
/teams/daily-usage-data	Дневные метрики Tab/Agent/chat…	Окно ≤ 30 дней; без pagination — только active
/teams/spend	Spend текущего billing cycle	spendCents / overallSpendCents
/teams/user-spend-limit	Лимит одному user	До 250 req/min/team; integer $ или null
/teams/user-spend-limits	До 100 лимитов за запрос	Preview; 20 req/min/team
/teams/filtered-usage-events	События usage + chargedCents	Сверка с /teams/spend через sum chargedCents

Сверка: cursor.com/docs/account/teams/admin-api (проверка 2026-09-12). Имена полей и лимиты rate — из docs; свои ключи в статью не вставляем.

Быстрый старт: members и spend

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

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

В teamMemberSpend смотрите spendCents (on-demand цикла) и overallSpendCents (on-demand + included). Поля лимитов: monthlyLimitDollars, hardLimitOverrideDollars, effectivePerUserLimitDollars. Docs отмечают доп. precision у cents-полей с 2026-06-04 для сверки с инвойсом.

Выставить spend limit через API

curl -X POST https://api.cursor.com/teams/user-spend-limit \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user_…",
    "spendLimitDollars": 100
  }'

• spendLimitDollars — только integer dollars.
• 0 = лимит $0 (не «безлимит»).
• null = снять/очистить лимит.
• Пачка до 100 users — /teams/user-spend-limits (preview).

UI-эквивалент и политика highest applicable limit — в usage limits. На pooled Enterprise member limits идут от total usage.

Audit logs и daily usage

• Audit: фильтры eventTypes, users, даты; примеры типов — login, add_user, user_spend_limit, mcp_server_config, privacy_mode.
• Daily usage: POST с epoch ms; без page/pageSize вернутся только active users за период.
• Для billable reconciliation docs рекомендуют /teams/filtered-usage-events и сумму chargedCents, а не «сырые» счётчики subscriptionIncludedReqs.

Сильные стороны

• Автоматизация spend limits без ручного клика по Members.
• Audit trail для security-ревью.
• Стыковка с BI через daily usage / filtered events.

Типичные ошибки

• Путать 0 и null у spendLimitDollars.
• Тянуть daily-usage окном > 30 дней одним запросом.
• Сверять инвойс по raw event counters вместо chargedCents.
• Складывать API key в git/HTML статьи.

FAQ: Cursor Admin API

Вывод

Cursor Admin API — Basic Auth к api.cursor.com для members, audit, usage и spend limits. Лимиты в UI и API — одна политика; pool и alerts разбирайте рядом: pooled usage, spend alerts.