Claude Platform Docs

支出上限を設定

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"
        }'
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"
}