Spend Limits changedapi/organization/spend_limits

A whole new page. There's nothing to diff it against, so here is what it says.

---
title: Spend Limits
url: https://platform.claude.com/docs/en/api/organization/spend_limits
---

# Spend Limits

## Domain types

### Spend Limit

- `SpendLimit object`

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

  - `type: "spend_limit"`

    Object type. Always `spend_limit`.

    default: spend_limit

  - `id: string`

    Unique tagged ID of the spend limit (`spl_...`).

  - `amount: string or null`

    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.

  - `created_at: string`

    RFC 3339 datetime at which the spend limit was created.

    format: date-time

  - `currency: string`

    ISO 4217 code of the organization's billing currency; the unit for `amount`.

  - `is_enabled: boolean`

    Read-only. `false` when extra usage is switched off for this organization (`organization` limit); `amount` is kept and applies again when it's switched back on. Always `true` for other limits.

  - `period: SpendLimitPeriod`

    Length of the window the limit resets over. `amount` caps spend within each period.

    - `"daily"`

    - `"monthly"`

    - `"weekly"`

  - `scope: SpendLimitUserScope or SpendLimitSeatTierScope or SpendLimitRBACGroupScope or 4 more`

    What the limit applies to. A tagged union on `type`; each variant carries the identifier for its scope.

    - `SpendLimitUserScope object`

      Scope selecting a single member of the organization.

      - `type: "user"`

        Scope type. Always `user` for this scope.

        default: user

      - `user_id: string`

        Tagged ID of the member the spend limit applies to.

    - `SpendLimitSeatTierScope object`

      - `type: "seat_tier"`

        default: seat_tier

      - `seat_tier: string`

    - `SpendLimitRBACGroupScope object`

      - `type: "rbac_group"`

        default: rbac_group

      - `rbac_group_id: string`

    - `SpendLimitOrganizationServiceScope object`

      - `type: "organization_service"`

        default: organization_service

      - `service: string`

    - `SpendLimitOrganizationScope object`

      - `type: "organization"`

        default: organization

    - `SpendLimitWorkspaceScope object`

      Scope selecting one workspace of a Claude Console organization.

      - `type: "workspace"`

        Scope type. Always `workspace` for this scope.

        default: workspace

      - `workspace_id: string`

        Tagged ID of the workspace the spend limit applies to.

    - `SpendLimitUsageTierScope object`

      Scope of the monthly spend cap Anthropic sets for a Claude Console
      organization from its usage tier, or a higher cap Anthropic granted the
      organization. Read-only; its `created_at` and `updated_at` are the
      organization's creation time, so `amount` can change while `updated_at` stays
      the same.

      - `type: "usage_tier"`

        Scope type. Always `usage_tier` for this scope.

        default: usage_tier

  - `updated_at: string`

    RFC 3339 datetime at which the spend limit was last modified.

    format: date-time

### Spend Limit Organization Scope

- `SpendLimitOrganizationScope object`

  - `type: "organization"`

    default: organization

### Spend Limit Organization Service Scope

- `SpendLimitOrganizationServiceScope object`

  - `type: "organization_service"`

    default: organization_service

  - `service: string`

### Spend Limit Period

- `SpendLimitPeriod = "daily" or "monthly" or "weekly"`

  - `"daily"`

  - `"monthly"`

  - `"weekly"`

### Spend Limit RBAC Group Scope

- `SpendLimitRBACGroupScope object`

  - `type: "rbac_group"`

    default: rbac_group

  - `rbac_group_id: string`

### Spend Limit Scoped API Key Actor

- `SpendLimitScopedAPIKeyActor object`

  A scoped Admin API key acting on behalf of the organization.

  - `type: "scoped_api_key_actor"`

    default: scoped_api_key_actor

  - `scoped_api_key_id: string`

### Spend Limit Seat Tier Scope

- `SpendLimitSeatTierScope object`

  - `type: "seat_tier"`

    default: seat_tier

  - `seat_tier: string`

### Spend Limit Usage Tier Scope

- `SpendLimitUsageTierScope object`

  Scope of the monthly spend cap Anthropic sets for a Claude Console
  organization from its usage tier, or a higher cap Anthropic granted the
  organization. Read-only; its `created_at` and `updated_at` are the
  organization's creation time, so `amount` can change while `updated_at` stays
  the same.

  - `type: "usage_tier"`

    Scope type. Always `usage_tier` for this scope.

    default: usage_tier

### Spend Limit User Actor

- `SpendLimitUserActor object`

  A user within the organization. `name` and `email_address` are
  null when the underlying account is unavailable or has been deleted;
  `deleted` is true only for deleted accounts.

  - `type: "user_actor"`

    Actor type. Always `user_actor`.

    default: user_actor

  - `deleted: boolean`

    True only when the underlying account has been deleted.

    default: false

  - `email_address: string or null`

    The user's email address. Null when the account is unavailable or has been deleted.

  - `name: string or null`

    The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.

  - `user_id: string`

    Tagged ID of the user.

### Spend Limit User Scope

- `SpendLimitUserScope object`

  Scope selecting a single member of the organization.

  - `type: "user"`

    Scope type. Always `user` for this scope.

    default: user

  - `user_id: string`

    Tagged ID of the member the spend limit applies to.

### Spend Limit Workspace Scope

- `SpendLimitWorkspaceScope object`

  Scope selecting one workspace of a Claude Console organization.

  - `type: "workspace"`

    Scope type. Always `workspace` for this scope.

    default: workspace

  - `workspace_id: string`

    Tagged ID of the workspace the spend limit applies to.

### Spend Summary

- `SpendSummary object`

  Per-member effective-limit report row (`GET /spend_limits/effective`).

  - `actor: SpendLimitUserActor or SpendLimitScopedAPIKeyActor`

    - `SpendLimitUserActor object`

      A user within the organization. `name` and `email_address` are
      null when the underlying account is unavailable or has been deleted;
      `deleted` is true only for deleted accounts.

      - `type: "user_actor"`

        Actor type. Always `user_actor`.

        default: user_actor

      - `deleted: boolean`

        True only when the underlying account has been deleted.

        default: false

Cut at 300 lines. The page has the rest.

No line in this hunk matches that.