メインコンテンツにスキップ

Claude Enterprise Admin API リファレンスガイド

このガイドでは、Claude Enterprise Admin APIを使用してClaudeエンタープライズ組織の支出制限支出制限の引き上げリクエストについて説明します。支出制限により、各メンバーの使用クレジット支出を定期的な期間内で上限設定でき、各メンバーの制限がどこから継承されているかを確認でき、メンバーのより高い制限に対するリクエストを確認または対応できます。

ユーザーごとおよび時間単位の使用状況とコストレポートについては、Claude Enterprise Analytics APIリファレンスガイドを参照してください。

Claude Enterprise Admin APIは現在パブリックベータ版であり、使用クレジットが有効になっているエンタープライズプランの組織で利用可能です。

概要

2つのリソースにわたって8つのエンドポイントがあります。

リソース

エンドポイント

用途

支出制限

GET /v1/organizations/spend_limits/effective

GET /v1/organizations/spend_limits/{spend_limit_id}

POST /v1/organizations/spend_limits

DELETE /v1/organizations/spend_limits/{spend_limit_id}

各メンバーの有効な制限と期間内の支出を読み取り、ユーザーごとのオーバーライドを設定またはクリアします。

支出制限の引き上げリクエスト

GET /v1/organizations/spend_limit_increase_requests

GET /v1/organizations/spend_limit_increase_requests/{id}

POST /v1/organizations/spend_limit_increase_requests/{id}/approve

POST /v1/organizations/spend_limit_increase_requests/{id}/deny

メンバーのより高い制限に対するリクエストを一覧表示し、決定に必要なコンテキストを提供します。各リクエストを承認または拒否します。

支出制限エンドポイントを使用して、「各メンバーにどの制限が適用され、どこから来ているのか、そしてどの程度近いのか?」という質問に答え、ユーザーごとのオーバーライドを設定します。支出制限の引き上げリクエストエンドポイントを使用して、メンバーが送信したリクエストのキューを処理します。

前提条件と認証

  • 組織はClaudeエンタープライズプランに登録している必要があります。

  • 使用クレジットは組織に対して有効にする必要があります。プライマリオーナーはClaudeの請求設定でこれを有効にできます。

  • プライマリオーナーは、以下の1つまたは両方のスコープを持つAdmin APIキーを生成する必要があります。

    • read:spend_limits(すべてのGETエンドポイントに必須)

    • write:spend_limitsPOSTおよびDELETEエンドポイントに必須)

すべてのリクエストでx-api-keyヘッダーにキーを渡します。

重要:APIキーを公開で共有したり、ソース管理にチェックインしたりしないでください。

ベースURL

https://api.anthropic.com

レート制限

8つのエンドポイントすべてが、組織ごとに1分あたり60リクエストの単一の制限を共有します。制限を超えるリクエストは429 Too Many Requestsを返します。

ページネーション

GET /v1/organizations/spend_limits/effectiveGET /v1/organizations/spend_limit_increase_requests不透明なカーソルでページネーションされます。最初のリクエストは最大limit行とnext_pageカーソルを返します。そのカーソルを次のリクエストでpageパラメータとして変更せずに渡し、next_pagenullになるまで繰り返します。

重要:シーケンスの途中でクエリパラメータを変更しないでください。カーソルはそれらを発行したフィルタに関連付けられています。user_ids[]status[]、またはactor_ids[]を変更して古いカーソルを渡すと、「cursor does not match current query parameters」というメッセージで400エラーが返されます。代わりに最初のページから新しいシーケンスを開始してください。

カーソル文字列を不透明として扱う:解析、変更、または自分で構築しないでください。

リストパラメータのシリアライズ

リストパラメータは括弧表記を使用します:各値に対して[]を付けてパラメータ名を繰り返します。

user_ids[]=user_01AbCdEfGh&user_ids[]=user_01JkLmNoPq

エラーレスポンス

ステータス

意味

400

無効な入力、サポートされていないパラメータ値、ページカーソルが現在のパラメータと一致しない、または前提条件が満たされていません(エンドポイントごとの検証を参照)。

401

x-api-keyヘッダーがありません。

403

APIキーに必要なスコープ(read:spend_limitsまたはwrite:spend_limits)がありません。

404

リソースが見つかりません。APIキーが不明、期限切れ、または取り消されています。

429

レート制限を超過しました。

500

内部エラー。

エラーボディの形式は以下の通りです:

{"type": "error", "error": {"type": "<error_type>", "message": "..."}, "request_id": "req_..."}

error.type はステータス依存の判別子です:invalid_request_error(400)、authentication_error(401)、permission_error(403)、not_found_error(404)、rate_limit_error(429)、api_error(500)。request_id は常に存在し、サポートに問い合わせる際に引用する値です。各エンドポイントの検証テーブルに特定のメッセージが記載されています。


概念

支出制限階層

各メンバーの使用クレジット支出は、スコープレベルの階層から解決される有効支出制限によって制限されます。メンバーがユーザー単位のオーバーライドを持たない場合、シートティア、グループ(組織がグループベースの制限を使用している場合)、または組織全体のデフォルトに設定された制限を継承します。

GET /v1/organizations/spend_limits/effective を読み取ると、解決された有効制限を持つすべての現在のメンバー、その制限が解決された場所(source)、および期間累計支出が返されます。POST /v1/organizations/spend_limits 経由でユーザー単位のオーバーライドを設定すると、メンバーは本来継承する内容に関係なく特定の制限に固定されます。オーバーライドを削除すると、継承された制限に戻ります。

スコープ

スコープは、支出制限が書き込まれたまたは解決されたレベルを識別します:

タイプ

フィールド

意味

user

user_id

特定のメンバー。user_id は Admin API ユーザーエンドポイントによって返される ID と一致します。

seat_tier

seat_tier

シートティアのデフォルト。seat_tier の値は enterprise_standard または enterprise_tier_1 などの完全修飾識別子です。追加の値が追加される場合があります。

rbac_group

rbac_group_id

組織がグループ別に制限を管理する場合のグループデフォルト。

organization

組織全体のデフォルト。

scope.type はオープン文字列です。クライアントは不明な値を不透明として扱い、失敗するのではなく次に進むべきです。追加のスコープタイプが将来追加される場合があります。

期間

period は制限が適用され支出がリセットされる定期的なウィンドウです。現在の唯一の値は "monthly" です。

period はオープン文字列です。クライアントは不明な値を不透明として扱い、失敗するのではなく次に進むべきです。追加の期間値が将来追加される場合があります。

金額と通貨

すべての金銭的価値は、組織の請求通貨の最小単位(USD の場合はセント)の文字列です。たとえば、"50000" は 500.00 USD を表します。小数として解析し、100 で割ってドルを表示します。大きな値の場合は、バイナリ浮動小数点を避けてください。

amountヌル可能です:null無制限(制限なし)を意味します。"0" は、そのメンバーに対して使用クレジットが無効であることを意味します。

period_to_date_spend は、現在の period の開始以降にメンバーが蓄積した使用クレジットで、同じ最小単位形式です。小数部を含む場合があります(たとえば、"41280.125")。

支出制限増加リクエストのライフサイクル

支出制限増加リクエストは、メンバーが claude.ai で「さらに使用をリクエスト」をクリックしたときに作成されます。このAPI経由ではリクエストは作成されません。

ステータス

意味

pending

管理者のアクションを待機中。リクエストは通常、メンバーの現在の有効制限と期間累計支出を確認できるようにライブ spend_summary を含みます。spend_summary は計算できない場合は null の場合があるため、そのケースを処理してください。

approved

リクエストは承認で解決されました:管理者が明示的に承認したか(管理者が指定した金額でユーザー単位の支出制限を書き込んだ)、別の管理者アクションがメンバーに使用クレジットを利用可能にした(たとえば、シートティア制限を引き上げたか、組織の使用クレジット請求を有効にした)、または Anthropic サポートが組織に代わって制限を引き上げました。spend_summarynull です。

denied

管理者が拒否しました。spend_summarynull です。Claude.ai は resolved_at から 30 日間、そのメンバーのリクエストボタンを非表示にします。管理者はいつでもメンバーの制限を直接引き上げることができます。

approveddenied の両方がターミナルです。メンバーは最大 1 つの pending リクエストを持つことができます。

POST …/approve 経由で承認すると、POST /v1/organizations/spend_limits が書き込むのと同じユーザー単位の支出制限行が書き込まれます。支出制限を直接設定しても、保留中のリクエストは遷移しません。リクエストを解決するには approve エンドポイントを使用してください。

デフォルトでは、Anthropic はメンバーのリクエストが承認または拒否されたときにメンバーにメールを送信します。approve または deny で suppress_notification: true を渡して、そのメール(たとえば、独自のシステムがメンバーに通知する場合)を抑制します。


SpendLimit オブジェクト

1つのスコープレベルで設定された制限。

{
"type": "spend_limit",
"id": "spl_01AbCdEfGhIjKlMnOpQrSt",
"created_at": "2026-05-01T12:00:00Z",
"updated_at": "2026-05-03T09:14:11Z",
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "monthly"
}

フィールド

タイプ

説明

type

文字列

常に"spend_limit"

id

文字列

spl_プレフィックス付き。

created_at

文字列(RFC 3339)

この制限が最初に設定された時刻。

updated_at

文字列(RFC 3339)

この制限が最後に変更された時刻。

scope

スコープ

この制限が書き込まれるレベル。「スコープ」セクションを参照してください。

amount

文字列またはnull

periodの制限(最小単位)。nullは無制限を意味します。

currency

文字列

ISO 4217。組織の請求通貨。

period

文字列

amountが適用される定期的なウィンドウ。「期間」セクションを参照してください。

SpendSummaryオブジェクト

計算されたメンバーごとのレポート行:メンバーの有効な制限、その出所、および期間内の支出。アドレス指定可能なリソースではありません(idなし)。

{
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "monthly",
"source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "31402.5"
}

フィールド

タイプ

説明

scope

スコープ(type: "user"

このロウが対象とするメンバー。

amount

文字列またはnull

periodの有効な制限(最小単位)。nullは無制限を意味し、"0"は使用クレジットが無効になっていることを意味します。

currency

文字列

ISO 4217。

period

sourceが解決された支出制限の期間。「期間」セクションを参照してください。

The period of the spend limit that source resolved to. See the "Period" section.

source

スコープ

amountが階層内のどこから解決されたか。メンバーがユーザーごとのオーバーライドを持つ場合、scopeと同じです。

spend_limit_id

文字列

SpendLimit の ID。source が解決されたもの。GET /v1/organizations/spend_limits/{spend_limit_id} で取得してください。

period_to_date_spend

文字列

現在の period の開始以降にメンバーが獲得した使用クレジット(最小単位)。

SpendLimitIncreaseRequest オブジェクト

{
"type": "spend_limit_increase_request",
"id": "slir_01AbCdEfGhIjKlMnOpQrSt",
"created_at": "2026-05-04T16:22:09Z",
"status": "pending",
"resolved_at": null,
"resolved_by": null,
"actor": {
"type": "user_actor",
"user_id": "user_01AbCdEfGh",
"name": "Jane Smith",
"email_address": "[email protected]"
},
"spend_summary": {
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "monthly",
"source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "48900"
}
}

フィールド

タイプ

説明

type

文字列

常に "spend_limit_increase_request"

id

文字列

slir_ でプレフィックスされています。

created_at

文字列(RFC 3339)

メンバーがリクエストを送信した時刻。

status

文字列

pendingapproved、または denied

resolved_at

文字列(RFC 3339)または null

リクエストが承認または却下された時刻。保留中は null

resolved_by

Actor または null

リクエストを承認または却下した者:user_actor(管理者が claude.ai で操作)または scoped_api_key_actor(このAPI経由で解決)。管理者が claude.ai でリクエストを自動解決した場合(例:シートティアリミットの引き上げ、組織の使用クレジット課金の有効化、メンバーのリミット引き上げ)、resolved_by は操作した管理者の user_actor です。保留中、解決した管理者のアカウントが削除された場合、またはリクエストが Anthropic サポートによって解決された場合は nullscoped_api_key_actor は削除またはリボークされたキーを参照する場合があります。scoped_api_key_id を履歴参照として扱い、ルックアップ失敗を許容してください。

actor

Actor(user_actor

リクエストを送信したメンバー。

spend_summary

SpendSummary または null

リクエスター向けのライブ決定コンテキスト:有効なリミットと期間累計支出。status が pending の間は表示(サマリーが計算できない場合は null の可能性あり);解決後は常に null

Actor

フィールド

タイプ

説明

type

文字列

user_actor または scoped_api_key_actor

user_id

文字列

user_actor に存在。ユーザーの ID;actor_ids[] で受け入れられる同じ値。

name

文字列または null

user_actor に存在。ユーザーの名前;アカウントが削除されているか、ユーザーが名前を設定していない場合は null

email_address

文字列または null

user_actor に存在。ユーザーのメール;アカウントが削除されている場合は null

scoped_api_key_id

文字列

scoped_api_key_actorに存在します。apikey_がプレフィックスされています。


支出制限

1. 有効な支出制限を一覧表示

GET /v1/organizations/spend_limits/effective

組織の現在のすべてのメンバーを、解決された有効な制限と期間内の支出とともに返します。ユーザーごとのオーバーライドがないメンバーは、source.typeseat_tierrbac_group、またはorganizationで表示されます。退職したメンバーはリストされません。

必要なスコープ: read:spend_limits.

クエリパラメータ

フィールド

タイプ

必須

デフォルト

説明

user_ids[]

文字列、最大100エントリ

いいえ

すべてのメンバー

特定のメンバーに絞り込みます。user_...IDを受け入れます。現在のメンバーではないエントリはdataから暗黙的に除外されます。

limit

整数1~1000

いいえ

20

ページあたりの行数。

page

不透明なカーソル文字列

いいえ

前のレスポンスのnext_page値。

レスポンスフィールド

フィールド

タイプ

説明

data

SpendSummaryの配列

メンバーごとに1つのエントリ、メンバーが組織に参加した時期順(最新が最初)。

next_page

文字列またはnull

次のページの不透明なカーソル。ページがない場合はnull

リクエスト例

curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?limit=20" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"

レスポンス例

{
"data": [
{
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "monthly",
"source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "31402.5"
}
],
"next_page": "page_..."
}

検証

条件

ステータス

メッセージ

user_ids[]エントリの形式が正しくない

400

user_ids[]: entry is not a valid user ID

user_ids[]に100を超えるエントリがある

400

limitが1~1000の範囲外

400

pageカーソルが無効

400

page: 無効なカーソル

page カーソルが現在の user_ids[] と一致しません

400

page: カーソルが現在のクエリパラメータと一致しません

page カーソルが異なるAPIバージョンからのものです

400

page: カーソルは異なるAPIバージョンによって発行されました

組織がエンタープライズプランに登録していません

400

このエンドポイントはこの組織タイプではサポートされていません

使用クレジット請求が有効になっていません

400

この組織では超過請求が有効になっていません


2. 支出制限を取得する

GET /v1/organizations/spend_limits/{spend_limit_id}

IDで単一の支出制限を返します。SpendSummary.spend_limit_id または POST レスポンスが参照する行を検査するために使用します。

必要なスコープ: read:spend_limits

パスパラメータ

フィールド

タイプ

説明

spend_limit_id

文字列

spl_ がプレフィックスされています。

レスポンス

SpendLimitオブジェクト。

リクエスト例

curl "https://api.anthropic.com/v1/organizations/spend_limits/spl_01AbCdEfGhIjKlMnOpQrSt" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"

検証

条件

ステータス

メッセージ

spend_limit_id がこの組織に見つかりません

404

組織がエンタープライズプランに登録していません

400

このエンドポイントはこの組織タイプではサポートされていません

使用クレジット請求が有効になっていません

400

この組織では超過請求が有効になっていません


3. 支出制限を設定する

POST /v1/organizations/spend_limits

ユーザーごとの支出制限オーバーライドを設定します。アップサート: 既に制限を持つユーザーに対して制限を設定すると、その場で上書きされます。

scope.type: "user" のみが受け入れられます。シート層、グループ、および組織レベルのデフォルトは claude.ai 設定で構成されます。

支出制限を直接設定しても、メンバーの保留中の増加リクエストは遷移しません。承認エンドポイントを使用してリクエストを解決してください。

必要なスコープ: write:spend_limits

リクエストボディ

フィールド

タイプ

必須

説明

scope

オブジェクト

はい

{ "type": "user", "user_id": "user_..." }

amount

文字列またはnull

はい

periodの新しい制限(マイナー単位、負でない整数の10進数文字列)。"0"はメンバーの使用クレジットを無効にします。nullは制限を削除します(無制限)。

period

文字列

いいえ

デフォルト"monthly"。「期間」セクションを参照してください。

レスポンス

書き込まれたオーバーライドを反映するSpendLimitオブジェクト。

リクエスト例

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limits" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-H "content-type: application/json" \
-d '{"scope": {"type": "user", "user_id": "user_01AbCdEfGh"}, "amount": "75000"}'

レスポンス例

{
"type": "spend_limit",
"id": "spl_01RsTuVwXyZaBcDeFgHiJk",
"created_at": "2026-05-11T10:02:44Z",
"updated_at": "2026-05-11T10:02:44Z",
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "75000",
"currency": "USD",
"period": "monthly"
}

検証

条件

ステータス

メッセージ

scope.type"user"ではない

400

scope.type: まだサポートされていません

scope.user_idの形式が正しくない

400

scope.user_id: 形式が正しくありません

scope.user_idがこの組織のメンバーではない

400

scope.user_id: この組織のメンバーではありません

amountが負の値、小数、または有効な10進数文字列ではない

400

period"monthly"ではない

400

period: まだサポートされていません

組織がエンタープライズプランに登録していない

400

このエンドポイントはこの組織タイプではサポートされていません

使用クレジット請求が有効になっていない

400

この組織では超過請求が有効になっていません


4. 支出制限を削除する

DELETE /v1/organizations/spend_limits/{spend_limit_id}

ユーザーごとのオーバーライドを削除して、メンバーが継承された制限(シート層、グループ、または組織のデフォルト)にフォールバックするようにします。シート層、グループ、および組織レベルの行はこのエンドポイント経由では削除できません。

スコープが必要です:write:spend_limits

パスパラメータ

フィールド

タイプ

説明

spend_limit_id

文字列

spl_で始まります。ユーザーごとのオーバーライドのIDである必要があります。

レスポンス

{ "type": "spend_limit_deleted", "id": "spl_01RsTuVwXyZaBcDeFgHiJk" }

リクエスト例

curl -X DELETE "https://api.anthropic.com/v1/organizations/spend_limits/spl_01RsTuVwXyZaBcDeFgHiJk" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"

検証

条件

ステータス

メッセージ

spend_limit_id がこの組織に見つかりません

404

spend_limit_id はシートティア、グループ、または組織行です

400

このエンドポイント経由で削除できるのはユーザーごとの支出制限のみです。

組織がエンタープライズプランに登録していません

400

このエンドポイントはこの組織タイプではサポートされていません

使用クレジット請求が有効になっていません

400

この組織では超過請求が有効になっていません


支出制限増加リクエスト

5. 増加リクエストをリストアップ

GET /v1/organizations/spend_limit_increase_requests

増加リクエストを最新順にリストアップします。リクエスターが組織のメンバーではなくなったリクエストは除外されます。

必要なスコープ: read:spend_limits

クエリパラメータ

フィールド

タイプ

必須

デフォルト

説明

status[]

pendingapproveddenied のいずれか1つ以上

いいえ

すべて

ステータスでフィルタリングします。複数の値の場合はパラメータを繰り返します。

actor_ids[]

文字列

いいえ

すべて

リクエスターでフィルタリングします。user_... IDを受け入れます。

limit

整数 1–1000

いいえ

20

ページあたりの行数。

page

不透明なカーソル文字列

いいえ

前のレスポンスの next_page 値。

レスポンスフィールド

フィールド

タイプ

説明

data

SpendLimitIncreaseRequest の配列

created_at で降順に並べられています。

next_page

文字列または null

次のページの不透明なカーソル。ページがない場合は null

リクエスト例

curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests?status[]=pending&limit=50" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"

レスポンス例

{
"data": [
{
"type": "spend_limit_increase_request",
"id": "slir_01AbCdEfGhIjKlMnOpQrSt",
"created_at": "2026-05-04T16:22:09Z",
"status": "pending",
"resolved_at": null,
"resolved_by": null,
"actor": {
"type": "user_actor",
"user_id": "user_01AbCdEfGh",
"name": "Jane Smith",
"email_address": "[email protected]"
},
"spend_summary": {
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "50000",
"currency": "USD",
"period": "monthly",
"source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
"spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
"period_to_date_spend": "48900"
}
}
],
"next_page": null
}

検証

条件

ステータス

メッセージ

actor_ids[] エントリが不正な形式です

400

actor_ids[]: invalid tagged user ID

limit が 1~1000 の範囲外です

400

page カーソルが不正な形式です

400

invalid page cursor format または invalid page cursor

page カーソルが現在の status[] または actor_ids[] と一致しません

400

page cursor does not match current query parameters

別の API バージョンからの page カーソル

400

page cursor was issued by a different API version; restart pagination

組織が Enterprise プランに登録していません

400

this endpoint is not supported for this organization type

使用クレジット課金が有効になっていません

400

overage billing is not enabled for this organization


6. 増加リクエストを取得する

GET /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

単一の増加リクエストを返します。

必要なスコープ: read:spend_limits

パスパラメータ

フィールド

タイプ

説明

spend_limit_increase_request_id

文字列

slir_ がプレフィックスされています。

レスポンス

SpendLimitIncreaseRequest オブジェクト。

リクエスト例

curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"

検証

条件

ステータス

メッセージ

この組織でリクエストが見つかりません

404

リクエスターはこの組織のメンバーではなくなりました

404

組織はエンタープライズプランに登録していません

400

このエンドポイントはこの組織タイプではサポートされていません

使用クレジット請求が有効になっていません

400

この組織では超過請求が有効になっていません


7. 増加リクエストを承認する

POST /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve

保留中のリクエストを承認します。amountでリクエスターのユーザーあたりの支出制限を書き込み、リクエストをapprovedに遷移させます。リクエストが要求額を含まない場合、管理者は承認時に新しい制限を提供します。

必要なスコープ: write:spend_limits

パスパラメータ

フィールド

タイプ

説明

spend_limit_increase_request_id

文字列

slir_が接頭辞として付きます。

リクエストボディ

フィールド

タイプ

必須

デフォルト

説明

amount

文字列

はい

periodの新しいユーザーあたりの制限。マイナー単位で、負でない整数の10進文字列として表示されます。

period

文字列

いいえ

"monthly"

「期間」セクションを参照してください。

suppress_notification

ブール値

いいえ

false

trueの場合、Anthropicはリクエストが承認されたことをメンバーにメールで通知しません。

レスポンス

ステータスapprovedのSpendLimitIncreaseRequest。書き込まれたSpendLimitを含む追加のspend_limitフィールドが含まれます。

リクエスト例

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/approve" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-H "content-type: application/json" \
-d '{"amount": "75000", "suppress_notification": true}'

レスポンス例

{
"type": "spend_limit_increase_request",
"id": "slir_01AbCdEfGhIjKlMnOpQrSt",
"created_at": "2026-05-04T16:22:09Z",
"status": "approved",
"resolved_at": "2026-05-11T10:05:02Z",
"resolved_by": {
"type": "scoped_api_key_actor",
"scoped_api_key_id": "apikey_01ZyXwVuTsRqPoNmLkJiHg"
},
"actor": {
"type": "user_actor",
"user_id": "user_01AbCdEfGh",
"name": "Jane Smith",
"email_address": "[email protected]"
},
"spend_summary": null,
"spend_limit": {
"type": "spend_limit",
"id": "spl_01RsTuVwXyZaBcDeFgHiJk",
"created_at": "2026-05-11T10:05:02Z",
"updated_at": "2026-05-11T10:05:02Z",
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"amount": "75000",
"currency": "USD",
"period": "monthly"
}
}

検証

条件

ステータス

メッセージ

この組織でリクエストが見つかりません

404

リクエスターはこの組織のメンバーではなくなりました

404

リクエストは既に承認または拒否されています

400

支出制限増加リクエストは既に解決されています

金額が負の数、小数、または有効な10進数文字列ではありません

400

期間"月次"ではありません

400

期間: まだサポートされていません

組織はエンタープライズプランに登録していません

400

このエンドポイントはこの組織タイプではサポートされていません

使用クレジット請求が有効になっていません

400

この組織では超過請求が有効になっていません


8. 増加リクエストを拒否する

POST /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny

保留中のリクエストを拒否します。拒否時はべき等です: 既に拒否されたリクエストを拒否すると、既存のリソースで200が返されます。既に承認されたリクエストを拒否することは拒否されるため、自動化は再試行と矛盾する決定を区別できます。

スコープが必要です: write:spend_limits

パスパラメータ

フィールド

タイプ

説明

spend_limit_increase_request_id

文字列

slir_が付いています。

リクエストボディ

フィールド

タイプ

必須

デフォルト

説明

suppress_notification

ブール値

いいえ

false

trueの場合、Anthropicはリクエストが拒否されたことをメンバーにメールで通知しません。

レスポンス

ステータスが拒否されたSpendLimitIncreaseRequest。

リクエスト例

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/deny" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-H "content-type: application/json" \
-d '{"suppress_notification": true}'

検証

条件

ステータス

メッセージ

この組織でリクエストが見つかりません

404

リクエスターはこの組織のメンバーではなくなりました

404

リクエストは既に承認されています

400

支出制限の増加リクエストは既に承認されています

リクエストは既に拒否されています

— (200, idempotent)

組織はエンタープライズプランに登録していません

400

このエンドポイントはこの組織タイプではサポートされていません

使用クレジットが有効になっていません

400

この組織では超過請求が有効になっていません

こちらの回答で解決しましたか?