지출 한도 설정

POST/v1/organizations/spend_limits

지출 한도를 설정합니다.

(scope, period)를 키로 하는 upsert(업서트)입니다. 이미 존재하는 한도를 설정하면 해당 한도를 그 자리에서 덮어씁니다. Claude Enterprise 조직은 user 한도를 설정합니다. 시트 등급, 그룹 및 조직 수준 기본값은 claude.ai에서 구성됩니다. Claude Console 조직은 organization 및 workspace 한도를 설정하며, 이 한도는 월 단위이고 항상 금액을 포함합니다. 이러한 한도 설정은 얼리 액세스 프리뷰 단계입니다. 액세스를 요청하려면 Anthropic 계정 팀에 문의하세요.

Body

amount: string or null

Limit amount as a non-negative integer decimal string in the minor unit of the organization's billing currency (cents for USD): "50000" is $500.00. null sets an explicit no-limit override for this scope and period only — each period resolves independently, so caps for other periods still apply.

scope: User or Organization or Workspace

What the limit applies to. Claude Enterprise organizations set user limits. Claude Console organizations set organization and workspace limits. Any other combination returns 400. Setting organization and workspace limits through the API is in an early access preview. To request access, contact your Anthropic account team.

One of the following:

User 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.

Organization object{ type: "organization" }

type: "organization"

defaultorganization

Workspace 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.

period: optional "daily" or "monthly" or "weekly"

One of the following:

"daily"

"monthly"

"weekly"

Returns

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

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

지출 한도 설정

curl https://api.anthropic.com/v1/organizations/spend_limits \
    -H 'Content-Type: application/json' \
    -H 'anthropic-version: 2023-06-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY" \
    -d '{
          "amount": "50000",
          "scope": {
            "type": "user",
            "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
          },
          "period": "monthly"
        }'

Response 200

{
  "id": "id",
  "amount": "50000",
  "created_at": "2019-12-27T18:11:19.117Z",
  "currency": "USD",
  "period": "monthly",
  "scope": {
    "type": "user",
    "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
  },
  "type": "spend_limit",
  "updated_at": "2019-12-27T18:11:19.117Z"
}

Returns Examples

Response 200

{
  "id": "id",
  "amount": "50000",
  "created_at": "2019-12-27T18:11:19.117Z",
  "currency": "USD",
  "period": "monthly",
  "scope": {
    "type": "user",
    "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
  },
  "type": "spend_limit",
  "updated_at": "2019-12-27T18:11:19.117Z"
}