Repository Public
1---2title: Spend Limits3url: https://platform.claude.com/docs/en/api/beta/organization/spend_limits4---56# Spend Limits78## Set Spend Limit910**POST** `/v1/organizations/spend_limits`1112Set a spend limit.1314Upsert keyed on (scope, period): setting a limit that already exists15overwrites it in place. A Claude Enterprise organization sets `user`16limits. Its seat-tier, group, and organization-level defaults are configured17in claude.ai. A Claude Console organization sets `organization` and18`workspace` limits, which are monthly and always carry an amount. Setting those19limits is in an early access preview. To request access, contact your20Anthropic account team.2122### Body parameters2324- `amount: string or null`2526 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.2728- `scope: User or Organization or Workspace`2930 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.3132 - `User object`3334 Scope selecting a single member of the organization.3536 - `type: "user"`3738 Scope type. Always `user` for this scope.3940 default: user4142 - `user_id: string`4344 Tagged ID of the member the spend limit applies to.4546 - `Organization object`4748 - `type: "organization"`4950 default: organization5152 - `Workspace object`5354 Scope selecting one workspace of a Claude Console organization.5556 - `type: "workspace"`5758 Scope type. Always `workspace` for this scope.5960 default: workspace6162 - `workspace_id: string`6364 Tagged ID of the workspace the spend limit applies to.6566- `period: optional "daily" or "monthly" or "weekly"`6768 - `"daily"`6970 - `"monthly"`7172 - `"weekly"`7374### Returns7576- `BetaSpendLimit object`7778 A configured spend limit: a cap on metered spend for one scope and period.7980 - `type: "spend_limit"`8182 Object type. Always `spend_limit`.8384 default: spend_limit8586 - `id: string`8788 Unique tagged ID of the spend limit (`spl_...`).8990 - `amount: string or null`9192 Limit amount as a non-negative integer decimal string in the minor unit of `currency` (cents for USD): "50000" is $500.00. `null` means no numeric cap is configured at this scope — see the effective report for whether a limit applies.9394 - `created_at: string`9596 RFC 3339 datetime at which the spend limit was created.9798 format: date-time99100 - `currency: string`101102 ISO 4217 code of the organization's billing currency; the unit for `amount`.103104 - `period: "daily" or "monthly" or "weekly"`105106 Length of the window the limit resets over. `amount` caps spend within each period.107108 - `"daily"`109110 - `"monthly"`111112 - `"weekly"`113114 - `scope: User or SeatTier or RBACGroup or 3 more`115116 What the limit applies to. A tagged union on `type`; each variant carries the identifier for its scope.117118 - `User object`119120 Scope selecting a single member of the organization.121122 - `type: "user"`123124 Scope type. Always `user` for this scope.125126 default: user127128 - `user_id: string`129130 Tagged ID of the member the spend limit applies to.131132 - `SeatTier object`133134 - `type: "seat_tier"`135136 default: seat_tier137138 - `seat_tier: string`139140 - `RBACGroup object`141142 - `type: "rbac_group"`143144 default: rbac_group145146 - `rbac_group_id: string`147148 - `OrganizationService object`149150 - `type: "organization_service"`151152 default: organization_service153154 - `service: string`155156 - `Organization object`157158 - `type: "organization"`159160 default: organization161162 - `Workspace object`163164 Scope selecting one workspace of a Claude Console organization.165166 - `type: "workspace"`167168 Scope type. Always `workspace` for this scope.169170 default: workspace171172 - `workspace_id: string`173174 Tagged ID of the workspace the spend limit applies to.175176 - `updated_at: string`177178 RFC 3339 datetime at which the spend limit was last modified.179180 format: date-time181182### Example183184```bash185curl https://api.anthropic.com/v1/organizations/spend_limits \186 -H 'Content-Type: application/json' \187 -H 'anthropic-version: 2023-06-01' \188 -H "X-Api-Key: $ANTHROPIC_API_KEY" \189 -d '{190 "amount": "50000",191 "scope": {192 "type": "user",193 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"194 },195 "period": "monthly"196 }'197```198199#### Response (200)200201```json202{203 "id": "id",204 "amount": "50000",205 "created_at": "2019-12-27T18:11:19.117Z",206 "currency": "USD",207 "period": "monthly",208 "scope": {209 "type": "user",210 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"211 },212 "type": "spend_limit",213 "updated_at": "2019-12-27T18:11:19.117Z"214}215```216217## Get Spend Limit218219**GET** `/v1/organizations/spend_limits/{spend_limit_id}`220221Retrieve a spend limit by ID.222223### Path parameters224225- `spend_limit_id: string`226227 ID of the Spend Limit.228229### Returns230231- `BetaSpendLimit object`232233 A configured spend limit: a cap on metered spend for one scope and period.234235 - `type: "spend_limit"`236237 Object type. Always `spend_limit`.238239 default: spend_limit240241 - `id: string`242243 Unique tagged ID of the spend limit (`spl_...`).244245 - `amount: string or null`246247 Limit amount as a non-negative integer decimal string in the minor unit of `currency` (cents for USD): "50000" is $500.00. `null` means no numeric cap is configured at this scope — see the effective report for whether a limit applies.248249 - `created_at: string`250251 RFC 3339 datetime at which the spend limit was created.252253 format: date-time254255 - `currency: string`256257 ISO 4217 code of the organization's billing currency; the unit for `amount`.258259 - `period: "daily" or "monthly" or "weekly"`260261 Length of the window the limit resets over. `amount` caps spend within each period.262263 - `"daily"`264265 - `"monthly"`266267 - `"weekly"`268269 - `scope: User or SeatTier or RBACGroup or 3 more`270271 What the limit applies to. A tagged union on `type`; each variant carries the identifier for its scope.272273 - `User object`274275 Scope selecting a single member of the organization.276277 - `type: "user"`278279 Scope type. Always `user` for this scope.280281 default: user282283 - `user_id: string`284285 Tagged ID of the member the spend limit applies to.286287 - `SeatTier object`288289 - `type: "seat_tier"`290291 default: seat_tier292293 - `seat_tier: string`294295 - `RBACGroup object`296297 - `type: "rbac_group"`298299 default: rbac_group300301 - `rbac_group_id: string`302303 - `OrganizationService object`304305 - `type: "organization_service"`306307 default: organization_service308309 - `service: string`310311 - `Organization object`312313 - `type: "organization"`314315 default: organization316317 - `Workspace object`318319 Scope selecting one workspace of a Claude Console organization.320321 - `type: "workspace"`322323 Scope type. Always `workspace` for this scope.324325 default: workspace326327 - `workspace_id: string`328329 Tagged ID of the workspace the spend limit applies to.330331 - `updated_at: string`332333 RFC 3339 datetime at which the spend limit was last modified.334335 format: date-time336337### Example338339```bash340curl https://api.anthropic.com/v1/organizations/spend_limits/$SPEND_LIMIT_ID \341 -H 'anthropic-version: 2023-06-01' \342 -H "X-Api-Key: $ANTHROPIC_API_KEY"343```344345#### Response (200)346347```json348{349 "id": "id",350 "amount": "50000",351 "created_at": "2019-12-27T18:11:19.117Z",352 "currency": "USD",353 "period": "monthly",354 "scope": {355 "type": "user",356 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"357 },358 "type": "spend_limit",359 "updated_at": "2019-12-27T18:11:19.117Z"360}361```362363## Delete Spend Limit364365**DELETE** `/v1/organizations/spend_limits/{spend_limit_id}`366367Delete a spend limit.368369For a Claude Enterprise organization, this deletes a per-user override, and370the member falls back to any inherited spend limit at that period. Its371seat-tier, group, and organization-level rows cannot be deleted via this372endpoint. A Claude Console organization deletes its organization and373workspace limits. Deleting them through the API is in an early access preview.374375### Path parameters376377- `spend_limit_id: string`378379 ID of the Spend Limit.380381### Returns382383- `type: "spend_limit_deleted"`384385 default: spend_limit_deleted386387- `id: string`388389### Example390391```bash392curl https://api.anthropic.com/v1/organizations/spend_limits/$SPEND_LIMIT_ID \393 -X DELETE \394 -H 'anthropic-version: 2023-06-01' \395 -H "X-Api-Key: $ANTHROPIC_API_KEY"396```397398#### Response (200)399400```json401{402 "id": "id",403 "type": "spend_limit_deleted"404}405```406407## List Effective Spend Limits408409**GET** `/v1/organizations/spend_limits/effective`410411List each member's effective spend limit and period-to-date spend.412413Returns one row per (member, period) the member resolves a spend limit414for, with the `source` scope the spend limit was inherited from.415Paginates by member, so a member's periods never split across pages.416417### Query parameters418419- `limit: optional number`420421 Maximum number of members per page. A member's period rows never split across pages, so a page may carry more rows than this. Defaults to `20`.422423 default: 20, maximum: 1000, minimum: 1424425- `page: optional string`426427 Opaque cursor from a previous response's `next_page` field.428429- `period: optional array of "daily" or "monthly" or "weekly"`430431 Restrict the report to these limit periods. Omit to return one row per period each member resolves a spend limit for.432433 maxItems: 3434435 - `"daily"`436437 - `"monthly"`438439 - `"weekly"`440441- `user_ids: optional array of string`442443 Restrict the report to these members, by tagged user ID (`user_...`). At most 100 entries.444445 maxItems: 100446447### Returns448449- `data: array of BetaSpendSummary`450451 - `actor: UserActor or ScopedAPIKeyActor`452453 - `UserActor object`454455 A user within the organization. `name` and `email_address` are456 null when the underlying account is unavailable or has been deleted;457 `deleted` is true only for deleted accounts.458459 - `type: "user_actor"`460461 Actor type. Always `user_actor`.462463 default: user_actor464465 - `deleted: boolean`466467 True only when the underlying account has been deleted.468469 default: false470471 - `email_address: string or null`472473 The user's email address. Null when the account is unavailable or has been deleted.474475 - `name: string or null`476477 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.478479 - `user_id: string`480481 Tagged ID of the user.482483 - `ScopedAPIKeyActor object`484485 A scoped Admin API key acting on behalf of the organization.486487 - `type: "scoped_api_key_actor"`488489 default: scoped_api_key_actor490491 - `scoped_api_key_id: string`492493 - `amount: string or null`494495 Effective limit amount as a non-negative integer decimal string in the minor unit of `currency` (cents for USD). `null` means no limit applies for this row's `period` — each period resolves independently, so another period may still cap this member.496497 - `currency: string`498499 ISO 4217 code of the organization's billing currency; the unit for `amount` and `period_to_date_spend`.500501 - `period: "daily" or "monthly" or "weekly"`502503 Period this row's effective limit and spend are reported for.504505 - `"daily"`506507 - `"monthly"`508509 - `"weekly"`510511 - `period_to_date_spend: string`512513 The member's spend so far in the current period, as a non-negative decimal string in the minor unit of `currency` (cents for USD). May carry fractional minor units up to three decimal places (e.g. `"12050.5"`) — metered usage is not rounded to whole cents. Reads as `"0"` when the spend reading is temporarily unavailable.514515 - `scope: User or SeatTier or RBACGroup or 3 more`516517 - `User object`518519 Scope selecting a single member of the organization.520521 - `type: "user"`522523 Scope type. Always `user` for this scope.524525 default: user526527 - `user_id: string`528529 Tagged ID of the member the spend limit applies to.530531 - `SeatTier object`532533 - `type: "seat_tier"`534535 default: seat_tier536537 - `seat_tier: string`538539 - `RBACGroup object`540541 - `type: "rbac_group"`542543 default: rbac_group544545 - `rbac_group_id: string`546547 - `OrganizationService object`548549 - `type: "organization_service"`550551 default: organization_service552553 - `service: string`554555 - `Organization object`556557 - `type: "organization"`558559 default: organization560561 - `Workspace object`562563 Scope selecting one workspace of a Claude Console organization.564565 - `type: "workspace"`566567 Scope type. Always `workspace` for this scope.568569 default: workspace570571 - `workspace_id: string`572573 Tagged ID of the workspace the spend limit applies to.574575 - `source: User or SeatTier or RBACGroup or 3 more`576577 - `User object`578579 Scope selecting a single member of the organization.580581 - `type: "user"`582583 Scope type. Always `user` for this scope.584585 default: user586587 - `user_id: string`588589 Tagged ID of the member the spend limit applies to.590591 - `SeatTier object`592593 - `type: "seat_tier"`594595 default: seat_tier596597 - `seat_tier: string`598599 - `RBACGroup object`600601 - `type: "rbac_group"`602603 default: rbac_group604605 - `rbac_group_id: string`606607 - `OrganizationService object`608609 - `type: "organization_service"`610611 default: organization_service612613 - `service: string`614615 - `Organization object`616617 - `type: "organization"`618619 default: organization620621 - `Workspace object`622623 Scope selecting one workspace of a Claude Console organization.624625 - `type: "workspace"`626627 Scope type. Always `workspace` for this scope.628629 default: workspace630631 - `workspace_id: string`632633 Tagged ID of the workspace the spend limit applies to.634635 - `spend_limit_id: string`636637- `next_page: string or null`638639### Example640641```bash642curl https://api.anthropic.com/v1/organizations/spend_limits/effective \643 -H 'anthropic-version: 2023-06-01' \644 -H "X-Api-Key: $ANTHROPIC_API_KEY"645```646647#### Response (200)648649```json650{651 "data": [652 {653 "actor": {654 "deleted": true,655 "email_address": "email_address",656 "name": "name",657 "type": "user_actor",658 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"659 },660 "amount": "50000",661 "currency": "USD",662 "period": "monthly",663 "period_to_date_spend": "12050.5",664 "scope": {665 "type": "user",666 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"667 },668 "source": {669 "type": "user",670 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"671 },672 "spend_limit_id": "spend_limit_id"673 }674 ],675 "next_page": "next_page"676}677```678679## Domain types680681### Beta Spend Limit682683- `BetaSpendLimit object`684685 A configured spend limit: a cap on metered spend for one scope and period.686687 - `type: "spend_limit"`688689 Object type. Always `spend_limit`.690691 default: spend_limit692693 - `id: string`694695 Unique tagged ID of the spend limit (`spl_...`).696697 - `amount: string or null`698699 Limit amount as a non-negative integer decimal string in the minor unit of `currency` (cents for USD): "50000" is $500.00. `null` means no numeric cap is configured at this scope — see the effective report for whether a limit applies.700701 - `created_at: string`702703 RFC 3339 datetime at which the spend limit was created.704705 format: date-time706707 - `currency: string`708709 ISO 4217 code of the organization's billing currency; the unit for `amount`.710711 - `period: "daily" or "monthly" or "weekly"`712713 Length of the window the limit resets over. `amount` caps spend within each period.714715 - `"daily"`716717 - `"monthly"`718719 - `"weekly"`720721 - `scope: User or SeatTier or RBACGroup or 3 more`722723 What the limit applies to. A tagged union on `type`; each variant carries the identifier for its scope.724725 - `User object`726727 Scope selecting a single member of the organization.728729 - `type: "user"`730731 Scope type. Always `user` for this scope.732733 default: user734735 - `user_id: string`736737 Tagged ID of the member the spend limit applies to.738739 - `SeatTier object`740741 - `type: "seat_tier"`742743 default: seat_tier744745 - `seat_tier: string`746747 - `RBACGroup object`748749 - `type: "rbac_group"`750751 default: rbac_group752753 - `rbac_group_id: string`754755 - `OrganizationService object`756757 - `type: "organization_service"`758759 default: organization_service760761 - `service: string`762763 - `Organization object`764765 - `type: "organization"`766767 default: organization768769 - `Workspace object`770771 Scope selecting one workspace of a Claude Console organization.772773 - `type: "workspace"`774775 Scope type. Always `workspace` for this scope.776777 default: workspace778779 - `workspace_id: string`780781 Tagged ID of the workspace the spend limit applies to.782783 - `updated_at: string`784785 RFC 3339 datetime at which the spend limit was last modified.786787 format: date-time788789### Beta Spend Summary790791- `BetaSpendSummary object`792793 Per-member effective-limit report row (`GET /spend_limits/effective`).794795 - `actor: UserActor or ScopedAPIKeyActor`796797 - `UserActor object`798799 A user within the organization. `name` and `email_address` are800 null when the underlying account is unavailable or has been deleted;801 `deleted` is true only for deleted accounts.802803 - `type: "user_actor"`804805 Actor type. Always `user_actor`.806807 default: user_actor808809 - `deleted: boolean`810811 True only when the underlying account has been deleted.812813 default: false814815 - `email_address: string or null`816817 The user's email address. Null when the account is unavailable or has been deleted.818819 - `name: string or null`820821 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.822823 - `user_id: string`824825 Tagged ID of the user.826827 - `ScopedAPIKeyActor object`828829 A scoped Admin API key acting on behalf of the organization.830831 - `type: "scoped_api_key_actor"`832833 default: scoped_api_key_actor834835 - `scoped_api_key_id: string`836837 - `amount: string or null`838839 Effective limit amount as a non-negative integer decimal string in the minor unit of `currency` (cents for USD). `null` means no limit applies for this row's `period` — each period resolves independently, so another period may still cap this member.840841 - `currency: string`842843 ISO 4217 code of the organization's billing currency; the unit for `amount` and `period_to_date_spend`.844845 - `period: "daily" or "monthly" or "weekly"`846847 Period this row's effective limit and spend are reported for.848849 - `"daily"`850851 - `"monthly"`852853 - `"weekly"`854855 - `period_to_date_spend: string`856857 The member's spend so far in the current period, as a non-negative decimal string in the minor unit of `currency` (cents for USD). May carry fractional minor units up to three decimal places (e.g. `"12050.5"`) — metered usage is not rounded to whole cents. Reads as `"0"` when the spend reading is temporarily unavailable.858859 - `scope: User or SeatTier or RBACGroup or 3 more`860861 - `User object`862863 Scope selecting a single member of the organization.864865 - `type: "user"`866867 Scope type. Always `user` for this scope.868869 default: user870871 - `user_id: string`872873 Tagged ID of the member the spend limit applies to.874875 - `SeatTier object`876877 - `type: "seat_tier"`878879 default: seat_tier880881 - `seat_tier: string`882883 - `RBACGroup object`884885 - `type: "rbac_group"`886887 default: rbac_group888889 - `rbac_group_id: string`890891 - `OrganizationService object`892893 - `type: "organization_service"`894895 default: organization_service896897 - `service: string`898899 - `Organization object`900901 - `type: "organization"`902903 default: organization904905 - `Workspace object`906907 Scope selecting one workspace of a Claude Console organization.908909 - `type: "workspace"`910911 Scope type. Always `workspace` for this scope.912913 default: workspace914915 - `workspace_id: string`916917 Tagged ID of the workspace the spend limit applies to.918919 - `source: User or SeatTier or RBACGroup or 3 more`920921 - `User object`922923 Scope selecting a single member of the organization.924925 - `type: "user"`926927 Scope type. Always `user` for this scope.928929 default: user930931 - `user_id: string`932933 Tagged ID of the member the spend limit applies to.934935 - `SeatTier object`936937 - `type: "seat_tier"`938939 default: seat_tier940941 - `seat_tier: string`942943 - `RBACGroup object`944945 - `type: "rbac_group"`946947 default: rbac_group948949 - `rbac_group_id: string`950951 - `OrganizationService object`952953 - `type: "organization_service"`954955 default: organization_service956957 - `service: string`958959 - `Organization object`960961 - `type: "organization"`962963 default: organization964965 - `Workspace object`966967 Scope selecting one workspace of a Claude Console organization.968969 - `type: "workspace"`970971 Scope type. Always `workspace` for this scope.972973 default: workspace974975 - `workspace_id: string`976977 Tagged ID of the workspace the spend limit applies to.978979 - `spend_limit_id: string`980981### Spend Limit Delete Response982983- `SpendLimitDeleteResponse object`984985 - `type: "spend_limit_deleted"`986987 default: spend_limit_deleted988989 - `id: string`990991## Spend Limits › Increase Requests992993### List Spend Limit Increase Requests994995**GET** `/v1/organizations/spend_limit_increase_requests`996997List spend limit increase requests, most recent first.998999Pending requests include a live `spend_summary` for the requester.1000Requests whose requester is no longer a member are excluded.10011002#### Query parameters10031004- `actor_ids: optional array of string`10051006 Filter by requester, as `user_...` tagged IDs.10071008- `limit: optional number`10091010 default: 20, maximum: 1000, minimum: 110111012- `page: optional string`10131014 Opaque cursor from a previous response's `next_page`.10151016- `status: optional array of "approved" or "denied" or "pending"`10171018 Filter by status. Omit to return all.10191020 - `"approved"`10211022 - `"denied"`10231024 - `"pending"`10251026#### Returns10271028- `data: array of BetaSpendLimitIncreaseRequest`10291030 - `type: "spend_limit_increase_request"`10311032 default: spend_limit_increase_request10331034 - `id: string`10351036 - `actor: object`10371038 A user within the organization. `name` and `email_address` are1039 null when the underlying account is unavailable or has been deleted;1040 `deleted` is true only for deleted accounts.10411042 - `type: "user_actor"`10431044 Actor type. Always `user_actor`.10451046 default: user_actor10471048 - `deleted: boolean`10491050 True only when the underlying account has been deleted.10511052 default: false10531054 - `email_address: string or null`10551056 The user's email address. Null when the account is unavailable or has been deleted.10571058 - `name: string or null`10591060 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.10611062 - `user_id: string`10631064 Tagged ID of the user.10651066 - `created_at: string`10671068 format: date-time10691070 - `period: "daily" or "monthly" or "weekly"`10711072 - `"daily"`10731074 - `"monthly"`10751076 - `"weekly"`10771078 - `resolved_at: string or null`10791080 format: date-time10811082 - `resolved_by: UserActor or ScopedAPIKeyActor or null`10831084 - `UserActor object`10851086 A user within the organization. `name` and `email_address` are1087 null when the underlying account is unavailable or has been deleted;1088 `deleted` is true only for deleted accounts.10891090 - `type: "user_actor"`10911092 Actor type. Always `user_actor`.10931094 default: user_actor10951096 - `deleted: boolean`10971098 True only when the underlying account has been deleted.10991100 default: false11011102 - `email_address: string or null`11031104 The user's email address. Null when the account is unavailable or has been deleted.11051106 - `name: string or null`11071108 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.11091110 - `user_id: string`11111112 Tagged ID of the user.11131114 - `ScopedAPIKeyActor object`11151116 A scoped Admin API key acting on behalf of the organization.11171118 - `type: "scoped_api_key_actor"`11191120 default: scoped_api_key_actor11211122 - `scoped_api_key_id: string`11231124 - `spend_summary: BetaSpendSummary or null`11251126 Per-member effective-limit report row (`GET /spend_limits/effective`).11271128 - `actor: UserActor or ScopedAPIKeyActor`11291130 - `UserActor object`11311132 A user within the organization. `name` and `email_address` are1133 null when the underlying account is unavailable or has been deleted;1134 `deleted` is true only for deleted accounts.11351136 - `type: "user_actor"`11371138 Actor type. Always `user_actor`.11391140 default: user_actor11411142 - `deleted: boolean`11431144 True only when the underlying account has been deleted.11451146 default: false11471148 - `email_address: string or null`11491150 The user's email address. Null when the account is unavailable or has been deleted.11511152 - `name: string or null`11531154 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.11551156 - `user_id: string`11571158 Tagged ID of the user.11591160 - `ScopedAPIKeyActor object`11611162 A scoped Admin API key acting on behalf of the organization.11631164 - `type: "scoped_api_key_actor"`11651166 default: scoped_api_key_actor11671168 - `scoped_api_key_id: string`11691170 - `amount: string or null`11711172 Effective limit amount as a non-negative integer decimal string in the minor unit of `currency` (cents for USD). `null` means no limit applies for this row's `period` — each period resolves independently, so another period may still cap this member.11731174 - `currency: string`11751176 ISO 4217 code of the organization's billing currency; the unit for `amount` and `period_to_date_spend`.11771178 - `period: "daily" or "monthly" or "weekly"`11791180 Period this row's effective limit and spend are reported for.11811182 - `"daily"`11831184 - `"monthly"`11851186 - `"weekly"`11871188 - `period_to_date_spend: string`11891190 The member's spend so far in the current period, as a non-negative decimal string in the minor unit of `currency` (cents for USD). May carry fractional minor units up to three decimal places (e.g. `"12050.5"`) — metered usage is not rounded to whole cents. Reads as `"0"` when the spend reading is temporarily unavailable.11911192 - `scope: User or SeatTier or RBACGroup or 3 more`11931194 - `User object`11951196 Scope selecting a single member of the organization.11971198 - `type: "user"`11991200 Scope type. Always `user` for this scope.12011202 default: user12031204 - `user_id: string`12051206 Tagged ID of the member the spend limit applies to.12071208 - `SeatTier object`12091210 - `type: "seat_tier"`12111212 default: seat_tier12131214 - `seat_tier: string`12151216 - `RBACGroup object`12171218 - `type: "rbac_group"`12191220 default: rbac_group12211222 - `rbac_group_id: string`12231224 - `OrganizationService object`12251226 - `type: "organization_service"`12271228 default: organization_service12291230 - `service: string`12311232 - `Organization object`12331234 - `type: "organization"`12351236 default: organization12371238 - `Workspace object`12391240 Scope selecting one workspace of a Claude Console organization.12411242 - `type: "workspace"`12431244 Scope type. Always `workspace` for this scope.12451246 default: workspace12471248 - `workspace_id: string`12491250 Tagged ID of the workspace the spend limit applies to.12511252 - `source: User or SeatTier or RBACGroup or 3 more`12531254 - `User object`12551256 Scope selecting a single member of the organization.12571258 - `type: "user"`12591260 Scope type. Always `user` for this scope.12611262 default: user12631264 - `user_id: string`12651266 Tagged ID of the member the spend limit applies to.12671268 - `SeatTier object`12691270 - `type: "seat_tier"`12711272 default: seat_tier12731274 - `seat_tier: string`12751276 - `RBACGroup object`12771278 - `type: "rbac_group"`12791280 default: rbac_group12811282 - `rbac_group_id: string`12831284 - `OrganizationService object`12851286 - `type: "organization_service"`12871288 default: organization_service12891290 - `service: string`12911292 - `Organization object`12931294 - `type: "organization"`12951296 default: organization12971298 - `Workspace object`12991300 Scope selecting one workspace of a Claude Console organization.13011302 - `type: "workspace"`13031304 Scope type. Always `workspace` for this scope.13051306 default: workspace13071308 - `workspace_id: string`13091310 Tagged ID of the workspace the spend limit applies to.13111312 - `spend_limit_id: string`13131314 - `status: "approved" or "denied" or "pending"`13151316 - `"approved"`13171318 - `"denied"`13191320 - `"pending"`13211322- `next_page: string or null`13231324#### Example13251326```bash1327curl https://api.anthropic.com/v1/organizations/spend_limit_increase_requests \1328 -H 'anthropic-version: 2023-06-01' \1329 -H "X-Api-Key: $ANTHROPIC_API_KEY"1330```13311332##### Response (200)13331334```json1335{1336 "data": [1337 {1338 "id": "id",1339 "actor": {1340 "deleted": true,1341 "email_address": "email_address",1342 "name": "name",1343 "type": "user_actor",1344 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"1345 },1346 "created_at": "2019-12-27T18:11:19.117Z",1347 "period": "monthly",1348 "resolved_at": "2019-12-27T18:11:19.117Z",1349 "resolved_by": {1350 "deleted": true,1351 "email_address": "email_address",1352 "name": "name",1353 "type": "user_actor",1354 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"1355 },1356 "spend_summary": {1357 "actor": {1358 "deleted": true,1359 "email_address": "email_address",1360 "name": "name",1361 "type": "user_actor",1362 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"1363 },1364 "amount": "50000",1365 "currency": "USD",1366 "period": "monthly",1367 "period_to_date_spend": "12050.5",1368 "scope": {1369 "type": "user",1370 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"1371 },1372 "source": {1373 "type": "user",1374 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"1375 },1376 "spend_limit_id": "spend_limit_id"1377 },1378 "status": "approved",1379 "type": "spend_limit_increase_request"1380 }1381 ],1382 "next_page": "next_page"1383}1384```13851386### Get Spend Limit Increase Request13871388**GET** `/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}`13891390Retrieve a spend limit increase request.13911392While `pending`, the response includes a live `spend_summary` for the1393requester at the request's period.13941395#### Path parameters13961397- `spend_limit_increase_request_id: string`13981399 ID of the spend limit increase request.14001401#### Returns14021403- `BetaSpendLimitIncreaseRequest object`14041405 - `type: "spend_limit_increase_request"`14061407 default: spend_limit_increase_request14081409 - `id: string`14101411 - `actor: object`14121413 A user within the organization. `name` and `email_address` are1414 null when the underlying account is unavailable or has been deleted;1415 `deleted` is true only for deleted accounts.14161417 - `type: "user_actor"`14181419 Actor type. Always `user_actor`.14201421 default: user_actor14221423 - `deleted: boolean`14241425 True only when the underlying account has been deleted.14261427 default: false14281429 - `email_address: string or null`14301431 The user's email address. Null when the account is unavailable or has been deleted.14321433 - `name: string or null`14341435 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.14361437 - `user_id: string`14381439 Tagged ID of the user.14401441 - `created_at: string`14421443 format: date-time14441445 - `period: "daily" or "monthly" or "weekly"`14461447 - `"daily"`14481449 - `"monthly"`14501451 - `"weekly"`14521453 - `resolved_at: string or null`14541455 format: date-time14561457 - `resolved_by: UserActor or ScopedAPIKeyActor or null`14581459 - `UserActor object`14601461 A user within the organization. `name` and `email_address` are1462 null when the underlying account is unavailable or has been deleted;1463 `deleted` is true only for deleted accounts.14641465 - `type: "user_actor"`14661467 Actor type. Always `user_actor`.14681469 default: user_actor14701471 - `deleted: boolean`14721473 True only when the underlying account has been deleted.14741475 default: false14761477 - `email_address: string or null`14781479 The user's email address. Null when the account is unavailable or has been deleted.14801481 - `name: string or null`14821483 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.14841485 - `user_id: string`14861487 Tagged ID of the user.14881489 - `ScopedAPIKeyActor object`14901491 A scoped Admin API key acting on behalf of the organization.14921493 - `type: "scoped_api_key_actor"`14941495 default: scoped_api_key_actor14961497 - `scoped_api_key_id: string`14981499 - `spend_summary: BetaSpendSummary or null`15001501 Per-member effective-limit report row (`GET /spend_limits/effective`).15021503 - `actor: UserActor or ScopedAPIKeyActor`15041505 - `UserActor object`15061507 A user within the organization. `name` and `email_address` are1508 null when the underlying account is unavailable or has been deleted;1509 `deleted` is true only for deleted accounts.15101511 - `type: "user_actor"`15121513 Actor type. Always `user_actor`.15141515 default: user_actor15161517 - `deleted: boolean`15181519 True only when the underlying account has been deleted.15201521 default: false15221523 - `email_address: string or null`15241525 The user's email address. Null when the account is unavailable or has been deleted.15261527 - `name: string or null`15281529 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.15301531 - `user_id: string`15321533 Tagged ID of the user.15341535 - `ScopedAPIKeyActor object`15361537 A scoped Admin API key acting on behalf of the organization.15381539 - `type: "scoped_api_key_actor"`15401541 default: scoped_api_key_actor15421543 - `scoped_api_key_id: string`15441545 - `amount: string or null`15461547 Effective limit amount as a non-negative integer decimal string in the minor unit of `currency` (cents for USD). `null` means no limit applies for this row's `period` — each period resolves independently, so another period may still cap this member.15481549 - `currency: string`15501551 ISO 4217 code of the organization's billing currency; the unit for `amount` and `period_to_date_spend`.15521553 - `period: "daily" or "monthly" or "weekly"`15541555 Period this row's effective limit and spend are reported for.15561557 - `"daily"`15581559 - `"monthly"`15601561 - `"weekly"`15621563 - `period_to_date_spend: string`15641565 The member's spend so far in the current period, as a non-negative decimal string in the minor unit of `currency` (cents for USD). May carry fractional minor units up to three decimal places (e.g. `"12050.5"`) — metered usage is not rounded to whole cents. Reads as `"0"` when the spend reading is temporarily unavailable.15661567 - `scope: User or SeatTier or RBACGroup or 3 more`15681569 - `User object`15701571 Scope selecting a single member of the organization.15721573 - `type: "user"`15741575 Scope type. Always `user` for this scope.15761577 default: user15781579 - `user_id: string`15801581 Tagged ID of the member the spend limit applies to.15821583 - `SeatTier object`15841585 - `type: "seat_tier"`15861587 default: seat_tier15881589 - `seat_tier: string`15901591 - `RBACGroup object`15921593 - `type: "rbac_group"`15941595 default: rbac_group15961597 - `rbac_group_id: string`15981599 - `OrganizationService object`16001601 - `type: "organization_service"`16021603 default: organization_service16041605 - `service: string`16061607 - `Organization object`16081609 - `type: "organization"`16101611 default: organization16121613 - `Workspace object`16141615 Scope selecting one workspace of a Claude Console organization.16161617 - `type: "workspace"`16181619 Scope type. Always `workspace` for this scope.16201621 default: workspace16221623 - `workspace_id: string`16241625 Tagged ID of the workspace the spend limit applies to.16261627 - `source: User or SeatTier or RBACGroup or 3 more`16281629 - `User object`16301631 Scope selecting a single member of the organization.16321633 - `type: "user"`16341635 Scope type. Always `user` for this scope.16361637 default: user16381639 - `user_id: string`16401641 Tagged ID of the member the spend limit applies to.16421643 - `SeatTier object`16441645 - `type: "seat_tier"`16461647 default: seat_tier16481649 - `seat_tier: string`16501651 - `RBACGroup object`16521653 - `type: "rbac_group"`16541655 default: rbac_group16561657 - `rbac_group_id: string`16581659 - `OrganizationService object`16601661 - `type: "organization_service"`16621663 default: organization_service16641665 - `service: string`16661667 - `Organization object`16681669 - `type: "organization"`16701671 default: organization16721673 - `Workspace object`16741675 Scope selecting one workspace of a Claude Console organization.16761677 - `type: "workspace"`16781679 Scope type. Always `workspace` for this scope.16801681 default: workspace16821683 - `workspace_id: string`16841685 Tagged ID of the workspace the spend limit applies to.16861687 - `spend_limit_id: string`16881689 - `status: "approved" or "denied" or "pending"`16901691 - `"approved"`16921693 - `"denied"`16941695 - `"pending"`16961697#### Example16981699```bash1700curl https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/$SPEND_LIMIT_INCREASE_REQUEST_ID \1701 -H 'anthropic-version: 2023-06-01' \1702 -H "X-Api-Key: $ANTHROPIC_API_KEY"1703```17041705##### Response (200)17061707```json1708{1709 "id": "id",1710 "actor": {1711 "deleted": true,1712 "email_address": "email_address",1713 "name": "name",1714 "type": "user_actor",1715 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"1716 },1717 "created_at": "2019-12-27T18:11:19.117Z",1718 "period": "monthly",1719 "resolved_at": "2019-12-27T18:11:19.117Z",1720 "resolved_by": {1721 "deleted": true,1722 "email_address": "email_address",1723 "name": "name",1724 "type": "user_actor",1725 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"1726 },1727 "spend_summary": {1728 "actor": {1729 "deleted": true,1730 "email_address": "email_address",1731 "name": "name",1732 "type": "user_actor",1733 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"1734 },1735 "amount": "50000",1736 "currency": "USD",1737 "period": "monthly",1738 "period_to_date_spend": "12050.5",1739 "scope": {1740 "type": "user",1741 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"1742 },1743 "source": {1744 "type": "user",1745 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"1746 },1747 "spend_limit_id": "spend_limit_id"1748 },1749 "status": "approved",1750 "type": "spend_limit_increase_request"1751}1752```17531754### Approve Spend Limit Increase Request17551756**POST** `/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve`17571758Approve a pending spend limit increase request.17591760Writes a per-user spend limit at `amount` for the requester and1761transitions the request to `approved`. `period` defaults to the period1762the member was blocked on. Anthropic emails the requester unless1763`suppress_notification` is set.17641765#### Path parameters17661767- `spend_limit_increase_request_id: string`17681769 ID of the spend limit increase request.17701771#### Body parameters17721773- `amount: string`17741775 New per-user spend limit as a non-negative integer decimal string (minor units).17761777- `period: optional "daily" or "monthly" or "weekly" or null`17781779 - `"daily"`17801781 - `"monthly"`17821783 - `"weekly"`17841785- `suppress_notification: optional boolean`17861787#### Returns17881789- `type: "spend_limit_increase_request"`17901791 default: spend_limit_increase_request17921793- `id: string`17941795- `actor: object`17961797 A user within the organization. `name` and `email_address` are1798 null when the underlying account is unavailable or has been deleted;1799 `deleted` is true only for deleted accounts.18001801 - `type: "user_actor"`18021803 Actor type. Always `user_actor`.18041805 default: user_actor18061807 - `deleted: boolean`18081809 True only when the underlying account has been deleted.18101811 default: false18121813 - `email_address: string or null`18141815 The user's email address. Null when the account is unavailable or has been deleted.18161817 - `name: string or null`18181819 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.18201821 - `user_id: string`18221823 Tagged ID of the user.18241825- `created_at: string`18261827 format: date-time18281829- `period: "daily" or "monthly" or "weekly"`18301831 - `"daily"`18321833 - `"monthly"`18341835 - `"weekly"`18361837- `resolved_at: string or null`18381839 format: date-time18401841- `resolved_by: UserActor or ScopedAPIKeyActor or null`18421843 - `UserActor object`18441845 A user within the organization. `name` and `email_address` are1846 null when the underlying account is unavailable or has been deleted;1847 `deleted` is true only for deleted accounts.18481849 - `type: "user_actor"`18501851 Actor type. Always `user_actor`.18521853 default: user_actor18541855 - `deleted: boolean`18561857 True only when the underlying account has been deleted.18581859 default: false18601861 - `email_address: string or null`18621863 The user's email address. Null when the account is unavailable or has been deleted.18641865 - `name: string or null`18661867 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.18681869 - `user_id: string`18701871 Tagged ID of the user.18721873 - `ScopedAPIKeyActor object`18741875 A scoped Admin API key acting on behalf of the organization.18761877 - `type: "scoped_api_key_actor"`18781879 default: scoped_api_key_actor18801881 - `scoped_api_key_id: string`18821883- `spend_limit: BetaSpendLimit`18841885 A configured spend limit: a cap on metered spend for one scope and period.18861887 - `type: "spend_limit"`18881889 Object type. Always `spend_limit`.18901891 default: spend_limit18921893 - `id: string`18941895 Unique tagged ID of the spend limit (`spl_...`).18961897 - `amount: string or null`18981899 Limit amount as a non-negative integer decimal string in the minor unit of `currency` (cents for USD): "50000" is $500.00. `null` means no numeric cap is configured at this scope — see the effective report for whether a limit applies.19001901 - `created_at: string`19021903 RFC 3339 datetime at which the spend limit was created.19041905 format: date-time19061907 - `currency: string`19081909 ISO 4217 code of the organization's billing currency; the unit for `amount`.19101911 - `period: "daily" or "monthly" or "weekly"`19121913 Length of the window the limit resets over. `amount` caps spend within each period.19141915 - `"daily"`19161917 - `"monthly"`19181919 - `"weekly"`19201921 - `scope: User or SeatTier or RBACGroup or 3 more`19221923 What the limit applies to. A tagged union on `type`; each variant carries the identifier for its scope.19241925 - `User object`19261927 Scope selecting a single member of the organization.19281929 - `type: "user"`19301931 Scope type. Always `user` for this scope.19321933 default: user19341935 - `user_id: string`19361937 Tagged ID of the member the spend limit applies to.19381939 - `SeatTier object`19401941 - `type: "seat_tier"`19421943 default: seat_tier19441945 - `seat_tier: string`19461947 - `RBACGroup object`19481949 - `type: "rbac_group"`19501951 default: rbac_group19521953 - `rbac_group_id: string`19541955 - `OrganizationService object`19561957 - `type: "organization_service"`19581959 default: organization_service19601961 - `service: string`19621963 - `Organization object`19641965 - `type: "organization"`19661967 default: organization19681969 - `Workspace object`19701971 Scope selecting one workspace of a Claude Console organization.19721973 - `type: "workspace"`19741975 Scope type. Always `workspace` for this scope.19761977 default: workspace19781979 - `workspace_id: string`19801981 Tagged ID of the workspace the spend limit applies to.19821983 - `updated_at: string`19841985 RFC 3339 datetime at which the spend limit was last modified.19861987 format: date-time19881989- `spend_summary: BetaSpendSummary or null`19901991 Per-member effective-limit report row (`GET /spend_limits/effective`).19921993 - `actor: UserActor or ScopedAPIKeyActor`19941995 - `UserActor object`19961997 A user within the organization. `name` and `email_address` are1998 null when the underlying account is unavailable or has been deleted;1999 `deleted` is true only for deleted accounts.20002001 - `type: "user_actor"`20022003 Actor type. Always `user_actor`.20042005 default: user_actor20062007 - `deleted: boolean`20082009 True only when the underlying account has been deleted.20102011 default: false20122013 - `email_address: string or null`20142015 The user's email address. Null when the account is unavailable or has been deleted.20162017 - `name: string or null`20182019 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.20202021 - `user_id: string`20222023 Tagged ID of the user.20242025 - `ScopedAPIKeyActor object`20262027 A scoped Admin API key acting on behalf of the organization.20282029 - `type: "scoped_api_key_actor"`20302031 default: scoped_api_key_actor20322033 - `scoped_api_key_id: string`20342035 - `amount: string or null`20362037 Effective limit amount as a non-negative integer decimal string in the minor unit of `currency` (cents for USD). `null` means no limit applies for this row's `period` — each period resolves independently, so another period may still cap this member.20382039 - `currency: string`20402041 ISO 4217 code of the organization's billing currency; the unit for `amount` and `period_to_date_spend`.20422043 - `period: "daily" or "monthly" or "weekly"`20442045 Period this row's effective limit and spend are reported for.20462047 - `"daily"`20482049 - `"monthly"`20502051 - `"weekly"`20522053 - `period_to_date_spend: string`20542055 The member's spend so far in the current period, as a non-negative decimal string in the minor unit of `currency` (cents for USD). May carry fractional minor units up to three decimal places (e.g. `"12050.5"`) — metered usage is not rounded to whole cents. Reads as `"0"` when the spend reading is temporarily unavailable.20562057 - `scope: User or SeatTier or RBACGroup or 3 more`20582059 - `User object`20602061 Scope selecting a single member of the organization.20622063 - `type: "user"`20642065 Scope type. Always `user` for this scope.20662067 default: user20682069 - `user_id: string`20702071 Tagged ID of the member the spend limit applies to.20722073 - `SeatTier object`20742075 - `type: "seat_tier"`20762077 default: seat_tier20782079 - `seat_tier: string`20802081 - `RBACGroup object`20822083 - `type: "rbac_group"`20842085 default: rbac_group20862087 - `rbac_group_id: string`20882089 - `OrganizationService object`20902091 - `type: "organization_service"`20922093 default: organization_service20942095 - `service: string`20962097 - `Organization object`20982099 - `type: "organization"`21002101 default: organization21022103 - `Workspace object`21042105 Scope selecting one workspace of a Claude Console organization.21062107 - `type: "workspace"`21082109 Scope type. Always `workspace` for this scope.21102111 default: workspace21122113 - `workspace_id: string`21142115 Tagged ID of the workspace the spend limit applies to.21162117 - `source: User or SeatTier or RBACGroup or 3 more`21182119 - `User object`21202121 Scope selecting a single member of the organization.21222123 - `type: "user"`21242125 Scope type. Always `user` for this scope.21262127 default: user21282129 - `user_id: string`21302131 Tagged ID of the member the spend limit applies to.21322133 - `SeatTier object`21342135 - `type: "seat_tier"`21362137 default: seat_tier21382139 - `seat_tier: string`21402141 - `RBACGroup object`21422143 - `type: "rbac_group"`21442145 default: rbac_group21462147 - `rbac_group_id: string`21482149 - `OrganizationService object`21502151 - `type: "organization_service"`21522153 default: organization_service21542155 - `service: string`21562157 - `Organization object`21582159 - `type: "organization"`21602161 default: organization21622163 - `Workspace object`21642165 Scope selecting one workspace of a Claude Console organization.21662167 - `type: "workspace"`21682169 Scope type. Always `workspace` for this scope.21702171 default: workspace21722173 - `workspace_id: string`21742175 Tagged ID of the workspace the spend limit applies to.21762177 - `spend_limit_id: string`21782179- `status: "approved" or "denied" or "pending"`21802181 - `"approved"`21822183 - `"denied"`21842185 - `"pending"`21862187#### Example21882189```bash2190curl https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/$SPEND_LIMIT_INCREASE_REQUEST_ID/approve \2191 -H 'Content-Type: application/json' \2192 -H 'anthropic-version: 2023-06-01' \2193 -H "X-Api-Key: $ANTHROPIC_API_KEY" \2194 -d '{2195 "amount": "50000",2196 "period": "monthly"2197 }'2198```21992200##### Response (200)22012202```json2203{2204 "id": "id",2205 "actor": {2206 "deleted": true,2207 "email_address": "email_address",2208 "name": "name",2209 "type": "user_actor",2210 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"2211 },2212 "created_at": "2019-12-27T18:11:19.117Z",2213 "period": "monthly",2214 "resolved_at": "2019-12-27T18:11:19.117Z",2215 "resolved_by": {2216 "deleted": true,2217 "email_address": "email_address",2218 "name": "name",2219 "type": "user_actor",2220 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"2221 },2222 "spend_limit": {2223 "id": "id",2224 "amount": "50000",2225 "created_at": "2019-12-27T18:11:19.117Z",2226 "currency": "USD",2227 "period": "monthly",2228 "scope": {2229 "type": "user",2230 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"2231 },2232 "type": "spend_limit",2233 "updated_at": "2019-12-27T18:11:19.117Z"2234 },2235 "spend_summary": {2236 "actor": {2237 "deleted": true,2238 "email_address": "email_address",2239 "name": "name",2240 "type": "user_actor",2241 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"2242 },2243 "amount": "50000",2244 "currency": "USD",2245 "period": "monthly",2246 "period_to_date_spend": "12050.5",2247 "scope": {2248 "type": "user",2249 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"2250 },2251 "source": {2252 "type": "user",2253 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"2254 },2255 "spend_limit_id": "spend_limit_id"2256 },2257 "status": "approved",2258 "type": "spend_limit_increase_request"2259}2260```22612262### Deny Spend Limit Increase Request22632264**POST** `/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny`22652266Deny a pending spend limit increase request.22672268Idempotent on `denied`; denying an already-`approved` request returns2269400. Anthropic emails the requester unless `suppress_notification` is set.22702271#### Path parameters22722273- `spend_limit_increase_request_id: string`22742275 ID of the spend limit increase request.22762277#### Body parameters22782279- `suppress_notification: optional boolean`22802281#### Returns22822283- `BetaSpendLimitIncreaseRequest object`22842285 - `type: "spend_limit_increase_request"`22862287 default: spend_limit_increase_request22882289 - `id: string`22902291 - `actor: object`22922293 A user within the organization. `name` and `email_address` are2294 null when the underlying account is unavailable or has been deleted;2295 `deleted` is true only for deleted accounts.22962297 - `type: "user_actor"`22982299 Actor type. Always `user_actor`.23002301 default: user_actor23022303 - `deleted: boolean`23042305 True only when the underlying account has been deleted.23062307 default: false23082309 - `email_address: string or null`23102311 The user's email address. Null when the account is unavailable or has been deleted.23122313 - `name: string or null`23142315 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.23162317 - `user_id: string`23182319 Tagged ID of the user.23202321 - `created_at: string`23222323 format: date-time23242325 - `period: "daily" or "monthly" or "weekly"`23262327 - `"daily"`23282329 - `"monthly"`23302331 - `"weekly"`23322333 - `resolved_at: string or null`23342335 format: date-time23362337 - `resolved_by: UserActor or ScopedAPIKeyActor or null`23382339 - `UserActor object`23402341 A user within the organization. `name` and `email_address` are2342 null when the underlying account is unavailable or has been deleted;2343 `deleted` is true only for deleted accounts.23442345 - `type: "user_actor"`23462347 Actor type. Always `user_actor`.23482349 default: user_actor23502351 - `deleted: boolean`23522353 True only when the underlying account has been deleted.23542355 default: false23562357 - `email_address: string or null`23582359 The user's email address. Null when the account is unavailable or has been deleted.23602361 - `name: string or null`23622363 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.23642365 - `user_id: string`23662367 Tagged ID of the user.23682369 - `ScopedAPIKeyActor object`23702371 A scoped Admin API key acting on behalf of the organization.23722373 - `type: "scoped_api_key_actor"`23742375 default: scoped_api_key_actor23762377 - `scoped_api_key_id: string`23782379 - `spend_summary: BetaSpendSummary or null`23802381 Per-member effective-limit report row (`GET /spend_limits/effective`).23822383 - `actor: UserActor or ScopedAPIKeyActor`23842385 - `UserActor object`23862387 A user within the organization. `name` and `email_address` are2388 null when the underlying account is unavailable or has been deleted;2389 `deleted` is true only for deleted accounts.23902391 - `type: "user_actor"`23922393 Actor type. Always `user_actor`.23942395 default: user_actor23962397 - `deleted: boolean`23982399 True only when the underlying account has been deleted.24002401 default: false24022403 - `email_address: string or null`24042405 The user's email address. Null when the account is unavailable or has been deleted.24062407 - `name: string or null`24082409 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.24102411 - `user_id: string`24122413 Tagged ID of the user.24142415 - `ScopedAPIKeyActor object`24162417 A scoped Admin API key acting on behalf of the organization.24182419 - `type: "scoped_api_key_actor"`24202421 default: scoped_api_key_actor24222423 - `scoped_api_key_id: string`24242425 - `amount: string or null`24262427 Effective limit amount as a non-negative integer decimal string in the minor unit of `currency` (cents for USD). `null` means no limit applies for this row's `period` — each period resolves independently, so another period may still cap this member.24282429 - `currency: string`24302431 ISO 4217 code of the organization's billing currency; the unit for `amount` and `period_to_date_spend`.24322433 - `period: "daily" or "monthly" or "weekly"`24342435 Period this row's effective limit and spend are reported for.24362437 - `"daily"`24382439 - `"monthly"`24402441 - `"weekly"`24422443 - `period_to_date_spend: string`24442445 The member's spend so far in the current period, as a non-negative decimal string in the minor unit of `currency` (cents for USD). May carry fractional minor units up to three decimal places (e.g. `"12050.5"`) — metered usage is not rounded to whole cents. Reads as `"0"` when the spend reading is temporarily unavailable.24462447 - `scope: User or SeatTier or RBACGroup or 3 more`24482449 - `User object`24502451 Scope selecting a single member of the organization.24522453 - `type: "user"`24542455 Scope type. Always `user` for this scope.24562457 default: user24582459 - `user_id: string`24602461 Tagged ID of the member the spend limit applies to.24622463 - `SeatTier object`24642465 - `type: "seat_tier"`24662467 default: seat_tier24682469 - `seat_tier: string`24702471 - `RBACGroup object`24722473 - `type: "rbac_group"`24742475 default: rbac_group24762477 - `rbac_group_id: string`24782479 - `OrganizationService object`24802481 - `type: "organization_service"`24822483 default: organization_service24842485 - `service: string`24862487 - `Organization object`24882489 - `type: "organization"`24902491 default: organization24922493 - `Workspace object`24942495 Scope selecting one workspace of a Claude Console organization.24962497 - `type: "workspace"`24982499 Scope type. Always `workspace` for this scope.25002501 default: workspace25022503 - `workspace_id: string`25042505 Tagged ID of the workspace the spend limit applies to.25062507 - `source: User or SeatTier or RBACGroup or 3 more`25082509 - `User object`25102511 Scope selecting a single member of the organization.25122513 - `type: "user"`25142515 Scope type. Always `user` for this scope.25162517 default: user25182519 - `user_id: string`25202521 Tagged ID of the member the spend limit applies to.25222523 - `SeatTier object`25242525 - `type: "seat_tier"`25262527 default: seat_tier25282529 - `seat_tier: string`25302531 - `RBACGroup object`25322533 - `type: "rbac_group"`25342535 default: rbac_group25362537 - `rbac_group_id: string`25382539 - `OrganizationService object`25402541 - `type: "organization_service"`25422543 default: organization_service25442545 - `service: string`25462547 - `Organization object`25482549 - `type: "organization"`25502551 default: organization25522553 - `Workspace object`25542555 Scope selecting one workspace of a Claude Console organization.25562557 - `type: "workspace"`25582559 Scope type. Always `workspace` for this scope.25602561 default: workspace25622563 - `workspace_id: string`25642565 Tagged ID of the workspace the spend limit applies to.25662567 - `spend_limit_id: string`25682569 - `status: "approved" or "denied" or "pending"`25702571 - `"approved"`25722573 - `"denied"`25742575 - `"pending"`25762577#### Example25782579```bash2580curl https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/$SPEND_LIMIT_INCREASE_REQUEST_ID/deny \2581 -H 'Content-Type: application/json' \2582 -H 'anthropic-version: 2023-06-01' \2583 -H "X-Api-Key: $ANTHROPIC_API_KEY" \2584 -d '{}'2585```25862587##### Response (200)25882589```json2590{2591 "id": "id",2592 "actor": {2593 "deleted": true,2594 "email_address": "email_address",2595 "name": "name",2596 "type": "user_actor",2597 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"2598 },2599 "created_at": "2019-12-27T18:11:19.117Z",2600 "period": "monthly",2601 "resolved_at": "2019-12-27T18:11:19.117Z",2602 "resolved_by": {2603 "deleted": true,2604 "email_address": "email_address",2605 "name": "name",2606 "type": "user_actor",2607 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"2608 },2609 "spend_summary": {2610 "actor": {2611 "deleted": true,2612 "email_address": "email_address",2613 "name": "name",2614 "type": "user_actor",2615 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"2616 },2617 "amount": "50000",2618 "currency": "USD",2619 "period": "monthly",2620 "period_to_date_spend": "12050.5",2621 "scope": {2622 "type": "user",2623 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"2624 },2625 "source": {2626 "type": "user",2627 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"2628 },2629 "spend_limit_id": "spend_limit_id"2630 },2631 "status": "approved",2632 "type": "spend_limit_increase_request"2633}2634```2635