Claude Platform Docs

Spend Limits

Set Spend Limit
beta.organization.spend_limits.set(**kwargs) -> BetaSpendLimit
POST/v1/organizations/spend_limits

Set a spend limit.

Get Spend Limit
beta.organization.spend_limits.retrieve(spend_limit_id) -> BetaSpendLimit
GET/v1/organizations/spend_limits/{spend_limit_id}

Retrieve a spend limit by ID.

Delete Spend Limit
beta.organization.spend_limits.delete(spend_limit_id) -> SpendLimitDeleteResponse
DELETE/v1/organizations/spend_limits/{spend_limit_id}

Delete a spend limit.

List Spend Limits
beta.organization.spend_limits.list(**kwargs) -> SyncPageCursor[BetaSpendLimit]
GET/v1/organizations/spend_limits

List the organization's spend limits.

Models
class BetaSpendLimit: type: "spend_limit"; id; amount; ... # 6 more

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

class BetaSpendLimitOrganizationScope: type: "organization"
type: Literal["organization"]
defaultorganization
class BetaSpendLimitOrganizationServiceScope: type: "organization_service"; service
type: Literal["organization_service"]
defaultorganization_service
service: str
type BetaSpendLimitPeriod = Literal["daily", "monthly", "weekly"]
One of the following:
"daily"
"monthly"
"weekly"
class BetaSpendLimitRBACGroupScope: type: "rbac_group"; rbac_group_id
type: Literal["rbac_group"]
defaultrbac_group
rbac_group_id: str
class BetaSpendLimitScopedAPIKeyActor: type: "scoped_api_key_actor"; scoped_api_key_id

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

type: Literal["scoped_api_key_actor"]
defaultscoped_api_key_actor
scoped_api_key_id: str
class BetaSpendLimitSeatTierScope: type: "seat_tier"; seat_tier
type: Literal["seat_tier"]
defaultseat_tier
seat_tier: str
class BetaSpendLimitUserActor: 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: Literal["user_actor"]

Actor type. Always user_actor.

defaultuser_actor
deleted: bool

True only when the underlying account has been deleted.

defaultfalse
email_address: Optional[str]

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

name: Optional[str]

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

user_id: str

Tagged ID of the user.

class BetaSpendLimitUserScope: type: "user"; user_id

Scope selecting a single member of the organization.

type: Literal["user"]

Scope type. Always user for this scope.

defaultuser
user_id: str

Tagged ID of the member the spend limit applies to.

class BetaSpendLimitWorkspaceScope: type: "workspace"; workspace_id

Scope selecting one workspace of a Claude Console organization.

type: Literal["workspace"]

Scope type. Always workspace for this scope.

defaultworkspace
workspace_id: str

Tagged ID of the workspace the spend limit applies to.

class BetaSpendSummary: actor; amount; currency; ... # 5 more

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

class SpendLimitDeleteResponse: type: "spend_limit_deleted"; id
type: Literal["spend_limit_deleted"]
defaultspend_limit_deleted
id: str

Spend LimitsEffective

List Effective Spend Limits
beta.organization.spend_limits.effective.list(**kwargs) -> SyncPageCursor[BetaSpendSummary]
GET/v1/organizations/spend_limits/effective

List each member's effective spend limit and period-to-date spend.

Spend LimitsIncrease Requests

List Spend Limit Increase Requests
beta.organization.spend_limits.increase_requests.list(**kwargs) -> SyncPageCursor[BetaSpendLimitIncreaseRequest]
GET/v1/organizations/spend_limit_increase_requests

List spend limit increase requests, most recent first.

Get Spend Limit Increase Request
beta.organization.spend_limits.increase_requests.retrieve(spend_limit_increase_request_id) -> BetaSpendLimitIncreaseRequest
GET/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

Retrieve a spend limit increase request.

Approve Spend Limit Increase Request
beta.organization.spend_limits.increase_requests.approve(spend_limit_increase_request_id, **kwargs) -> IncreaseRequestApproveResponse
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve

Approve a pending spend limit increase request.

Deny Spend Limit Increase Request
beta.organization.spend_limits.increase_requests.deny(spend_limit_increase_request_id, **kwargs) -> BetaSpendLimitIncreaseRequest
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny

Deny a pending spend limit increase request.