지출 한도 설정

POST/v1/organizations/spend_limits

사용자별 지출 한도 재정의를 설정합니다.

(scope, period)를 키로 하는 업서트입니다. 이미 존재하는 한도를 설정하면 해당 한도를 그 자리에서 덮어씁니다. scope.type: "user"만 허용되며, 시트 티어, 그룹 및 조직 수준 기본값은 claude.ai에서 구성합니다.

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: object{ type, 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.

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

One of the following:

"daily"

"monthly"

"weekly"

Returns

SpendLimit object{ id, amount, created_at, 5 more }

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

지출 한도 설정

cURL

curl https://api.anthropic.com/v1/organizations/spend_limits \
    -H 'Content-Type: application/json' \
    -H 'anthropic-version: 2023-06-01' \
    -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
    -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"
}