Справочное руководство Claude Enterprise Admin API

Это руководство охватывает лимиты расходов и запросы на увеличение лимитов расходов для вашей организации Claude Enterprise с использованием Claude Enterprise Admin API. Лимиты расходов позволяют ограничить расходы кредитов использования каждого члена организации за повторяющийся период, увидеть, откуда наследуется лимит каждого члена, и просмотреть или обработать запросы членов на повышение лимита.

Для отчётов об использовании и затратах по пользователям и временным периодам см. справочное руководство Claude Enterprise Analytics API.

Claude Enterprise Admin API в настоящее время находится в открытой бета-версии и доступен организациям на планах Enterprise с включёнными кредитами использования.

Обзор

Существует восемь конечных точек в двух ресурсах:

Ресурс	Конечные точки	Используется для
Лимиты расходов	`GET /v1/organizations/spend_limits/effective` `GET /v1/organizations/spend_limits/{spend_limit_id}` `POST /v1/organizations/spend_limits` `DELETE /v1/organizations/spend_limits/{spend_limit_id}`	Прочитайте эффективный лимит каждого члена и расходы с начала периода; установите или очистите переопределение для отдельного пользователя.
Запросы на увеличение лимитов расходов	`GET /v1/organizations/spend_limit_increase_requests` `GET /v1/organizations/spend_limit_increase_requests/{id}` `POST /v1/organizations/spend_limit_increase_requests/{id}/approve` `POST /v1/organizations/spend_limit_increase_requests/{id}/deny`	Список запросов членов на повышение лимита с контекстом, необходимым для принятия решения; одобрите или отклоните каждый запрос.

Используйте конечные точки лимитов расходов для ответа на вопросы: «Какой лимит применяется к каждому члену, откуда он берётся и насколько близко они к нему?» и для установки переопределения для отдельного пользователя. Используйте конечные точки запросов на увеличение лимитов расходов для обработки очереди запросов, отправленных членами.

Предварительные требования и аутентификация

Ваша организация должна быть на плане Claude Enterprise.
Кредиты использования должны быть включены для вашей организации. Ваш основной владелец может включить это в разделе Параметры выставления счётов в Claude.
Основному владельцу необходимо создать ключ Admin API с одной или обеими из следующих областей:
- read:spend_limits (требуется для всех конечных точек GET)
- write:spend_limits (требуется для конечных точек POST и DELETE)

Передайте ключ в заголовке x-api-key при каждом запросе.

Важно: Не делитесь ключами API публично и не проверяйте их в системе управления версиями.

Базовый URL

https://api.anthropic.com

Ограничение частоты запросов

Все восемь конечных точек имеют единый лимит для организации в 60 запросов в минуту. Запросы, превышающие лимит, возвращают 429 Too Many Requests.

Разбиение на страницы

GET /v1/organizations/spend_limits/effective и GET /v1/organizations/spend_limit_increase_requests разбиты на страницы с помощью непрозрачного курсора. Первый запрос возвращает до limit строк плюс курсор next_page. Передайте этот курсор без изменений как параметр page в следующем запросе и повторяйте, пока next_page не будет null.

Важно: Не изменяйте параметры запроса в середине последовательности. Курсоры привязаны к фильтрам, которые их выдали. Если вы измените user_ids[], status[] или actor_ids[] и передадите старый курсор, вы получите ошибку 400 с сообщением «cursor does not match current query parameters». Вместо этого начните новую последовательность с первой страницы.

Рассматривайте строку курсора как непрозрачную: не анализируйте, не изменяйте и не создавайте её самостоятельно.

Сериализация параметров списка

Параметры списка используют нотацию скобок: повторите имя параметра с [] для каждого значения.

user_ids[]=user_01AbCdEfGh&user_ids[]=user_01JkLmNoPq

Ответы об ошибках

Статус	Значение
400	Неверный ввод, неподдерживаемое значение параметра, курсор страницы не соответствует текущим параметрам или не выполнено предварительное условие (см. раздел «Проверки» для каждой конечной точки).
401	Отсутствует заголовок `x-api-key`.
403	Ключ API не имеет требуемой области (`read:spend_limits` или `write:spend_limits`).
404	Ресурс не найден, или ключ API неизвестен, истёк или отозван.
429	Превышен лимит частоты запросов.
500	Внутренняя ошибка.

Тела ошибок имеют следующую структуру:

{"type": "error", "error": {"type": "<error_type>", "message": "..."}, "request_id": "req_..."}

error.type — это зависящий от статуса дискриминатор: invalid_request_error (400), authentication_error (401), permission_error (403), not_found_error (404), rate_limit_error (429), api_error (500). request_id всегда присутствует и это значение, которое нужно указать при обращении в службу поддержки. Таблица валидаций под каждой конечной точкой содержит конкретные сообщения.

Концепции

Иерархия лимитов расходов

Расходы кредитов использования каждого участника ограничены эффективным лимитом расходов, определяемым из иерархии уровней области. Если участник не имеет переопределения для конкретного пользователя, он наследует лимит, установленный для его уровня места, его группы (если ваша организация использует групповые лимиты) или организационное значение по умолчанию.

Чтение GET /v1/organizations/spend_limits/effective возвращает каждого текущего участника с его разрешённым эффективным лимитом, откуда был разрешён этот лимит (source) и его расходы с начала периода. Установка переопределения для конкретного пользователя через POST /v1/organizations/spend_limits привязывает участника к определённому лимиту независимо от того, что он иначе наследовал бы. Удаление переопределения возвращает его к наследуемому лимиту.

Область

Область определяет уровень, на котором записывается или разрешается лимит расходов:

Тип	Поля	Значение
`user`	`user_id`	Конкретный участник. `user_id` соответствует идентификаторам, возвращаемым конечными точками API администратора для пользователей.
`seat_tier`	`seat_tier`	Значение по умолчанию для уровня места. Значения `seat_tier` — это полностью квалифицированные идентификаторы, такие как `enterprise_standard` или `enterprise_tier_1`; могут быть добавлены дополнительные значения.
`rbac_group`	`rbac_group_id`	Значение по умолчанию для группы, когда ваша организация управляет лимитами по группам.
`organization`	—	Значение по умолчанию для всей организации.

scope.type — это открытая строка. Клиенты должны рассматривать неизвестные значения как непрозрачные и переходить дальше, а не завершаться с ошибкой. Дополнительные типы областей могут быть добавлены в будущем.

Период

period — это повторяющееся окно, в течение которого применяется лимит и сбрасываются расходы. На данный момент единственное значение — "monthly".

period — это открытая строка. Клиенты должны рассматривать неизвестные значения как непрозрачные и переходить дальше, а не завершаться с ошибкой. Дополнительные значения периода могут быть добавлены в будущем.

Суммы и валюта

Все денежные значения — это строки в младших единицах валюты выставления счётов организации (центы для USD). Например, "50000" представляет 500.00 USD. Разберите как десятичное число и разделите на 100, чтобы отобразить доллары. Избегайте двоичной плавающей точки для больших значений.

amount допускает значение null: null означает неограниченно (без лимита). "0" означает, что кредиты использования отключены для этого участника.

period_to_date_spend — это кредиты использования, накопленные участником с начала текущего period, в том же формате младших единиц. Может включать дробную часть (например, "41280.125").

Жизненный цикл запроса на увеличение лимита расходов

Запрос на увеличение лимита расходов создаётся, когда участник нажимает «запросить больше использования» в claude.ai. Запросы не создаются через этот API.

Статус	Значение
`pending`	Ожидание действия администратора. Запрос обычно содержит живую `spend_summary`, чтобы вы могли видеть текущий эффективный лимит участника и расходы с начала периода при принятии решения. `spend_summary` может быть `null`, если её не удалось вычислить, поэтому обработайте этот случай.
`approved`	Запрос был разрешён с одобрением: либо администратор явно одобрил его (установив лимит расходов для конкретного пользователя на указанную администратором сумму), либо другое действие администратора сделало кредиты использования доступными для участника (например, повышение лимита уровня места или включение выставления счётов за кредиты использования для организации), либо служба поддержки Anthropic повысила лимит от имени организации. `spend_summary` имеет значение `null`.
`denied`	Администратор отклонил. `spend_summary` имеет значение `null`. Claude.ai скрывает кнопку запроса этого участника на 30 дней с момента `resolved_at`; администратор может в любой момент напрямую повысить лимит участника.

Оба статуса approved и denied являются терминальными. Участник может иметь максимум один pending запрос одновременно.

Одобрение через POST …/approve записывает ту же строку лимита расходов для конкретного пользователя, которую записывает POST /v1/organizations/spend_limits. Установка лимита расходов напрямую не переводит ожидающий запрос. Используйте конечную точку одобрения для разрешения запроса.

По умолчанию Anthropic отправляет участнику письмо, когда его запрос одобрен или отклонен. Передайте suppress_notification: true при одобрении или отклонении, чтобы подавить это письмо (например, когда ваша собственная система уведомляет участника).

Объект SpendLimit

Настроенный лимит на одном уровне области.

{
  "type": "spend_limit",
  "id": "spl_01AbCdEfGhIjKlMnOpQrSt",
  "created_at": "2026-05-01T12:00:00Z",
  "updated_at": "2026-05-03T09:14:11Z",
  "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
  "amount": "50000",
  "currency": "USD",
  "period": "monthly"
}

Поле	Тип	Описание
`type`	строка	Всегда `"spend_limit"`.
`id`	строка	С префиксом `spl_`.
`created_at`	строка (RFC 3339)	Когда этот лимит был впервые установлен.
`updated_at`	строка (RFC 3339)	Когда этот лимит был последний раз изменен.
`scope`	Область	Уровень, на котором написан этот лимит. См. раздел "Область".
`amount`	строка или null	Лимит для `period`, в минимальных единицах. `null` означает неограниченный.
`currency`	строка	ISO 4217. Валюта выставления счетов организации.
`period`	строка	Повторяющееся окно, в течение которого применяется `amount`. См. раздел "Период".

Объект SpendSummary

Вычисленная строка отчета для каждого члена: эффективный лимит члена, его источник и расходы с начала периода. Не адресуемый ресурс (нет id).

{
  "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
  "amount": "50000",
  "currency": "USD",
  "period": "monthly",
  "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
  "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
  "period_to_date_spend": "31402.5"
}

Поле	Тип	Описание
`scope`	Область (`type: "user"`)	Член, для которого предназначена эта строка.
`amount`	строка или null	Эффективный лимит для `period`, в минимальных единицах. `null` означает неограниченный; `"0"` означает, что кредиты использования отключены.
`currency`	строка	ISO 4217.
`period`	строка	Период лимита расходов, на который разрешился `source`. См. раздел "Период".
`source`	Область	Откуда был разрешен `amount` в иерархии. Равен `scope`, когда у члена есть переопределение для отдельного пользователя.
`spend_limit_id`	строка	ID объекта `SpendLimit`, на который разрешилась `source`. Получите его с помощью `GET /v1/organizations/spend_limits/{spend_limit_id}`.
`period_to_date_spend`	строка	Кредиты использования участника, накопленные с начала текущего `period`, в минорных единицах.

Объект SpendLimitIncreaseRequest

{
  "type": "spend_limit_increase_request",
  "id": "slir_01AbCdEfGhIjKlMnOpQrSt",
  "created_at": "2026-05-04T16:22:09Z",
  "status": "pending",
  "resolved_at": null,
  "resolved_by": null,
  "actor": {
    "type": "user_actor",
    "user_id": "user_01AbCdEfGh",
    "name": "Jane Smith",
    "email_address": "[email protected]"
  },
  "spend_summary": {
    "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
    "amount": "50000",
    "currency": "USD",
    "period": "monthly",
    "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
    "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
    "period_to_date_spend": "48900"
  }
}

Поле	Тип	Описание
`type`	строка	Всегда `"spend_limit_increase_request"`.
`id`	строка	С префиксом `slir_`.
`created_at`	строка (RFC 3339)	Когда участник отправил запрос.
`status`	строка	`pending`, `approved` или `denied`.
`resolved_at`	строка (RFC 3339) или null	Когда запрос был одобрен или отклонен. `null` в ожидании.
`resolved_by`	Actor или null	Кто одобрил или отклонил запрос: либо `user_actor` (администратор действовал в claude.ai), либо `scoped_api_key_actor` (разрешено через этот API). Когда запрос автоматически разрешается действием администратора в claude.ai (например, повышение лимита уровня места, включение выставления счетов за кредиты использования для организации или повышение лимита участника), `resolved_by` — это `user_actor` действующего администратора. `null` в ожидании, когда учетная запись разрешающего администратора была удалена, или когда запрос был разрешен поддержкой Anthropic. `scoped_api_key_actor` может ссылаться на ключ, который был удален или отозван. Рассматривайте `scoped_api_key_id` как исторический справочник и допускайте сбои поиска.
`actor`	Actor (`user_actor`)	Участник, который отправил запрос.
`spend_summary`	SpendSummary или null	Контекст решения в реальном времени для запрашивающего: его эффективный лимит и расходы с начала периода. Присутствует, пока `status` ожидается (может быть `null`, если сводку не удалось вычислить); всегда `null` после разрешения.

Actor

Поле	Тип	Описание
`type`	строка	`user_actor` или `scoped_api_key_actor`.
`user_id`	строка	Присутствует на `user_actor`. ID пользователя; то же значение, принимаемое `actor_ids[]`.
`name`	строка или null	Присутствует на `user_actor`. Имя пользователя; `null`, если учетная запись была удалена или пользователь не установил имя.
`email_address`	строка или null	Присутствует на `user_actor`. Электронная почта пользователя; `null`, если учетная запись была удалена.
`scoped_api_key_id`	строка	Присутствует в `scoped_api_key_actor`. С префиксом `apikey_`.

Лимиты расходов

1. Список действующих лимитов расходов

GET /v1/organizations/spend_limits/effective

Возвращает всех текущих членов организации с их разрешённым действующим лимитом и расходами за период. Члены без переопределения для отдельного пользователя отображаются с source.type значением seat_tier, rbac_group или organization. Бывшие члены не указаны.

Требуется область: read:spend_limits.

Параметры запроса

Поле	Тип	Обязательно	По умолчанию	Описание
`user_ids[]`	строка, максимум 100 записей	Нет	все члены	Ограничить определёнными членами. Принимает `user_...` ID. Запись, которая не является текущим членом, молча опускается из `data`.
`limit`	целое число 1–1000	Нет	20	Строк на странице.
`page`	непрозрачная строка курсора	Нет	—	Значение `next_page` из предыдущего ответа.

Поля ответа

Поле	Тип	Описание
`data`	массив SpendSummary	По одной записи на члена, упорядочено по времени присоединения к организации (новые первыми).
`next_page`	строка или null	Непрозрачный курсор для следующей страницы; `null` когда больше нет страниц.

Пример запроса

curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?limit=20" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Пример ответа

{
  "data": [
    {
      "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
      "amount": "50000",
      "currency": "USD",
      "period": "monthly",
      "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
      "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
      "period_to_date_spend": "31402.5"
    }
  ],
  "next_page": "page_..."
}

Проверки

Условие	Статус	Сообщение
Запись `user_ids[]` неправильного формата	400	`user_ids[]: entry is not a valid user ID`
`user_ids[]` содержит более 100 записей	400
`limit` вне диапазона 1–1000	400
Курсор `page` недействителен	400	`page: недействительный курсор`
`page` курсор не соответствует текущему `user_ids[]`	400	`page: курсор не соответствует текущим параметрам запроса`
`page` курсор из другой версии API	400	`page: курсор был выдан другой версией API`
Организация не входит в план Enterprise	400	`эта конечная точка не поддерживается для этого типа организации`
Биллинг по кредитам использования не включен	400	`биллинг за превышение не включен для этой организации`

2. Получить лимит расходов

GET /v1/organizations/spend_limits/{spend_limit_id}

Возвращает один лимит расходов по ID. Используйте это для проверки строки, на которую ссылается SpendSummary.spend_limit_id или ответ POST.

Требуется область: read:spend_limits.

Параметры пути

Поле	Тип	Описание
`spend_limit_id`	строка	С префиксом `spl_`.

Ответ

Объект SpendLimit.

Пример запроса

curl "https://api.anthropic.com/v1/organizations/spend_limits/spl_01AbCdEfGhIjKlMnOpQrSt" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Проверки

Условие	Статус	Сообщение
`spend_limit_id` не найден в этой организации	404
Организация не входит в план Enterprise	400	`эта конечная точка не поддерживается для этого типа организации`
Биллинг по кредитам использования не включен	400	`биллинг за превышение не включен для этой организации`

3. Установить лимит расходов

POST /v1/organizations/spend_limits

Устанавливает переопределение лимита расходов для каждого пользователя. Upsert: установка лимита для пользователя, у которого он уже есть, перезаписывает его на месте.

Принимается только scope.type: "user". Значения по умолчанию на уровне места, группы и организации настраиваются в параметрах claude.ai.

Установка лимита расходов напрямую не переводит запрос на увеличение, ожидающий рассмотрения участника. Используйте конечную точку утверждения для разрешения запроса.

Требуется область: write:spend_limits.

Тело запроса

Поле	Тип	Обязательно	Описание
`scope`	объект	Да	`{ "type": "user", "user_id": "user_..." }`.
`amount`	строка или null	Да	Новый лимит для `period`, в минорных единицах, как неотрицательная целая строка в десятичном формате. `"0"` отключает кредит использования для участника. `null` удаляет лимит (неограниченно).
`period`	строка	Нет	По умолчанию `"monthly"`. См. раздел "Period".

Ответ

Объект SpendLimit, отражающий записанное переопределение.

Пример запроса

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limits" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "content-type: application/json" \
  -d '{"scope": {"type": "user", "user_id": "user_01AbCdEfGh"}, "amount": "75000"}'

Пример ответа

{
  "type": "spend_limit",
  "id": "spl_01RsTuVwXyZaBcDeFgHiJk",
  "created_at": "2026-05-11T10:02:44Z",
  "updated_at": "2026-05-11T10:02:44Z",
  "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
  "amount": "75000",
  "currency": "USD",
  "period": "monthly"
}

Проверки

Условие	Статус	Сообщение
`scope.type` не равен `"user"`	400	`scope.type: not yet supported`
`scope.user_id` имеет неправильный формат	400	`scope.user_id: malformed`
`scope.user_id` не является участником этой организации	400	`scope.user_id: not a member of this organization`
`amount` отрицательный, дробный или не является допустимой строкой в десятичном формате	400
`period` не равен `"monthly"`	400	`period: not yet supported`
Организация не входит в план Enterprise	400	`this endpoint is not supported for this organization type`
Биллинг кредитов использования не включен	400	`overage billing is not enabled for this organization`

4. Удалить лимит расходов

DELETE /v1/organizations/spend_limits/{spend_limit_id}

Удаляет переопределение для каждого пользователя, чтобы участник вернулся к унаследованному лимиту (уровень места, группа или организационное значение по умолчанию). Строки уровня места, группы и организации не могут быть удалены через эту конечную точку.

Требуется область: write:spend_limits.

Параметры пути

Поле	Тип	Описание
`spend_limit_id`	строка	С префиксом `spl_`. Должен быть ID переопределения для каждого пользователя.

Ответ

{ "type": "spend_limit_deleted", "id": "spl_01RsTuVwXyZaBcDeFgHiJk" }

Пример запроса

curl -X DELETE "https://api.anthropic.com/v1/organizations/spend_limits/spl_01RsTuVwXyZaBcDeFgHiJk" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Проверки

Условие	Статус	Сообщение
`spend_limit_id` не найден в этой организации	404
`spend_limit_id` является строкой уровня места, группы или организации	400	`Через этот endpoint можно удалять только лимиты расходов для отдельных пользователей.`
Организация не имеет плана Enterprise	400	`этот endpoint не поддерживается для этого типа организации`
Биллинг по кредитам использования не включен	400	`биллинг за превышение не включен для этой организации`

Запросы на увеличение лимита расходов

5. Список запросов на увеличение

GET /v1/organizations/spend_limit_increase_requests

Выводит список запросов на увеличение, начиная с самых свежих. Запросы, чьи авторы больше не являются членами организации, исключены.

Требуется область: read:spend_limits.

Параметры запроса

Поле	Тип	Обязательно	По умолчанию	Описание
`status[]`	один или несколько из `pending`, `approved`, `denied`	Нет	все	Фильтр по статусу. Повторите параметр для нескольких значений.
`actor_ids[]`	строка	Нет	все	Фильтр по автору запроса. Принимает ID `user_...`.
`limit`	целое число 1–1000	Нет	20	Строк на странице.
`page`	непрозрачная строка курсора	Нет	—	Значение `next_page` из предыдущего ответа.

Поля ответа

Поле	Тип	Описание
`данные`	массив SpendLimitIncreaseRequest	Отсортировано по `created_at` в порядке убывания.
`next_page`	строка или null	Непрозрачный курсор для следующей страницы; `null` когда больше нет страниц.

Пример запроса

curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests?status[]=pending&limit=50" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Пример ответа

{
  "data": [
    {
      "type": "spend_limit_increase_request",
      "id": "slir_01AbCdEfGhIjKlMnOpQrSt",
      "created_at": "2026-05-04T16:22:09Z",
      "status": "pending",
      "resolved_at": null,
      "resolved_by": null,
      "actor": {
        "type": "user_actor",
        "user_id": "user_01AbCdEfGh",
        "name": "Jane Smith",
        "email_address": "[email protected]"
      },
      "spend_summary": {
        "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
        "amount": "50000",
        "currency": "USD",
        "period": "monthly",
        "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
        "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
        "period_to_date_spend": "48900"
      }
    }
  ],
  "next_page": null
}

Проверки

Условие	Статус	Сообщение
`actor_ids[]` запись неправильного формата	400	`actor_ids[]: неверный ID помеченного пользователя`
`limit` вне диапазона 1–1000	400
`page` курсор неправильного формата	400	`неверный формат курсора страницы` или `неверный курсор страницы`
`page` курсор не соответствует текущему `status[]` или `actor_ids[]`	400	`курсор страницы не соответствует текущим параметрам запроса`
`page` курсор из другой версии API	400	`курсор страницы был выдан другой версией API; перезагрузите нумерацию страниц`
Организация не входит в план Enterprise	400	`эта конечная точка не поддерживается для этого типа организации`
Биллинг кредитов использования не включен	400	`биллинг переплаты не включен для этой организации`

6. Получить запрос на увеличение

GET /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

Возвращает один запрос на увеличение.

Требуется область: read:spend_limits.

Параметры пути

Поле	Тип	Описание
`spend_limit_increase_request_id`	строка	С префиксом `slir_`.

Ответ

Объект SpendLimitIncreaseRequest.

Пример запроса

curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Проверки

Условие	Статус	Сообщение
Запрос не найден в этой организации	404
Запрашивающий больше не является членом этой организации	404
Организация не имеет плана Enterprise	400	`этот endpoint не поддерживается для этого типа организации`
Выставление счетов за кредиты использования не включено	400	`выставление счетов за превышение не включено для этой организации`

7. Одобрить запрос на увеличение

POST /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve

Одобряет ожидающий запрос. Записывает лимит расходов на пользователя в amount для запрашивающего и переводит запрос в статус approved. Если запрос не содержит запрошенную сумму, администратор устанавливает новый лимит при одобрении.

Требуется область: write:spend_limits.

Параметры пути

Поле	Тип	Описание
`spend_limit_increase_request_id`	строка	С префиксом `slir_`.

Тело запроса

Поле	Тип	Обязательно	По умолчанию	Описание
`amount`	строка	Да	—	Новый лимит на пользователя для `period`, в младших единицах, как неотрицательная целая строка в десятичном формате.
`period`	строка	Нет	`"monthly"`	См. раздел "Period".
`suppress_notification`	логический	Нет	`false`	Если `true`, Anthropic не отправляет письмо участнику о том, что его запрос был одобрен.

Ответ

SpendLimitIncreaseRequest со статусом approved с дополнительным полем spend_limit, содержащим SpendLimit, который был записан.

Пример запроса

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/approve" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "content-type: application/json" \
  -d '{"amount": "75000", "suppress_notification": true}'

Пример ответа

{
  "type": "spend_limit_increase_request",
  "id": "slir_01AbCdEfGhIjKlMnOpQrSt",
  "created_at": "2026-05-04T16:22:09Z",
  "status": "approved",
  "resolved_at": "2026-05-11T10:05:02Z",
  "resolved_by": {
    "type": "scoped_api_key_actor",
    "scoped_api_key_id": "apikey_01ZyXwVuTsRqPoNmLkJiHg"
  },
  "actor": {
    "type": "user_actor",
    "user_id": "user_01AbCdEfGh",
    "name": "Jane Smith",
    "email_address": "[email protected]"
  },
  "spend_summary": null,
  "spend_limit": {
    "type": "spend_limit",
    "id": "spl_01RsTuVwXyZaBcDeFgHiJk",
    "created_at": "2026-05-11T10:05:02Z",
    "updated_at": "2026-05-11T10:05:02Z",
    "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
    "amount": "75000",
    "currency": "USD",
    "period": "monthly"
  }
}

Проверки

Условие	Статус	Сообщение
Запрос не найден в этой организации	404
Запрашивающий больше не является членом этой организации	404
Запрос уже `одобрен` или `отклонен`	400	`запрос на увеличение лимита расходов уже разрешен`
`сумма` отрицательная, дробная или не является допустимой строкой десятичного числа	400
`период` не является `"ежемесячным"`	400	`период: еще не поддерживается`
Организация не входит в план Enterprise	400	`эта конечная точка не поддерживается для этого типа организации`
Выставление счетов за кредиты использования не включено	400	`выставление счетов за превышение не включено для этой организации`

8. Отклонить запрос на увеличение

POST /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny

Отклоняет ожидающий запрос. Идемпотентно при отклонено: отклонение уже отклоненного запроса возвращает 200 с существующим ресурсом. Отклонение уже одобренного запроса отклоняется, чтобы автоматизация могла различить повторную попытку и конфликтующее решение.

Требует область: write:spend_limits.

Параметры пути

Поле	Тип	Описание
`spend_limit_increase_request_id`	строка	С префиксом `slir_`.

Тело запроса

Поле	Тип	Обязательно	По умолчанию	Описание
`suppress_notification`	логический	Нет	`ложь`	Если `истина`, Anthropic не отправляет по электронной почте участнику уведомление об отклонении его запроса.

Ответ

SpendLimitIncreaseRequest со статусом отклонено.

Пример запроса

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/deny" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "content-type: application/json" \
  -d '{"suppress_notification": true}'

Проверки

Условие	Статус	Сообщение
Запрос не найден в этой организации	404
Запрашивающий больше не является членом этой организации	404
Запрос уже `одобрен`	400	`запрос на увеличение лимита расходов уже одобрен`
Запрос уже `отклонен`	— (200, idempotent)
Организация не входит в план Enterprise	400	`этот endpoint не поддерживается для этого типа организации`
Кредиты использования не включены	400	`выставление счетов за превышение не включено для этой организации`

Другие статьи по теме

Наш подход к ограничениям частоты запросов для Claude API

Управление дополнительным использованием для планов Team и Enterprise на основе мест

Справочное руководство API Claude Enterprise Analytics

Управление группами и лимитами расходов групп в планах Enterprise

Руководство по управлению потреблением Claude Enterprise