Rate Limits changedapi/beta/organization/workspaces/rate_limits
Nearest release: v2.1.306, published under an hour before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+328added
Lines−0removed
From line
275
where the diff opens
First seen
26 Aug 2026
this site's first read of the page
Recorded edits9to this page, all time
## Set Workspace Rate Limits ### Body parameters ### Beta Workspace Rate Limit Type ### Beta Workspace Rate Limit Update Value
The whole hunk
from line 275, old and new numbered
/
from line 275
275275}
276276```
277277
278## Set Workspace Rate Limits
279
280**POST** `/v1/organizations/workspaces/{workspace_id}/rate_limits/{rate_limit_id}`
281
282Set or clear rate-limit overrides for one rate-limit group in a workspace.
283
284Only the limiter types named in `limits` change: an integer `value` sets
285that type's override and `null` clears it. Types not named keep their
286current value. A value above the organization's own limit is stored, but
287the organization limit still applies, so the lower of the two is
288enforced.
289
290Returns the targeted group's entry with this request applied, in the shape
291`GET /v1/organizations/workspaces/{workspace_id}/rate_limits` returns.
292Changes take effect within about an hour.
293
294### Path parameters
295
296- `workspace_id: string`
297
298 The ID of the workspace.
299
300- `rate_limit_id: string`
301
302 The `id` of the organization's rate-limit entry to set overrides for.
303
304### Headers
305
306- `"anthropic-version": optional string`
307
308 The version of the Claude API you want to use.
309
310 Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http).
311
312### Body parameters
313
314- `limits: array of BetaWorkspaceRateLimitUpdateValue`
315
316 Limits to set or clear. Unspecified limit types are unchanged.
317
318 minItems: 1, maxItems: 16
319
320 - `type: BetaWorkspaceRateLimitType`
321
322 Rate limiter type.
323
324 - `"fast_itpmca"`
325
326 - `"fast_otpm"`
327
328 - `"input_tokens_per_minute"`
329
330 - `"input_tokens_per_minute_cache_aware"`
331
332 - `"output_tokens_per_minute"`
333
334 - `"requests_per_minute"`
335
336 - `"tokens_per_day"`
337
338 - `"tokens_per_minute"`
339
340 - `"tool_uses_per_second"`
341
342 - `value: number or null`
343
344 New limit value. Set to null to clear the workspace override and fall back to the organization limit.
345
346 minimum: 0, maximum: 9007199254740991
347
348### Returns
349
350- `BetaWorkspaceRateLimit object`
351
352 - `type: "workspace_rate_limit"`
353
354 Object type. Always `workspace_rate_limit` for workspace rate-limit entries.
355
356 default: workspace_rate_limit
357
358 - `group: BetaOrganizationRateLimitModelGroup or BetaOrganizationRateLimitBatchGroup or BetaOrganizationRateLimitTokenCountGroup or 3 more`
359
360 The rate-limit group this entry's limits apply to. Its `type` equals `group_type`.
361
362 - `BetaOrganizationRateLimitModelGroup object`
363
364 - `type: "model_group"`
365
366 Always `model_group`: a family of models.
367
368 default: model_group
369
370 - `id: string`
371
372 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.
373
374 - `display_name: string`
375
376 Human-readable name of the model group (for example, `Claude Sonnet 4.x`). For display only; it may change.
377
378 - `BetaOrganizationRateLimitBatchGroup object`
379
380 - `type: "batch"`
381
382 Always `batch`: the Message Batches API.
383
384 default: batch
385
386 - `id: string`
387
388 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.
389
390 - `BetaOrganizationRateLimitTokenCountGroup object`
391
392 - `type: "token_count"`
393
394 Always `token_count`: the Token Count API.
395
396 default: token_count
397
398 - `id: string`
399
400 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.
401
402 - `BetaOrganizationRateLimitFilesGroup object`
403
404 - `type: "files"`
405
406 Always `files`: the Files API.
407
408 default: files
409
410 - `id: string`
411
412 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.
413
414 - `BetaOrganizationRateLimitSkillsGroup object`
415
416 - `type: "skills"`
417
418 Always `skills`: the Skills API.
419
420 default: skills
421
422 - `id: string`
423
424 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.
425
426 - `BetaOrganizationRateLimitWebSearchGroup object`
427
428 - `type: "web_search"`
429
430 Always `web_search`: the Messages API web search tool.
431
432 default: web_search
433
434 - `id: string`
435
436 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.
437
438 - `limits: array of BetaWorkspaceRateLimitValue`
439
440 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`.
441
442 - `type: string`
443
444 The limiter type (for example, `requests_per_minute` or `input_tokens_per_minute`).
445
446 - `org_limit: number or null`
447
448 The organization-level value for the same limiter type, for reference. `null` when the organization has no limit configured for this limiter type.
449
450 - `source: BetaWorkspaceRateLimitWorkspaceSource or BetaWorkspaceRateLimitOrganizationSource`
451
452 Where `value` comes from. `organization` values are listed only when `include_inherited` is `true`, and then `value` equals `org_limit`.
453
454 - `BetaWorkspaceRateLimitWorkspaceSource object`
455
456 - `type: "workspace"`
457
458 Always `workspace`: a workspace-level override is stored.
459
460 default: workspace
461
462 - `BetaWorkspaceRateLimitOrganizationSource object`
463
464 - `type: "organization"`
465
466 Always `organization`: no workspace-level override is stored, so the organization's value applies.
467
468 default: organization
469
470 - `value: number`
471
472 The workspace's value for this limiter type: the workspace-level override when `source.type` is `workspace`, otherwise the organization's value.
473
474 - `models: array of string or null`
475
476 Model names this entry's limits apply to, including aliases. `null` when `group_type` is not `"model_group"`.
477
478 - `rate_limit_id: string`
479
480 The `id` of the organization's RateLimit entry this entry applies to.
481
482 - `workspace_id: string`
483
484 ID of the Workspace this entry applies to.
485
486 - `group_type: "batch" or "files" or "model_group" or 3 more`
487
488 **Deprecated**: Use `group.type` instead. `group_type` is still returned and always equals `group.type`.
489
490 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`.
491
492 - `"batch"`
493
494 - `"files"`
495
496 - `"model_group"`
497
498 - `"skills"`
499
500 - `"token_count"`
501
502 - `"web_search"`
503
504### Example
505
506```bash
507curl https://api.anthropic.com/v1/organizations/workspaces/$WORKSPACE_ID/rate_limits/$RATE_LIMIT_ID \
508 -H 'Content-Type: application/json' \
509 -H 'anthropic-version: 2023-06-01' \
510 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
511 -d '{
512 "limits": [
513 {
514 "type": "fast_itpmca",
515 "value": 0
516 }
517 ]
518 }'
519```
520
521#### Response (200)
522
523```json
524{
525 "group": {
526 "id": "id",
527 "display_name": "display_name",
528 "type": "model_group"
529 },
530 "group_type": "batch",
531 "limits": [
532 {
533 "org_limit": 0,
534 "source": {
535 "type": "workspace"
536 },
537 "type": "type",
538 "value": 0
539 }
540 ],
541 "models": [
542 "string"
543 ],
544 "rate_limit_id": "rate_limit_id",
545 "type": "workspace_rate_limit",
546 "workspace_id": "workspace_id"
547}
548```
549
278550## Domain types
279551
280552### Beta Workspace Rate Limit
from line 714
442714 Always `organization`: no workspace-level override is stored, so the organization's value applies.
443715
444716 default: organization
717
718### Beta Workspace Rate Limit Type
719
720- `BetaWorkspaceRateLimitType = "fast_itpmca" or "fast_otpm" or "input_tokens_per_minute" or 6 more`
721
722 Rate limiter type.
723
724 - `"fast_itpmca"`
725
726 - `"fast_otpm"`
727
728 - `"input_tokens_per_minute"`
729
730 - `"input_tokens_per_minute_cache_aware"`
731
732 - `"output_tokens_per_minute"`
733
734 - `"requests_per_minute"`
735
736 - `"tokens_per_day"`
737
738 - `"tokens_per_minute"`
739
740 - `"tool_uses_per_second"`
741
742### Beta Workspace Rate Limit Update Value
743
744- `BetaWorkspaceRateLimitUpdateValue object`
745
746 - `type: BetaWorkspaceRateLimitType`
747
748 Rate limiter type.
749
750 - `"fast_itpmca"`
751
752 - `"fast_otpm"`
753
754 - `"input_tokens_per_minute"`
755
756 - `"input_tokens_per_minute_cache_aware"`
757
758 - `"output_tokens_per_minute"`
759
760 - `"requests_per_minute"`
761
762 - `"tokens_per_day"`
763
764 - `"tokens_per_minute"`
765
766 - `"tool_uses_per_second"`
767
768 - `value: number or null`
769
770 New limit value. Set to null to clear the workspace override and fall back to the organization limit.
771
772 minimum: 0, maximum: 9007199254740991
445773
446774### Beta Workspace Rate Limit Value
447775
No line in this hunk matches that.