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

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

Для отчетов об использовании и затратах по пользователям и временным периодам см. справочное руководство 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 публично и не проверяйте их в системе управления версиями.

Создайте ключ Admin API для вашей организации Claude Enterprise

Войдите как основной владелец — только основной владелец вашей родительской организации Claude Enterprise может создавать эти ключи.
Откройте параметры API — перейдите в Параметры организации > API и найдите раздел Ключи.
Нажмите и создайте ключ — назовите ключ и выберите нужные области из таблицы областей. Вы можете комбинировать области из разных API (например, read:analytics и read:spend_limits) на одном ключе.
Скопируйте и сохраните секрет — скопируйте отображаемый секрет (начинающийся с sk-ant-api01-) и сохраните его в менеджер секретов. Полный секрет отображается только один раз.

Базовый 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. Установка лимита расходов напрямую не переводит ожидающий запрос. Используйте endpoint одобрения для разрешения запроса.

По умолчанию 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`. См. раздел "Период".
`источник`	Область	Где `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: invalid cursor`
`page` курсор не соответствует текущему `user_ids[]`	400	`page: cursor does not match current query parameters`
`page` курсор из другой версии API	400	`page: cursor was issued by a different API version`
Организация не входит в план Enterprise	400	`this endpoint is not supported for this organization type`
Биллинг по кредитам использования не включен	400	`overage billing is not enabled for this organization`

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	`this endpoint is not supported for this organization type`
Биллинг по кредитам использования не включен	400	`overage billing is not enabled for this organization`

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"`. См. раздел "Период".

Ответ

Объект 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` из предыдущего ответа.

Поля ответа

Поле	Тип	Описание
`data`	массив 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	`эта конечная точка не поддерживается для этого типа организации`
Биллинг по кредитам использования не включен	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"`	См. раздел "Период".
`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	`этот endpoint не поддерживается для этого типа организации`
Выставление счетов за кредиты использования не включено	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, идемпотентный)
Организация не находится на плане Enterprise	400	`этот endpoint не поддерживается для этого типа организации`
Кредиты использования не включены	400	`выставление счетов за превышение не включено для этой организации`

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