Claude Platform Docs

Définir les limites de débit d'un espace de travail

$ ant beta:organization:workspaces:rate-limits update
POST/v1/organizations/workspaces/{workspace_id}/rate_limits/{rate_limit_id}

Définit ou efface les surcharges de limites de débit pour un groupe de limites de débit dans un espace de travail.

Seuls les types de limiteurs nommés dans limits changent : une value entière définit la surcharge de ce type et null l'efface. Les types non nommés conservent leur valeur actuelle. Une valeur supérieure à la limite propre de l'organisation est enregistrée, mais la limite de l'organisation s'applique toujours, de sorte que la plus basse des deux est appliquée.

Renvoie l'entrée du groupe ciblé avec cette requête appliquée, sous la forme renvoyée par GET /v1/organizations/workspaces/{workspace_id}/rate_limits. Les modifications prennent effet dans un délai d'environ une heure.

Parameters
--workspace-id: string⁠Path parameter

The ID of the workspace.

--rate-limit-id: string⁠Path parameter

The id of the organization's rate-limit entry to set overrides for.

--limit: array of BetaWorkspaceRateLimitUpdateValue { type, value }

Limits to set or clear. Unspecified limit types are unchanged.

minItems1
maxItems16
Returns
beta_workspace_rate_limit: object{ type: "workspace_rate_limit", group, group_type, 4 more }
type: "workspace_rate_limit"

Object type. Always workspace_rate_limit for workspace rate-limit entries.

group: BetaOrganizationRateLimitModelGroup or BetaOrganizationRateLimitBatchGroup or BetaOrganizationRateLimitTokenCountGroup or 3 more

The rate-limit group this entry's limits apply to. Its type equals group_type.

One of the following:
beta_organization_rate_limit_model_group: object{ type: "model_group", id, display_name }
type: "model_group"

Always model_group: a family of models.

id: string

Opaque identifier of the rate-limit group (for example, rlg_01VPTCmyiu5ZLsWkcxYG2pY8). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.

display_name: string

Human-readable name of the model group (for example, Claude Sonnet 4.x). For display only; it may change.

beta_organization_rate_limit_batch_group: object{ type: "batch", id }
type: "batch"

Always batch: the Message Batches API.

id: string

Opaque identifier of the rate-limit group (for example, rlg_01VPTCmyiu5ZLsWkcxYG2pY8). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.

beta_organization_rate_limit_token_count_group: object{ type: "token_count", id }
type: "token_count"

Always token_count: the Token Count API.

id: string

Opaque identifier of the rate-limit group (for example, rlg_01VPTCmyiu5ZLsWkcxYG2pY8). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.

beta_organization_rate_limit_files_group: object{ type: "files", id }
type: "files"

Always files: the Files API.

id: string

Opaque identifier of the rate-limit group (for example, rlg_01VPTCmyiu5ZLsWkcxYG2pY8). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.

beta_organization_rate_limit_skills_group: object{ type: "skills", id }
type: "skills"

Always skills: the Skills API.

id: string

Opaque identifier of the rate-limit group (for example, rlg_01VPTCmyiu5ZLsWkcxYG2pY8). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.

beta_organization_rate_limit_web_search_group: object{ type: "web_search", id }
type: "web_search"

Always web_search: the Messages API web search tool.

id: string

Opaque identifier of the rate-limit group (for example, rlg_01VPTCmyiu5ZLsWkcxYG2pY8). It is the same in every organization and never changes, unlike the entry's own identifier, which differs per organization.

limits: array of BetaWorkspaceRateLimitValue { type, org_limit, source, value }

The workspace's limiter values for this group. By default only the limiter types with a workspace-level override are listed. With include_inherited set to true, the limiter types the workspace inherits from the organization are listed too, each marked by source.

type: string

The limiter type (for example, requests_per_minute or input_tokens_per_minute).

org_limit: number

The organization-level value for the same limiter type, for reference. null when the organization has no limit configured for this limiter type.

source: BetaWorkspaceRateLimitWorkspaceSource or BetaWorkspaceRateLimitOrganizationSource

Where value comes from. organization values are listed only when include_inherited is true, and then value equals org_limit.

One of the following:
beta_workspace_rate_limit_workspace_source: object{ type: "workspace" }
type: "workspace"

Always workspace: a workspace-level override is stored.

beta_workspace_rate_limit_organization_source: object{ type: "organization" }
type: "organization"

Always organization: no workspace-level override is stored, so the organization's value applies.

value: number

The workspace's value for this limiter type: the workspace-level override when source.type is workspace, otherwise the organization's value.

models: array of string

Model names this entry's limits apply to, including aliases. null when group_type is not "model_group".

rate_limit_id: string

The id of the organization's RateLimit entry this entry applies to.

workspace_id: string

ID of the Workspace this entry applies to.

group_type: "batch" or "files" or "model_group" or 3 more⁠Deprecated

Deprecated: use group.type instead. The kind of rate-limit group this entry represents. model_group entries apply to a family of models (listed in models); other values apply to an API-surface category and have models set to null. Always equal to group.type.

Use `group.type` instead. `group_type` is still returned and always equals `group.type`.
One of the following:
"batch"
"files"
"model_group"
"skills"
"token_count"
"web_search"
Définir les limites de débit d'un espace de travail
ant beta:organization:workspaces:rate-limits update \
  --api-key my-anthropic-api-key \
  --workspace-id workspace_id \
  --rate-limit-id rate_limit_id \
  --limit '{type: fast_itpmca, value: 0}'
Returns Examples
Response 200
{
  "group": {
    "id": "id",
    "display_name": "display_name",
    "type": "model_group"
  },
  "group_type": "batch",
  "limits": [
    {
      "org_limit": 0,
      "source": {
        "type": "workspace"
      },
      "type": "type",
      "value": 0
    }
  ],
  "models": [
    "string"
  ],
  "rate_limit_id": "rate_limit_id",
  "type": "workspace_rate_limit",
  "workspace_id": "workspace_id"
}