Claude Platform Docs

Limites de dépenses

Définir une limite de dépenses
POST/v1/organizations/spend_limits

Définit une limite de dépenses.

Obtenir une limite de dépenses
GET/v1/organizations/spend_limits/{spend_limit_id}

Récupérer une limite de dépenses par son ID.

Supprimer une limite de dépenses
DELETE/v1/organizations/spend_limits/{spend_limit_id}

Supprime une limite de dépenses.

Lister les limites de dépenses
GET/v1/organizations/spend_limits

Répertorie les limites de dépenses de l'organisation.

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

Limites de dépensesEffectives

Lister les limites de dépenses effectives
GET/v1/organizations/spend_limits/effective

Répertorie la limite de dépenses effective de chaque membre et ses dépenses depuis le début de la période.

Limites de dépensesDemandes d'augmentation

Lister les demandes d'augmentation de limite de dépenses
GET/v1/organizations/spend_limit_increase_requests

Lister les demandes d'augmentation de limite de dépenses, les plus récentes en premier.

Obtenir une demande d'augmentation de limite de dépenses
GET/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

Récupérer une demande d'augmentation de limite de dépenses.

Approuver une demande d'augmentation de limite de dépenses
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve

Approuver une demande d'augmentation de limite de dépenses en attente.

Refuser une demande d'augmentation de limite de dépenses
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny

Refuser une demande d'augmentation de limite de dépenses en attente.