Claude Platform Docs

Limites de gastos

Definir limite de gastos
client.Beta.Organization.SpendLimits.Set(ctx, params) (*BetaSpendLimit, error)
POST/v1/organizations/spend_limits

Define um limite de gastos.

Obter limite de gastos
client.Beta.Organization.SpendLimits.Get(ctx, spendLimitID) (*BetaSpendLimit, error)
GET/v1/organizations/spend_limits/{spend_limit_id}

Recupere um limite de gastos por ID.

Excluir limite de gastos
client.Beta.Organization.SpendLimits.Delete(ctx, spendLimitID) (*BetaOrganizationSpendLimitDeleteResponse, error)
DELETE/v1/organizations/spend_limits/{spend_limit_id}

Exclui um limite de gastos.

Listar limites de gastos
client.Beta.Organization.SpendLimits.List(ctx, params) (*PageCursor[BetaSpendLimit], error)
GET/v1/organizations/spend_limits

Lista os limites de gastos da organização.

Models
type BetaSpendLimit struct { Type: "spend_limit"; ID; Amount; /* 6 more */ }

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

type BetaSpendLimitOrganizationScope struct { Type: "organization" }
Type Organization
defaultorganization
type BetaSpendLimitOrganizationServiceScope struct { Type: "organization_service"; Service }
Type OrganizationService
defaultorganization_service
Service string
type BetaSpendLimitPeriod string
One of the following:
const BetaSpendLimitPeriodDaily BetaSpendLimitPeriod = "daily"
const BetaSpendLimitPeriodMonthly BetaSpendLimitPeriod = "monthly"
const BetaSpendLimitPeriodWeekly BetaSpendLimitPeriod = "weekly"
type BetaSpendLimitRBACGroupScope struct { Type: "rbac_group"; RBACGroupID }
Type RBACGroup
defaultrbac_group
RBACGroupID string
type BetaSpendLimitScopedAPIKeyActor struct { Type: "scoped_api_key_actor"; ScopedAPIKeyID }

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

Type ScopedAPIKeyActor
defaultscoped_api_key_actor
ScopedAPIKeyID string
type BetaSpendLimitSeatTierScope struct { Type: "seat_tier"; SeatTier }
Type SeatTier
defaultseat_tier
SeatTier string
type BetaSpendLimitUsageTierScope struct { 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 UsageTier

Scope type. Always usage_tier for this scope.

defaultusage_tier
type BetaSpendLimitUserActor struct { Type: "user_actor"; Deleted; EmailAddress; /* 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 UserActor

Actor type. Always user_actor.

defaultuser_actor
Deleted bool

True only when the underlying account has been deleted.

defaultfalse
EmailAddress string

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

Name string

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

UserID string

Tagged ID of the user.

type BetaSpendLimitUserScope struct { Type: "user"; UserID }

Scope selecting a single member of the organization.

Type User

Scope type. Always user for this scope.

defaultuser
UserID string

Tagged ID of the member the spend limit applies to.

type BetaSpendLimitWorkspaceScope struct { Type: "workspace"; WorkspaceID }

Scope selecting one workspace of a Claude Console organization.

Type Workspace

Scope type. Always workspace for this scope.

defaultworkspace
WorkspaceID string

Tagged ID of the workspace the spend limit applies to.

type BetaSpendSummary struct { Actor; Amount; Currency; /* 5 more */ }

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

Limites de gastosEfetivos

Listar limites de gastos efetivos
client.Beta.Organization.SpendLimits.Effective.List(ctx, query) (*PageCursor[BetaSpendSummary], error)
GET/v1/organizations/spend_limits/effective

Lista o limite de gastos efetivo de cada membro e os gastos acumulados no período.

Limites de gastosSolicitações de aumento

Listar solicitações de aumento de limite de gastos
client.Beta.Organization.SpendLimits.IncreaseRequests.List(ctx, query) (*PageCursor[BetaSpendLimitIncreaseRequest], error)
GET/v1/organizations/spend_limit_increase_requests

Liste as solicitações de aumento de limite de gastos, mais recentes primeiro.

Obter solicitação de aumento de limite de gastos
client.Beta.Organization.SpendLimits.IncreaseRequests.Get(ctx, spendLimitIncreaseRequestID) (*BetaSpendLimitIncreaseRequest, error)
GET/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

Recupere uma solicitação de aumento de limite de gastos.

Aprovar solicitação de aumento de limite de gastos
client.Beta.Organization.SpendLimits.IncreaseRequests.Approve(ctx, spendLimitIncreaseRequestID, body) (*BetaOrganizationSpendLimitIncreaseRequestApproveResponse, error)
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve

Aprove uma solicitação pendente de aumento de limite de gastos.

Negar solicitação de aumento de limite de gastos
client.Beta.Organization.SpendLimits.IncreaseRequests.Deny(ctx, spendLimitIncreaseRequestID, body) (*BetaSpendLimitIncreaseRequest, error)
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny

Negue uma solicitação pendente de aumento de limite de gastos.