Claude Platform Docs

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

Установка лимита расходов
POST/v1/organizations/spend_limits

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

Получить лимит расходов
GET/v1/organizations/spend_limits/{spend_limit_id}

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

Удалить лимит расходов
DELETE/v1/organizations/spend_limits/{spend_limit_id}

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

Список лимитов расходов
GET/v1/organizations/spend_limits

Возвращает список "spend limits" (лимитов расходов) организации.

Models
BetaSpendLimit object{ type: "spend_limit", id, amount, 6 more }

A configured spend limit: a cap on metered spend for one scope and period.

BetaSpendLimitOrganizationScope object{ type: "organization" }
type: "organization"
defaultorganization
BetaSpendLimitOrganizationServiceScope object{ type: "organization_service", service }
type: "organization_service"
defaultorganization_service
service: string
BetaSpendLimitPeriod = "daily" or "monthly" or "weekly"
One of the following:
"daily"
"monthly"
"weekly"
BetaSpendLimitRBACGroupScope object{ type: "rbac_group", rbac_group_id }
type: "rbac_group"
defaultrbac_group
rbac_group_id: string
BetaSpendLimitScopedAPIKeyActor object{ type: "scoped_api_key_actor", scoped_api_key_id }

A scoped Admin API key acting on behalf of the organization.

type: "scoped_api_key_actor"
defaultscoped_api_key_actor
scoped_api_key_id: string
BetaSpendLimitSeatTierScope object{ type: "seat_tier", seat_tier }
type: "seat_tier"
defaultseat_tier
seat_tier: string
BetaSpendLimitUsageTierScope object{ type: "usage_tier" }

Scope of the monthly spend cap Anthropic sets for a Claude Console organization from its usage tier, or a higher cap Anthropic granted the organization. Read-only; its created_at and updated_at are the organization's creation time, so amount can change while updated_at stays the same.

type: "usage_tier"

Scope type. Always usage_tier for this scope.

defaultusage_tier
BetaSpendLimitUserActor object{ type: "user_actor", deleted, email_address, 2 more }

A user within the organization. name and email_address are null when the underlying account is unavailable or has been deleted; deleted is true only for deleted accounts.

type: "user_actor"

Actor type. Always user_actor.

defaultuser_actor
deleted: boolean

True only when the underlying account has been deleted.

defaultfalse
email_address: string or null

The user's email address. Null when the account is unavailable or has been deleted.

name: string or null

The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.

user_id: string

Tagged ID of the user.

BetaSpendLimitUserScope object{ type: "user", user_id }

Scope selecting a single member of the organization.

type: "user"

Scope type. Always user for this scope.

defaultuser
user_id: string

Tagged ID of the member the spend limit applies to.

BetaSpendLimitWorkspaceScope object{ type: "workspace", workspace_id }

Scope selecting one workspace of a Claude Console organization.

type: "workspace"

Scope type. Always workspace for this scope.

defaultworkspace
workspace_id: string

Tagged ID of the workspace the spend limit applies to.

BetaSpendSummary object{ actor, amount, currency, 5 more }

Per-member effective-limit report row (GET /spend_limits/effective).

SpendLimitDeleteResponse object{ type: "spend_limit_deleted", id }
type: "spend_limit_deleted"
defaultspend_limit_deleted
id: string

Лимиты расходовДействующие

Список действующих лимитов расходов
GET/v1/organizations/spend_limits/effective

Возвращает действующий лимит расходов и расходы с начала периода для каждого участника.

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

Список запросов на увеличение лимита расходов
GET/v1/organizations/spend_limit_increase_requests

Список запросов на увеличение лимита расходов, сначала самые последние.

Получить запрос на увеличение лимита расходов
GET/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}
Одобрить запрос на увеличение лимита расходов
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve

Одобрить ожидающий запрос на увеличение лимита расходов.

Отклонить запрос на увеличение лимита расходов
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny

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