Spend Limits changedapi/beta/organization/spend_limits
Nearest release: v2.1.287, published 4 hours 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+1,149added
Lines−1,253removed
From line
25
where the diff opens
First seen
10 Sep 2026
this site's first read of the page
Recorded edits7to this page, all time
## List Spend Limits ### Headers ### Beta Spend Limit Organization Scope ### Beta Spend Limit Organization Service Scope ### Beta Spend Limit RBAC Group Scope ### Beta Spend Limit Scoped API Key Actor ### Beta Spend Limit Seat Tier Scope ### Beta Spend Limit User Actor ### Beta Spend Limit User Scope ### Beta Spend Limit Workspace Scope ## Spend Limits › Effective ### List Effective Spend Limits ## List Effective Spend Limits
The whole hunk
from line 25, old and new numbered
/
The two sides of this change are more than 400 edits apart, too far apart to line up, so this is the differ's own diff of it and the words inside a line are not marked.
from line 25
2525
2626 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.
2727
28- `scope: User or Organization or Workspace`
28- `scope: BetaSpendLimitUserScope or BetaSpendLimitOrganizationScope or BetaSpendLimitWorkspaceScope`
2929
3030 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.
3131
32 - `User object`
32 - `BetaSpendLimitUserScope object`
3333
3434 Scope selecting a single member of the organization.
3535
from line 43
4343
4444 Tagged ID of the member the spend limit applies to.
4545
46 - `Organization object`
46 - `BetaSpendLimitOrganizationScope object`
4747
4848 - `type: "organization"`
4949
5050 default: organization
5151
52 - `Workspace object`
52 - `BetaSpendLimitWorkspaceScope object`
5353
5454 Scope selecting one workspace of a Claude Console organization.
5555
from line 101
101101
102102 ISO 4217 code of the organization's billing currency; the unit for `amount`.
103103
104 - `is_enabled: boolean`
105
106 Read-only. `false` when extra usage is switched off for this organization (`organization` limit) or for this member (`user` limit); `amount` is kept and applies again when it's switched back on. Always `true` for other limits.
107
104108 - `period: BetaSpendLimitPeriod`
105109
106110 Length of the window the limit resets over. `amount` caps spend within each period.
from line 115
111115
112116 - `"weekly"`
113117
114 - `scope: User or SeatTier or RBACGroup or 3 more`
118 - `scope: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
115119
116120 What the limit applies to. A tagged union on `type`; each variant carries the identifier for its scope.
117121
118 - `User object`
122 - `BetaSpendLimitUserScope object`
119123
120124 Scope selecting a single member of the organization.
121125
from line 133
129133
130134 Tagged ID of the member the spend limit applies to.
131135
132 - `SeatTier object`
136 - `BetaSpendLimitSeatTierScope object`
133137
134138 - `type: "seat_tier"`
135139
from line 141
137141
138142 - `seat_tier: string`
139143
140 - `RBACGroup object`
144 - `BetaSpendLimitRBACGroupScope object`
141145
142146 - `type: "rbac_group"`
143147
from line 149
145149
146150 - `rbac_group_id: string`
147151
148 - `OrganizationService object`
152 - `BetaSpendLimitOrganizationServiceScope object`
149153
150154 - `type: "organization_service"`
151155
from line 157
153157
154158 - `service: string`
155159
156 - `Organization object`
160 - `BetaSpendLimitOrganizationScope object`
157161
158162 - `type: "organization"`
159163
160164 default: organization
161165
162 - `Workspace object`
166 - `BetaSpendLimitWorkspaceScope object`
163167
164168 Scope selecting one workspace of a Claude Console organization.
165169
from line 208
204208 "amount": "50000",
205209 "created_at": "2019-12-27T18:11:19.117Z",
206210 "currency": "USD",
211 "is_enabled": true,
207212 "period": "daily",
208213 "scope": {
209214 "type": "user",
from line 261
256261
257262 ISO 4217 code of the organization's billing currency; the unit for `amount`.
258263
264 - `is_enabled: boolean`
265
266 Read-only. `false` when extra usage is switched off for this organization (`organization` limit) or for this member (`user` limit); `amount` is kept and applies again when it's switched back on. Always `true` for other limits.
267
259268 - `period: BetaSpendLimitPeriod`
260269
261270 Length of the window the limit resets over. `amount` caps spend within each period.
from line 275
266275
267276 - `"weekly"`
268277
269 - `scope: User or SeatTier or RBACGroup or 3 more`
278 - `scope: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
270279
271280 What the limit applies to. A tagged union on `type`; each variant carries the identifier for its scope.
272281
273 - `User object`
282 - `BetaSpendLimitUserScope object`
274283
275284 Scope selecting a single member of the organization.
276285
from line 293
284293
285294 Tagged ID of the member the spend limit applies to.
286295
287 - `SeatTier object`
296 - `BetaSpendLimitSeatTierScope object`
288297
289298 - `type: "seat_tier"`
290299
from line 301
292301
293302 - `seat_tier: string`
294303
295 - `RBACGroup object`
304 - `BetaSpendLimitRBACGroupScope object`
296305
297306 - `type: "rbac_group"`
298307
from line 309
300309
301310 - `rbac_group_id: string`
302311
303 - `OrganizationService object`
312 - `BetaSpendLimitOrganizationServiceScope object`
304313
305314 - `type: "organization_service"`
306315
from line 317
308317
309318 - `service: string`
310319
311 - `Organization object`
320 - `BetaSpendLimitOrganizationScope object`
312321
313322 - `type: "organization"`
314323
315324 default: organization
316325
317 - `Workspace object`
326 - `BetaSpendLimitWorkspaceScope object`
318327
319328 Scope selecting one workspace of a Claude Console organization.
320329
from line 359
350359 "amount": "50000",
351360 "created_at": "2019-12-27T18:11:19.117Z",
352361 "currency": "USD",
362 "is_enabled": true,
353363 "period": "daily",
354364 "scope": {
355365 "type": "user",
from line 414
404414}
405415```
406416
407## List Effective Spend Limits
417## List Spend Limits
418
419**GET** `/v1/organizations/spend_limits`
420
421List the organization's spend limits.
422
423A Claude Console organization's limits come in an order that is stable across
424pages. A Claude Enterprise organization's are grouped by scope type,
425in the order `organization`, `seat_tier`, `rbac_group`,
426`organization_service`, `user`; within a type they come in a fixed order that
427is not creation order.
428
429### Query parameters
430
431- `limit: optional number`
432
433 Maximum number of limits per page. Defaults to `20`.
434
435 default: 20, minimum: 1, maximum: 1000
436
437- `page: optional string`
438
439 Opaque cursor from a previous response's `next_page` field.
440
441- `scope_type: optional array of "organization" or "organization_service" or "rbac_group" or 3 more`
442
443 Return only limits with these scope types. A Claude Console organization has `organization` and `workspace` limits; a Claude Enterprise organization has `organization`, `seat_tier`, `rbac_group`, `organization_service` and `user` limits. Omit for all.
444
445 maxItems: 6
446
447 - `"organization"`
448
449 - `"organization_service"`
450
451 - `"rbac_group"`
452
453 - `"seat_tier"`
454
455 - `"user"`
456
457 - `"workspace"`
458
459### Headers
460
461- `"anthropic-beta": optional array of AnthropicBeta`
462
463 This endpoint is in beta: requests must send `spend-limit-reads-2026-09-26` in this header.
464
465 - `string`
466
467 - `"message-batches-2024-09-24"`
468
469 - `"prompt-caching-2024-07-31"`
470
471 - `"computer-use-2024-10-22"`
472
473 - `"computer-use-2025-01-24"`
474
475 - `"pdfs-2024-09-25"`
476
477 - `"token-counting-2024-11-01"`
478
479 - `"token-efficient-tools-2025-02-19"`
480
481 - `"output-128k-2025-02-19"`
482
483 - `"files-api-2025-04-14"`
484
485 - `"mcp-client-2025-04-04"`
486
487 - `"mcp-client-2025-11-20"`
488
489 - `"dev-full-thinking-2025-05-14"`
490
491 - `"interleaved-thinking-2025-05-14"`
492
493 - `"code-execution-2025-05-22"`
494
495 - `"extended-cache-ttl-2025-04-11"`
496
497 - `"context-1m-2025-08-07"`
498
499 - `"context-management-2025-06-27"`
500
501 - `"model-context-window-exceeded-2025-08-26"`
502
503 - `"skills-2025-10-02"`
504
505 - `"fast-mode-2026-02-01"`
506
507 - `"output-300k-2026-03-24"`
508
509 - `"user-profiles-2026-03-24"`
510
511 - `"user-profiles-2026-08-18"`
512
513 - `"user-profiles-2026-09-04"`
514
515 - `"advisor-tool-2026-03-01"`
516
517 - `"managed-agents-2026-04-01"`
518
519 - `"cache-diagnosis-2026-04-07"`
520
521 - `"dreaming-2026-04-21"`
522
523 - `"thinking-token-count-2026-05-13"`
524
525 - `"server-side-fallback-2026-06-01"`
526
527 - `"server-side-fallback-2026-07-01"`
528
529 - `"fallback-credit-2026-06-01"`
530
531 - `"fallback-credit-2026-07-01"`
532
533 - `"agent-memory-2026-07-22"`
534
535 - `"mid-conversation-tool-changes-2026-07-01"`
536
537 - `"compact-2026-01-12"`
538
539 - `"computer-use-2025-11-24"`
540
541 - `"mcp-tunnels-2026-06-22"`
542
543 - `"structured-outputs-2025-11-13"`
544
545 - `"task-budgets-2026-03-13"`
546
547 - `"thinking-display-updates-2026-08-18"`
548
549 - `"ce-user-management-2026-07-13"`
550
551 - `"mid-conversation-output-config-2026-07-01"`
552
553 - `"thinking-binding-controls-2026-08-01"`
554
555 - `"mid-conversation-system-clear-at-2026-08-21"`
556
557 - `"compact-2026-09-04"`
558
559 - `"inline-tools-2026-09-15"`
560
561 - `"mcp-client-2026-09-15"`
562
563 - `"ce-plugins-2026-09-01"`
564
565 - `"spend-limit-reads-2026-09-26"`
566
567### Returns
568
569- `data: array of BetaSpendLimit`
570
571 - `type: "spend_limit"`
572
573 Object type. Always `spend_limit`.
574
575 default: spend_limit
576
577 - `id: string`
578
579 Unique tagged ID of the spend limit (`spl_...`).
580
581 - `amount: string or null`
582
583 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.
584
585 - `created_at: string`
586
587 RFC 3339 datetime at which the spend limit was created.
588
589 format: date-time
590
591 - `currency: string`
592
593 ISO 4217 code of the organization's billing currency; the unit for `amount`.
594
595 - `is_enabled: boolean`
596
597 Read-only. `false` when extra usage is switched off for this organization (`organization` limit) or for this member (`user` limit); `amount` is kept and applies again when it's switched back on. Always `true` for other limits.
598
599 - `period: BetaSpendLimitPeriod`
600
601 Length of the window the limit resets over. `amount` caps spend within each period.
602
603 - `"daily"`
604
605 - `"monthly"`
606
607 - `"weekly"`
608
609 - `scope: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
610
611 What the limit applies to. A tagged union on `type`; each variant carries the identifier for its scope.
612
613 - `BetaSpendLimitUserScope object`
614
615 Scope selecting a single member of the organization.
616
617 - `type: "user"`
618
619 Scope type. Always `user` for this scope.
620
621 default: user
622
623 - `user_id: string`
624
625 Tagged ID of the member the spend limit applies to.
626
627 - `BetaSpendLimitSeatTierScope object`
628
629 - `type: "seat_tier"`
630
631 default: seat_tier
632
633 - `seat_tier: string`
634
635 - `BetaSpendLimitRBACGroupScope object`
636
637 - `type: "rbac_group"`
638
639 default: rbac_group
640
641 - `rbac_group_id: string`
642
643 - `BetaSpendLimitOrganizationServiceScope object`
644
645 - `type: "organization_service"`
646
647 default: organization_service
648
649 - `service: string`
650
651 - `BetaSpendLimitOrganizationScope object`
652
653 - `type: "organization"`
654
655 default: organization
656
657 - `BetaSpendLimitWorkspaceScope object`
658
659 Scope selecting one workspace of a Claude Console organization.
660
661 - `type: "workspace"`
662
663 Scope type. Always `workspace` for this scope.
664
665 default: workspace
666
667 - `workspace_id: string`
668
669 Tagged ID of the workspace the spend limit applies to.
670
671 - `updated_at: string`
672
673 RFC 3339 datetime at which the spend limit was last modified.
674
675 format: date-time
676
677- `next_page: string or null`
678
679### Example
680
681```bash
682curl https://api.anthropic.com/v1/organizations/spend_limits \
683 -H 'anthropic-version: 2023-06-01' \
684 -H 'anthropic-beta: spend-limit-reads-2026-09-26' \
685 -H "X-Api-Key: $ANTHROPIC_API_KEY"
686```
687
688#### Response (200)
689
690```json
691{
692 "data": [
693 {
694 "id": "id",
695 "amount": "50000",
696 "created_at": "2019-12-27T18:11:19.117Z",
697 "currency": "USD",
698 "is_enabled": true,
699 "period": "daily",
700 "scope": {
701 "type": "user",
702 "user_id": "user_01WCz1FkmYMm4gnmykNKUu3Q"
703 },
704 "type": "spend_limit",
705 "updated_at": "2019-12-27T18:11:19.117Z"
706 }
707 ],
708 "next_page": "next_page"
709}
710```
711
712## Domain types
713
714### Beta Spend Limit
715
716- `BetaSpendLimit object`
717
718 A configured spend limit: a cap on metered spend for one scope and period.
719
720 - `type: "spend_limit"`
721
722 Object type. Always `spend_limit`.
723
724 default: spend_limit
725
726 - `id: string`
727
728 Unique tagged ID of the spend limit (`spl_...`).
729
730 - `amount: string or null`
731
732 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.
733
734 - `created_at: string`
735
736 RFC 3339 datetime at which the spend limit was created.
737
738 format: date-time
739
740 - `currency: string`
741
742 ISO 4217 code of the organization's billing currency; the unit for `amount`.
743
744 - `is_enabled: boolean`
745
746 Read-only. `false` when extra usage is switched off for this organization (`organization` limit) or for this member (`user` limit); `amount` is kept and applies again when it's switched back on. Always `true` for other limits.
747
748 - `period: BetaSpendLimitPeriod`
749
750 Length of the window the limit resets over. `amount` caps spend within each period.
751
752 - `"daily"`
753
754 - `"monthly"`
755
756 - `"weekly"`
757
758 - `scope: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
759
760 What the limit applies to. A tagged union on `type`; each variant carries the identifier for its scope.
761
762 - `BetaSpendLimitUserScope object`
763
764 Scope selecting a single member of the organization.
765
766 - `type: "user"`
767
768 Scope type. Always `user` for this scope.
769
770 default: user
771
772 - `user_id: string`
773
774 Tagged ID of the member the spend limit applies to.
775
776 - `BetaSpendLimitSeatTierScope object`
777
778 - `type: "seat_tier"`
779
780 default: seat_tier
781
782 - `seat_tier: string`
783
784 - `BetaSpendLimitRBACGroupScope object`
785
786 - `type: "rbac_group"`
787
788 default: rbac_group
789
790 - `rbac_group_id: string`
791
792 - `BetaSpendLimitOrganizationServiceScope object`
793
794 - `type: "organization_service"`
795
796 default: organization_service
797
798 - `service: string`
799
800 - `BetaSpendLimitOrganizationScope object`
801
802 - `type: "organization"`
803
804 default: organization
805
806 - `BetaSpendLimitWorkspaceScope object`
807
808 Scope selecting one workspace of a Claude Console organization.
809
810 - `type: "workspace"`
811
812 Scope type. Always `workspace` for this scope.
813
814 default: workspace
815
816 - `workspace_id: string`
817
818 Tagged ID of the workspace the spend limit applies to.
819
820 - `updated_at: string`
821
822 RFC 3339 datetime at which the spend limit was last modified.
823
824 format: date-time
825
826### Beta Spend Limit Organization Scope
827
828- `BetaSpendLimitOrganizationScope object`
829
830 - `type: "organization"`
831
832 default: organization
833
834### Beta Spend Limit Organization Service Scope
835
836- `BetaSpendLimitOrganizationServiceScope object`
837
838 - `type: "organization_service"`
839
840 default: organization_service
841
842 - `service: string`
843
844### Beta Spend Limit Period
845
846- `BetaSpendLimitPeriod = "daily" or "monthly" or "weekly"`
847
848 - `"daily"`
849
850 - `"monthly"`
851
852 - `"weekly"`
853
854### Beta Spend Limit RBAC Group Scope
855
856- `BetaSpendLimitRBACGroupScope object`
857
858 - `type: "rbac_group"`
859
860 default: rbac_group
861
862 - `rbac_group_id: string`
863
864### Beta Spend Limit Scoped API Key Actor
865
866- `BetaSpendLimitScopedAPIKeyActor object`
867
868 A scoped Admin API key acting on behalf of the organization.
869
870 - `type: "scoped_api_key_actor"`
871
872 default: scoped_api_key_actor
873
874 - `scoped_api_key_id: string`
875
876### Beta Spend Limit Seat Tier Scope
877
878- `BetaSpendLimitSeatTierScope object`
879
880 - `type: "seat_tier"`
881
882 default: seat_tier
883
884 - `seat_tier: string`
885
886### Beta Spend Limit User Actor
887
888- `BetaSpendLimitUserActor object`
889
890 A user within the organization. `name` and `email_address` are
891 null when the underlying account is unavailable or has been deleted;
892 `deleted` is true only for deleted accounts.
893
894 - `type: "user_actor"`
895
896 Actor type. Always `user_actor`.
897
898 default: user_actor
899
900 - `deleted: boolean`
901
902 True only when the underlying account has been deleted.
903
904 default: false
905
906 - `email_address: string or null`
907
908 The user's email address. Null when the account is unavailable or has been deleted.
909
910 - `name: string or null`
911
912 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.
913
914 - `user_id: string`
915
916 Tagged ID of the user.
917
918### Beta Spend Limit User Scope
919
920- `BetaSpendLimitUserScope object`
921
922 Scope selecting a single member of the organization.
923
924 - `type: "user"`
925
926 Scope type. Always `user` for this scope.
927
928 default: user
929
930 - `user_id: string`
931
932 Tagged ID of the member the spend limit applies to.
933
934### Beta Spend Limit Workspace Scope
935
936- `BetaSpendLimitWorkspaceScope object`
937
938 Scope selecting one workspace of a Claude Console organization.
939
940 - `type: "workspace"`
941
942 Scope type. Always `workspace` for this scope.
943
944 default: workspace
945
946 - `workspace_id: string`
947
948 Tagged ID of the workspace the spend limit applies to.
949
950### Beta Spend Summary
951
952- `BetaSpendSummary object`
953
954 Per-member effective-limit report row (`GET /spend_limits/effective`).
955
956 - `actor: BetaSpendLimitUserActor or BetaSpendLimitScopedAPIKeyActor`
957
958 - `BetaSpendLimitUserActor object`
959
960 A user within the organization. `name` and `email_address` are
961 null when the underlying account is unavailable or has been deleted;
962 `deleted` is true only for deleted accounts.
963
964 - `type: "user_actor"`
965
966 Actor type. Always `user_actor`.
967
968 default: user_actor
969
970 - `deleted: boolean`
971
972 True only when the underlying account has been deleted.
973
974 default: false
975
976 - `email_address: string or null`
977
978 The user's email address. Null when the account is unavailable or has been deleted.
979
980 - `name: string or null`
981
982 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.
983
984 - `user_id: string`
985
986 Tagged ID of the user.
987
988 - `BetaSpendLimitScopedAPIKeyActor object`
989
990 A scoped Admin API key acting on behalf of the organization.
991
992 - `type: "scoped_api_key_actor"`
993
994 default: scoped_api_key_actor
995
996 - `scoped_api_key_id: string`
997
998 - `amount: string or null`
999
1000 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.
1001
1002 - `currency: string`
1003
1004 ISO 4217 code of the organization's billing currency; the unit for `amount` and `period_to_date_spend`.
1005
1006 - `period: BetaSpendLimitPeriod`
1007
1008 Period this row's effective limit and spend are reported for.
1009
1010 - `"daily"`
1011
1012 - `"monthly"`
1013
1014 - `"weekly"`
1015
1016 - `period_to_date_spend: string`
1017
1018 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.
1019
1020 - `scope: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
1021
1022 - `BetaSpendLimitUserScope object`
1023
1024 Scope selecting a single member of the organization.
1025
1026 - `type: "user"`
1027
1028 Scope type. Always `user` for this scope.
1029
1030 default: user
1031
1032 - `user_id: string`
1033
1034 Tagged ID of the member the spend limit applies to.
1035
1036 - `BetaSpendLimitSeatTierScope object`
1037
1038 - `type: "seat_tier"`
1039
1040 default: seat_tier
1041
1042 - `seat_tier: string`
1043
1044 - `BetaSpendLimitRBACGroupScope object`
1045
1046 - `type: "rbac_group"`
1047
1048 default: rbac_group
1049
1050 - `rbac_group_id: string`
1051
1052 - `BetaSpendLimitOrganizationServiceScope object`
1053
1054 - `type: "organization_service"`
1055
1056 default: organization_service
1057
1058 - `service: string`
1059
1060 - `BetaSpendLimitOrganizationScope object`
1061
1062 - `type: "organization"`
1063
1064 default: organization
1065
1066 - `BetaSpendLimitWorkspaceScope object`
1067
1068 Scope selecting one workspace of a Claude Console organization.
1069
1070 - `type: "workspace"`
1071
1072 Scope type. Always `workspace` for this scope.
1073
1074 default: workspace
1075
1076 - `workspace_id: string`
1077
1078 Tagged ID of the workspace the spend limit applies to.
1079
1080 - `source: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
1081
1082 - `BetaSpendLimitUserScope object`
1083
1084 Scope selecting a single member of the organization.
1085
1086 - `BetaSpendLimitSeatTierScope object`
1087
1088 - `BetaSpendLimitRBACGroupScope object`
1089
1090 - `BetaSpendLimitOrganizationServiceScope object`
1091
1092 - `BetaSpendLimitOrganizationScope object`
1093
1094 - `BetaSpendLimitWorkspaceScope object`
1095
1096 Scope selecting one workspace of a Claude Console organization.
1097
1098 - `spend_limit_id: string`
1099
1100### Spend Limit Delete Response
1101
1102- `SpendLimitDeleteResponse object`
1103
1104 - `type: "spend_limit_deleted"`
1105
1106 default: spend_limit_deleted
1107
1108 - `id: string`
1109
1110## Spend Limits › Effective
1111
1112### List Effective Spend Limits
4081113
4091114**GET** `/v1/organizations/spend_limits/effective`
4101115
from line 1119
4141119for, with the `source` scope the spend limit was inherited from.
4151120Paginates by member, so a member's periods never split across pages.
4161121
417### Query parameters
1122#### Query parameters
4181123
4191124- `limit: optional number`
4201125
from line 1149
4441149
4451150 maxItems: 100
4461151
447### Returns
1152#### Returns
4481153
4491154- `data: array of BetaSpendSummary`
4501155
451 - `actor: UserActor or ScopedAPIKeyActor`
452
453 - `UserActor object`
1156 - `actor: BetaSpendLimitUserActor or BetaSpendLimitScopedAPIKeyActor`
1157
1158 - `BetaSpendLimitUserActor object`
4541159
4551160 A user within the organization. `name` and `email_address` are
4561161 null when the underlying account is unavailable or has been deleted;
from line 1185
4801185
4811186 Tagged ID of the user.
4821187
483 - `ScopedAPIKeyActor object`
1188 - `BetaSpendLimitScopedAPIKeyActor object`
4841189
4851190 A scoped Admin API key acting on behalf of the organization.
4861191
from line 1217
5121217
5131218 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.
5141219
515 - `scope: User or SeatTier or RBACGroup or 3 more`
516
517 - `User object`
1220 - `scope: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
1221
1222 - `BetaSpendLimitUserScope object`
5181223
5191224 Scope selecting a single member of the organization.
5201225
from line 1233
5281233
5291234 Tagged ID of the member the spend limit applies to.
5301235
531 - `SeatTier object`
1236 - `BetaSpendLimitSeatTierScope object`
5321237
5331238 - `type: "seat_tier"`
5341239
from line 1241
5361241
5371242 - `seat_tier: string`
5381243
539 - `RBACGroup object`
1244 - `BetaSpendLimitRBACGroupScope object`
5401245
5411246 - `type: "rbac_group"`
5421247
from line 1249
5441249
5451250 - `rbac_group_id: string`
5461251
547 - `OrganizationService object`
1252 - `BetaSpendLimitOrganizationServiceScope object`
5481253
5491254 - `type: "organization_service"`
5501255
from line 1257
5521257
5531258 - `service: string`
5541259
555 - `Organization object`
1260 - `BetaSpendLimitOrganizationScope object`
5561261
5571262 - `type: "organization"`
5581263
5591264 default: organization
5601265
561 - `Workspace object`
1266 - `BetaSpendLimitWorkspaceScope object`
5621267
5631268 Scope selecting one workspace of a Claude Console organization.
5641269
from line 1277
5721277
5731278 Tagged ID of the workspace the spend limit applies to.
5741279
575 - `source: User or SeatTier or RBACGroup or 3 more`
576
577 - `User object`
1280 - `source: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
1281
1282 - `BetaSpendLimitUserScope object`
5781283
5791284 Scope selecting a single member of the organization.
5801285
581 - `type: "user"`
582
583 Scope type. Always `user` for this scope.
584
585 default: user
586
587 - `user_id: string`
588
589 Tagged ID of the member the spend limit applies to.
590
591 - `SeatTier object`
592
593 - `type: "seat_tier"`
594
595 default: seat_tier
596
597 - `seat_tier: string`
598
599 - `RBACGroup object`
600
601 - `type: "rbac_group"`
602
603 default: rbac_group
604
605 - `rbac_group_id: string`
606
607 - `OrganizationService object`
608
609 - `type: "organization_service"`
610
611 default: organization_service
612
613 - `service: string`
614
615 - `Organization object`
616
617 - `type: "organization"`
618
619 default: organization
620
621 - `Workspace object`
1286 - `BetaSpendLimitSeatTierScope object`
1287
1288 - `BetaSpendLimitRBACGroupScope object`
1289
1290 - `BetaSpendLimitOrganizationServiceScope object`
1291
1292 - `BetaSpendLimitOrganizationScope object`
1293
1294 - `BetaSpendLimitWorkspaceScope object`
6221295
6231296 Scope selecting one workspace of a Claude Console organization.
6241297
625 - `type: "workspace"`
626
627 Scope type. Always `workspace` for this scope.
628
629 default: workspace
630
631 - `workspace_id: string`
632
633 Tagged ID of the workspace the spend limit applies to.
634
6351298 - `spend_limit_id: string`
6361299
6371300- `next_page: string or null`
6381301
639### Example
1302#### Example
6401303
6411304```bash
6421305curl https://api.anthropic.com/v1/organizations/spend_limits/effective \
from line 1307
6441307 -H "X-Api-Key: $ANTHROPIC_API_KEY"
6451308```
6461309
647#### Response (200)
1310##### Response (200)
6481311
6491312```json
6501313{
from line 1339
6761339}
6771340```
6781341
679## Domain types
680
681### Beta Spend Limit
682
683- `BetaSpendLimit object`
684
685 A configured spend limit: a cap on metered spend for one scope and period.
686
687 - `type: "spend_limit"`
688
689 Object type. Always `spend_limit`.
690
691 default: spend_limit
1342## Spend Limits › Increase Requests
1343
1344### List Spend Limit Increase Requests
1345
1346**GET** `/v1/organizations/spend_limit_increase_requests`
1347
1348List spend limit increase requests, most recent first.
1349
1350Pending requests include a live `spend_summary` for the requester.
1351Requests whose requester is no longer a member are excluded.
1352
1353#### Query parameters
1354
1355- `actor_ids: optional array of string`
1356
1357 Filter by requester, as `user_...` tagged IDs.
1358
1359- `limit: optional number`
1360
1361 default: 20, minimum: 1, maximum: 1000
1362
1363- `page: optional string`
1364
1365 Opaque cursor from a previous response's `next_page`.
1366
1367- `status: optional array of BetaSpendLimitIncreaseRequestStatus`
1368
1369 Filter by status. Omit to return all.
1370
1371 - `"approved"`
1372
1373 - `"denied"`
1374
1375 - `"pending"`
1376
1377#### Returns
1378
1379- `data: array of BetaSpendLimitIncreaseRequest`
1380
1381 - `type: "spend_limit_increase_request"`
1382
1383 default: spend_limit_increase_request
6921384
6931385 - `id: string`
6941386
695 Unique tagged ID of the spend limit (`spl_...`).
696
697 - `amount: string or null`
698
699 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.
700
701 - `created_at: string`
702
703 RFC 3339 datetime at which the spend limit was created.
704
705 format: date-time
706
707 - `currency: string`
708
709 ISO 4217 code of the organization's billing currency; the unit for `amount`.
710
711 - `period: BetaSpendLimitPeriod`
712
713 Length of the window the limit resets over. `amount` caps spend within each period.
714
715 - `"daily"`
716
717 - `"monthly"`
718
719 - `"weekly"`
720
721 - `scope: User or SeatTier or RBACGroup or 3 more`
722
723 What the limit applies to. A tagged union on `type`; each variant carries the identifier for its scope.
724
725 - `User object`
726
727 Scope selecting a single member of the organization.
728
729 - `type: "user"`
730
731 Scope type. Always `user` for this scope.
732
733 default: user
734
735 - `user_id: string`
736
737 Tagged ID of the member the spend limit applies to.
738
739 - `SeatTier object`
740
741 - `type: "seat_tier"`
742
743 default: seat_tier
744
745 - `seat_tier: string`
746
747 - `RBACGroup object`
748
749 - `type: "rbac_group"`
750
751 default: rbac_group
752
753 - `rbac_group_id: string`
754
755 - `OrganizationService object`
756
757 - `type: "organization_service"`
758
759 default: organization_service
760
761 - `service: string`
762
763 - `Organization object`
764
765 - `type: "organization"`
766
767 default: organization
768
769 - `Workspace object`
770
771 Scope selecting one workspace of a Claude Console organization.
772
773 - `type: "workspace"`
774
775 Scope type. Always `workspace` for this scope.
776
777 default: workspace
778
779 - `workspace_id: string`
780
781 Tagged ID of the workspace the spend limit applies to.
782
783 - `updated_at: string`
784
785 RFC 3339 datetime at which the spend limit was last modified.
786
787 format: date-time
788
789### Beta Spend Limit Period
790
791- `BetaSpendLimitPeriod = "daily" or "monthly" or "weekly"`
792
793 - `"daily"`
794
795 - `"monthly"`
796
797 - `"weekly"`
798
799### Beta Spend Summary
800
801- `BetaSpendSummary object`
802
803 Per-member effective-limit report row (`GET /spend_limits/effective`).
804
805 - `actor: UserActor or ScopedAPIKeyActor`
806
807 - `UserActor object`
1387 - `actor: BetaSpendLimitUserActor or BetaSpendLimitScopedAPIKeyActor`
1388
1389 - `BetaSpendLimitUserActor object`
8081390
8091391 A user within the organization. `name` and `email_address` are
8101392 null when the underlying account is unavailable or has been deleted;
from line 1416
8341416
8351417 Tagged ID of the user.
8361418
837 - `ScopedAPIKeyActor object`
1419 - `BetaSpendLimitScopedAPIKeyActor object`
8381420
8391421 A scoped Admin API key acting on behalf of the organization.
8401422
from line 1426
8441426
8451427 - `scoped_api_key_id: string`
8461428
847 - `amount: string or null`
848
849 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.
850
851 - `currency: string`
852
853 ISO 4217 code of the organization's billing currency; the unit for `amount` and `period_to_date_spend`.
1429 - `created_at: string`
1430
1431 format: date-time
8541432
8551433 - `period: BetaSpendLimitPeriod`
8561434
857 Period this row's effective limit and spend are reported for.
858
8591435 - `"daily"`
8601436
8611437 - `"monthly"`
8621438
8631439 - `"weekly"`
8641440
865 - `period_to_date_spend: string`
866
867 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.
868
869 - `scope: User or SeatTier or RBACGroup or 3 more`
870
871 - `User object`
872
873 Scope selecting a single member of the organization.
874
875 - `type: "user"`
876
877 Scope type. Always `user` for this scope.
878
879 default: user
880
881 - `user_id: string`
882
883 Tagged ID of the member the spend limit applies to.
884
885 - `SeatTier object`
886
887 - `type: "seat_tier"`
888
889 default: seat_tier
890
891 - `seat_tier: string`
892
893 - `RBACGroup object`
894
895 - `type: "rbac_group"`
896
897 default: rbac_group
898
899 - `rbac_group_id: string`
900
901 - `OrganizationService object`
902
903 - `type: "organization_service"`
904
905 default: organization_service
906
907 - `service: string`
908
909 - `Organization object`
910
911 - `type: "organization"`
912
913 default: organization
914
915 - `Workspace object`
916
917 Scope selecting one workspace of a Claude Console organization.
918
919 - `type: "workspace"`
920
921 Scope type. Always `workspace` for this scope.
922
923 default: workspace
924
925 - `workspace_id: string`
926
927 Tagged ID of the workspace the spend limit applies to.
928
929 - `source: User or SeatTier or RBACGroup or 3 more`
930
931 - `User object`
932
933 Scope selecting a single member of the organization.
934
935 - `type: "user"`
936
937 Scope type. Always `user` for this scope.
938
939 default: user
940
941 - `user_id: string`
942
943 Tagged ID of the member the spend limit applies to.
944
945 - `SeatTier object`
946
947 - `type: "seat_tier"`
948
949 default: seat_tier
950
951 - `seat_tier: string`
952
953 - `RBACGroup object`
954
955 - `type: "rbac_group"`
956
957 default: rbac_group
958
959 - `rbac_group_id: string`
960
961 - `OrganizationService object`
962
963 - `type: "organization_service"`
964
965 default: organization_service
966
967 - `service: string`
968
969 - `Organization object`
970
971 - `type: "organization"`
972
973 default: organization
974
975 - `Workspace object`
976
977 Scope selecting one workspace of a Claude Console organization.
978
979 - `type: "workspace"`
980
981 Scope type. Always `workspace` for this scope.
982
983 default: workspace
984
985 - `workspace_id: string`
986
987 Tagged ID of the workspace the spend limit applies to.
988
989 - `spend_limit_id: string`
990
991### Spend Limit Delete Response
992
993- `SpendLimitDeleteResponse object`
994
995 - `type: "spend_limit_deleted"`
996
997 default: spend_limit_deleted
998
999 - `id: string`
1000
1001## Spend Limits › Increase Requests
1002
1003### List Spend Limit Increase Requests
1004
1005**GET** `/v1/organizations/spend_limit_increase_requests`
1006
1007List spend limit increase requests, most recent first.
1008
1009Pending requests include a live `spend_summary` for the requester.
1010Requests whose requester is no longer a member are excluded.
1011
1012#### Query parameters
1013
1014- `actor_ids: optional array of string`
1015
1016 Filter by requester, as `user_...` tagged IDs.
1017
1018- `limit: optional number`
1019
1020 default: 20, minimum: 1, maximum: 1000
1021
1022- `page: optional string`
1023
1024 Opaque cursor from a previous response's `next_page`.
1025
1026- `status: optional array of BetaSpendLimitIncreaseRequestStatus`
1027
1028 Filter by status. Omit to return all.
1029
1030 - `"approved"`
1031
1032 - `"denied"`
1033
1034 - `"pending"`
1035
1036#### Returns
1037
1038- `data: array of BetaSpendLimitIncreaseRequest`
1039
1040 - `type: "spend_limit_increase_request"`
1041
1042 default: spend_limit_increase_request
1043
1044 - `id: string`
1045
1046 - `actor: UserActor or ScopedAPIKeyActor`
1047
1048 - `UserActor object`
1441 - `resolved_at: string or null`
1442
1443 format: date-time
1444
1445 - `resolved_by: BetaSpendLimitUserActor or BetaSpendLimitScopedAPIKeyActor or null`
1446
1447 - `BetaSpendLimitUserActor object`
10491448
10501449 A user within the organization. `name` and `email_address` are
10511450 null when the underlying account is unavailable or has been deleted;
10521451 `deleted` is true only for deleted accounts.
10531452
1054 - `type: "user_actor"`
1055
1056 Actor type. Always `user_actor`.
1057
1058 default: user_actor
1059
1060 - `deleted: boolean`
1061
1062 True only when the underlying account has been deleted.
1063
1064 default: false
1065
1066 - `email_address: string or null`
1067
1068 The user's email address. Null when the account is unavailable or has been deleted.
1069
1070 - `name: string or null`
1071
1072 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.
1073
1074 - `user_id: string`
1075
1076 Tagged ID of the user.
1077
1078 - `ScopedAPIKeyActor object`
1453 - `BetaSpendLimitScopedAPIKeyActor object`
10791454
10801455 A scoped Admin API key acting on behalf of the organization.
10811456
1082 - `type: "scoped_api_key_actor"`
1083
1084 default: scoped_api_key_actor
1085
1086 - `scoped_api_key_id: string`
1087
1088 - `created_at: string`
1089
1090 format: date-time
1091
1092 - `period: BetaSpendLimitPeriod`
1093
1094 - `"daily"`
1095
1096 - `"monthly"`
1097
1098 - `"weekly"`
1099
1100 - `resolved_at: string or null`
1101
1102 format: date-time
1103
1104 - `resolved_by: UserActor or ScopedAPIKeyActor or null`
1105
1106 - `UserActor object`
1107
1108 A user within the organization. `name` and `email_address` are
1109 null when the underlying account is unavailable or has been deleted;
1110 `deleted` is true only for deleted accounts.
1111
1112 - `type: "user_actor"`
1113
1114 Actor type. Always `user_actor`.
1115
1116 default: user_actor
1117
1118 - `deleted: boolean`
1119
1120 True only when the underlying account has been deleted.
1121
1122 default: false
1123
1124 - `email_address: string or null`
1125
1126 The user's email address. Null when the account is unavailable or has been deleted.
1127
1128 - `name: string or null`
1129
1130 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.
1131
1132 - `user_id: string`
1133
1134 Tagged ID of the user.
1135
1136 - `ScopedAPIKeyActor object`
1137
1138 A scoped Admin API key acting on behalf of the organization.
1139
1140 - `type: "scoped_api_key_actor"`
1141
1142 default: scoped_api_key_actor
1143
1144 - `scoped_api_key_id: string`
1145
11461457 - `spend_summary: BetaSpendSummary or null`
11471458
11481459 Per-member effective-limit report row (`GET /spend_limits/effective`).
11491460
1150 - `actor: UserActor or ScopedAPIKeyActor`
1151
1152 - `UserActor object`
1461 - `actor: BetaSpendLimitUserActor or BetaSpendLimitScopedAPIKeyActor`
1462
1463 - `BetaSpendLimitUserActor object`
11531464
11541465 A user within the organization. `name` and `email_address` are
11551466 null when the underlying account is unavailable or has been deleted;
11561467 `deleted` is true only for deleted accounts.
11571468
1158 - `type: "user_actor"`
1159
1160 Actor type. Always `user_actor`.
1161
1162 default: user_actor
1163
1164 - `deleted: boolean`
1165
1166 True only when the underlying account has been deleted.
1167
1168 default: false
1169
1170 - `email_address: string or null`
1171
1172 The user's email address. Null when the account is unavailable or has been deleted.
1173
1174 - `name: string or null`
1175
1176 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.
1469 - `BetaSpendLimitScopedAPIKeyActor object`
1470
1471 A scoped Admin API key acting on behalf of the organization.
1472
1473 - `amount: string or null`
1474
1475 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.
1476
1477 - `currency: string`
1478
1479 ISO 4217 code of the organization's billing currency; the unit for `amount` and `period_to_date_spend`.
1480
1481 - `period: BetaSpendLimitPeriod`
1482
1483 Period this row's effective limit and spend are reported for.
1484
1485 - `period_to_date_spend: string`
1486
1487 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.
1488
1489 - `scope: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
1490
1491 - `BetaSpendLimitUserScope object`
1492
1493 Scope selecting a single member of the organization.
1494
1495 - `type: "user"`
1496
1497 Scope type. Always `user` for this scope.
1498
1499 default: user
11771500
11781501 - `user_id: string`
11791502
1180 Tagged ID of the user.
1181
1182 - `ScopedAPIKeyActor object`
1183
1184 A scoped Admin API key acting on behalf of the organization.
1185
1186 - `type: "scoped_api_key_actor"`
1187
1188 default: scoped_api_key_actor
1189
1190 - `scoped_api_key_id: string`
1191
1192 - `amount: string or null`
1193
1194 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.
1195
1196 - `currency: string`
1197
1198 ISO 4217 code of the organization's billing currency; the unit for `amount` and `period_to_date_spend`.
1199
1200 - `period: BetaSpendLimitPeriod`
1201
1202 Period this row's effective limit and spend are reported for.
1203
1204 - `period_to_date_spend: string`
1205
1206 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.
1207
1208 - `scope: User or SeatTier or RBACGroup or 3 more`
1209
1210 - `User object`
1503 Tagged ID of the member the spend limit applies to.
1504
1505 - `BetaSpendLimitSeatTierScope object`
1506
1507 - `type: "seat_tier"`
1508
1509 default: seat_tier
1510
1511 - `seat_tier: string`
1512
1513 - `BetaSpendLimitRBACGroupScope object`
1514
1515 - `type: "rbac_group"`
1516
1517 default: rbac_group
1518
1519 - `rbac_group_id: string`
1520
1521 - `BetaSpendLimitOrganizationServiceScope object`
1522
1523 - `type: "organization_service"`
1524
1525 default: organization_service
1526
1527 - `service: string`
1528
1529 - `BetaSpendLimitOrganizationScope object`
1530
1531 - `type: "organization"`
1532
1533 default: organization
1534
1535 - `BetaSpendLimitWorkspaceScope object`
1536
1537 Scope selecting one workspace of a Claude Console organization.
1538
1539 - `type: "workspace"`
1540
1541 Scope type. Always `workspace` for this scope.
1542
1543 default: workspace
1544
1545 - `workspace_id: string`
1546
1547 Tagged ID of the workspace the spend limit applies to.
1548
1549 - `source: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
1550
1551 - `BetaSpendLimitUserScope object`
12111552
12121553 Scope selecting a single member of the organization.
12131554
1214 - `type: "user"`
1215
1216 Scope type. Always `user` for this scope.
1217
1218 default: user
1219
1220 - `user_id: string`
1221
1222 Tagged ID of the member the spend limit applies to.
1223
1224 - `SeatTier object`
1225
1226 - `type: "seat_tier"`
1227
1228 default: seat_tier
1229
1230 - `seat_tier: string`
1231
1232 - `RBACGroup object`
1233
1234 - `type: "rbac_group"`
1235
1236 default: rbac_group
1237
1238 - `rbac_group_id: string`
1239
1240 - `OrganizationService object`
1241
1242 - `type: "organization_service"`
1243
1244 default: organization_service
1245
1246 - `service: string`
1247
1248 - `Organization object`
1249
1250 - `type: "organization"`
1251
1252 default: organization
1253
1254 - `Workspace object`
1555 - `BetaSpendLimitSeatTierScope object`
1556
1557 - `BetaSpendLimitRBACGroupScope object`
1558
1559 - `BetaSpendLimitOrganizationServiceScope object`
1560
1561 - `BetaSpendLimitOrganizationScope object`
1562
1563 - `BetaSpendLimitWorkspaceScope object`
12551564
12561565 Scope selecting one workspace of a Claude Console organization.
1257
1258 - `type: "workspace"`
1259
1260 Scope type. Always `workspace` for this scope.
1261
1262 default: workspace
1263
1264 - `workspace_id: string`
1265
1266 Tagged ID of the workspace the spend limit applies to.
1267
1268 - `source: User or SeatTier or RBACGroup or 3 more`
1269
1270 - `User object`
1271
1272 Scope selecting a single member of the organization.
1273
1274 - `type: "user"`
1275
1276 Scope type. Always `user` for this scope.
1277
1278 default: user
1279
1280 - `user_id: string`
1281
1282 Tagged ID of the member the spend limit applies to.
1283
1284 - `SeatTier object`
1285
1286 - `type: "seat_tier"`
1287
1288 default: seat_tier
1289
1290 - `seat_tier: string`
1291
1292 - `RBACGroup object`
1293
1294 - `type: "rbac_group"`
1295
1296 default: rbac_group
1297
1298 - `rbac_group_id: string`
1299
1300 - `OrganizationService object`
1301
1302 - `type: "organization_service"`
1303
1304 default: organization_service
1305
1306 - `service: string`
1307
1308 - `Organization object`
1309
1310 - `type: "organization"`
1311
1312 default: organization
1313
1314 - `Workspace object`
1315
1316 Scope selecting one workspace of a Claude Console organization.
1317
1318 - `type: "workspace"`
1319
1320 Scope type. Always `workspace` for this scope.
1321
1322 default: workspace
1323
1324 - `workspace_id: string`
1325
1326 Tagged ID of the workspace the spend limit applies to.
13271566
13281567 - `spend_limit_id: string`
13291568
from line 1663
14241663
14251664 - `id: string`
14261665
1427 - `actor: UserActor or ScopedAPIKeyActor`
1428
1429 - `UserActor object`
1666 - `actor: BetaSpendLimitUserActor or BetaSpendLimitScopedAPIKeyActor`
1667
1668 - `BetaSpendLimitUserActor object`
14301669
14311670 A user within the organization. `name` and `email_address` are
14321671 null when the underlying account is unavailable or has been deleted;
from line 1695
14561695
14571696 Tagged ID of the user.
14581697
1459 - `ScopedAPIKeyActor object`
1698 - `BetaSpendLimitScopedAPIKeyActor object`
14601699
14611700 A scoped Admin API key acting on behalf of the organization.
14621701
from line 1721
14821721
14831722 format: date-time
14841723
1485 - `resolved_by: UserActor or ScopedAPIKeyActor or null`
1486
1487 - `UserActor object`
1724 - `resolved_by: BetaSpendLimitUserActor or BetaSpendLimitScopedAPIKeyActor or null`
1725
1726 - `BetaSpendLimitUserActor object`
14881727
14891728 A user within the organization. `name` and `email_address` are
14901729 null when the underlying account is unavailable or has been deleted;
14911730 `deleted` is true only for deleted accounts.
14921731
1493 - `type: "user_actor"`
1494
1495 Actor type. Always `user_actor`.
1496
1497 default: user_actor
1498
1499 - `deleted: boolean`
1500
1501 True only when the underlying account has been deleted.
1502
1503 default: false
1504
1505 - `email_address: string or null`
1506
1507 The user's email address. Null when the account is unavailable or has been deleted.
1508
1509 - `name: string or null`
1510
1511 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.
1512
1513 - `user_id: string`
1514
1515 Tagged ID of the user.
1516
1517 - `ScopedAPIKeyActor object`
1732 - `BetaSpendLimitScopedAPIKeyActor object`
15181733
15191734 A scoped Admin API key acting on behalf of the organization.
15201735
1521 - `type: "scoped_api_key_actor"`
1522
1523 default: scoped_api_key_actor
1524
1525 - `scoped_api_key_id: string`
1526
15271736 - `spend_summary: BetaSpendSummary or null`
15281737
15291738 Per-member effective-limit report row (`GET /spend_limits/effective`).
15301739
1531 - `actor: UserActor or ScopedAPIKeyActor`
1532
1533 - `UserActor object`
1740 - `actor: BetaSpendLimitUserActor or BetaSpendLimitScopedAPIKeyActor`
1741
1742 - `BetaSpendLimitUserActor object`
15341743
15351744 A user within the organization. `name` and `email_address` are
15361745 null when the underlying account is unavailable or has been deleted;
15371746 `deleted` is true only for deleted accounts.
15381747
1539 - `type: "user_actor"`
1540
1541 Actor type. Always `user_actor`.
1542
1543 default: user_actor
1544
1545 - `deleted: boolean`
1546
1547 True only when the underlying account has been deleted.
1548
1549 default: false
1550
1551 - `email_address: string or null`
1552
1553 The user's email address. Null when the account is unavailable or has been deleted.
1554
1555 - `name: string or null`
1556
1557 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.
1748 - `BetaSpendLimitScopedAPIKeyActor object`
1749
1750 A scoped Admin API key acting on behalf of the organization.
1751
1752 - `amount: string or null`
1753
1754 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.
1755
1756 - `currency: string`
1757
1758 ISO 4217 code of the organization's billing currency; the unit for `amount` and `period_to_date_spend`.
1759
1760 - `period: BetaSpendLimitPeriod`
1761
1762 Period this row's effective limit and spend are reported for.
1763
1764 - `period_to_date_spend: string`
1765
1766 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.
1767
1768 - `scope: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
1769
1770 - `BetaSpendLimitUserScope object`
1771
1772 Scope selecting a single member of the organization.
1773
1774 - `type: "user"`
1775
1776 Scope type. Always `user` for this scope.
1777
1778 default: user
15581779
15591780 - `user_id: string`
15601781
1561 Tagged ID of the user.
1562
1563 - `ScopedAPIKeyActor object`
1564
1565 A scoped Admin API key acting on behalf of the organization.
1566
1567 - `type: "scoped_api_key_actor"`
1568
1569 default: scoped_api_key_actor
1570
1571 - `scoped_api_key_id: string`
1572
1573 - `amount: string or null`
1574
1575 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.
1576
1577 - `currency: string`
1578
1579 ISO 4217 code of the organization's billing currency; the unit for `amount` and `period_to_date_spend`.
1580
1581 - `period: BetaSpendLimitPeriod`
1582
1583 Period this row's effective limit and spend are reported for.
1584
1585 - `period_to_date_spend: string`
1586
1587 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.
1588
1589 - `scope: User or SeatTier or RBACGroup or 3 more`
1590
1591 - `User object`
1782 Tagged ID of the member the spend limit applies to.
1783
1784 - `BetaSpendLimitSeatTierScope object`
1785
1786 - `type: "seat_tier"`
1787
1788 default: seat_tier
1789
1790 - `seat_tier: string`
1791
1792 - `BetaSpendLimitRBACGroupScope object`
1793
1794 - `type: "rbac_group"`
1795
1796 default: rbac_group
1797
1798 - `rbac_group_id: string`
1799
1800 - `BetaSpendLimitOrganizationServiceScope object`
1801
1802 - `type: "organization_service"`
1803
1804 default: organization_service
1805
1806 - `service: string`
1807
1808 - `BetaSpendLimitOrganizationScope object`
1809
1810 - `type: "organization"`
1811
1812 default: organization
1813
1814 - `BetaSpendLimitWorkspaceScope object`
1815
1816 Scope selecting one workspace of a Claude Console organization.
1817
1818 - `type: "workspace"`
1819
1820 Scope type. Always `workspace` for this scope.
1821
1822 default: workspace
1823
1824 - `workspace_id: string`
1825
1826 Tagged ID of the workspace the spend limit applies to.
1827
1828 - `source: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
1829
1830 - `BetaSpendLimitUserScope object`
15921831
15931832 Scope selecting a single member of the organization.
15941833
1595 - `type: "user"`
1596
1597 Scope type. Always `user` for this scope.
1598
1599 default: user
1600
1601 - `user_id: string`
1602
1603 Tagged ID of the member the spend limit applies to.
1604
1605 - `SeatTier object`
1606
1607 - `type: "seat_tier"`
1608
1609 default: seat_tier
1610
1611 - `seat_tier: string`
1612
1613 - `RBACGroup object`
1614
1615 - `type: "rbac_group"`
1616
1617 default: rbac_group
1618
1619 - `rbac_group_id: string`
1620
1621 - `OrganizationService object`
1622
1623 - `type: "organization_service"`
1624
1625 default: organization_service
1626
1627 - `service: string`
1628
1629 - `Organization object`
1630
1631 - `type: "organization"`
1632
1633 default: organization
1634
1635 - `Workspace object`
1834 - `BetaSpendLimitSeatTierScope object`
1835
1836 - `BetaSpendLimitRBACGroupScope object`
1837
1838 - `BetaSpendLimitOrganizationServiceScope object`
1839
1840 - `BetaSpendLimitOrganizationScope object`
1841
1842 - `BetaSpendLimitWorkspaceScope object`
16361843
16371844 Scope selecting one workspace of a Claude Console organization.
1638
1639 - `type: "workspace"`
1640
1641 Scope type. Always `workspace` for this scope.
1642
1643 default: workspace
1644
1645 - `workspace_id: string`
1646
1647 Tagged ID of the workspace the spend limit applies to.
1648
1649 - `source: User or SeatTier or RBACGroup or 3 more`
1650
1651 - `User object`
1652
1653 Scope selecting a single member of the organization.
1654
1655 - `type: "user"`
1656
1657 Scope type. Always `user` for this scope.
1658
1659 default: user
1660
1661 - `user_id: string`
1662
1663 Tagged ID of the member the spend limit applies to.
1664
1665 - `SeatTier object`
1666
1667 - `type: "seat_tier"`
1668
1669 default: seat_tier
1670
1671 - `seat_tier: string`
1672
1673 - `RBACGroup object`
1674
1675 - `type: "rbac_group"`
1676
1677 default: rbac_group
1678
1679 - `rbac_group_id: string`
1680
1681 - `OrganizationService object`
1682
1683 - `type: "organization_service"`
1684
1685 default: organization_service
1686
1687 - `service: string`
1688
1689 - `Organization object`
1690
1691 - `type: "organization"`
1692
1693 default: organization
1694
1695 - `Workspace object`
1696
1697 Scope selecting one workspace of a Claude Console organization.
1698
1699 - `type: "workspace"`
1700
1701 Scope type. Always `workspace` for this scope.
1702
1703 default: workspace
1704
1705 - `workspace_id: string`
1706
1707 Tagged ID of the workspace the spend limit applies to.
17081845
17091846 - `spend_limit_id: string`
17101847
from line 1951
18141951
18151952- `id: string`
18161953
1817- `actor: UserActor or ScopedAPIKeyActor`
1818
1819 - `UserActor object`
1954- `actor: BetaSpendLimitUserActor or BetaSpendLimitScopedAPIKeyActor`
1955
1956 - `BetaSpendLimitUserActor object`
18201957
18211958 A user within the organization. `name` and `email_address` are
18221959 null when the underlying account is unavailable or has been deleted;
from line 1983
18461983
18471984 Tagged ID of the user.
18481985
1849 - `ScopedAPIKeyActor object`
1986 - `BetaSpendLimitScopedAPIKeyActor object`
18501987
18511988 A scoped Admin API key acting on behalf of the organization.
18521989
from line 2009
18722009
18732010 format: date-time
18742011
1875- `resolved_by: UserActor or ScopedAPIKeyActor or null`
1876
1877 - `UserActor object`
2012- `resolved_by: BetaSpendLimitUserActor or BetaSpendLimitScopedAPIKeyActor or null`
2013
2014 - `BetaSpendLimitUserActor object`
18782015
18792016 A user within the organization. `name` and `email_address` are
18802017 null when the underlying account is unavailable or has been deleted;
18812018 `deleted` is true only for deleted accounts.
18822019
1883 - `type: "user_actor"`
1884
1885 Actor type. Always `user_actor`.
1886
1887 default: user_actor
1888
1889 - `deleted: boolean`
1890
1891 True only when the underlying account has been deleted.
1892
1893 default: false
1894
1895 - `email_address: string or null`
1896
1897 The user's email address. Null when the account is unavailable or has been deleted.
1898
1899 - `name: string or null`
1900
1901 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.
1902
1903 - `user_id: string`
1904
1905 Tagged ID of the user.
1906
1907 - `ScopedAPIKeyActor object`
2020 - `BetaSpendLimitScopedAPIKeyActor object`
19082021
19092022 A scoped Admin API key acting on behalf of the organization.
19102023
1911 - `type: "scoped_api_key_actor"`
1912
1913 default: scoped_api_key_actor
1914
1915 - `scoped_api_key_id: string`
1916
19172024- `spend_limit: BetaSpendLimit`
19182025
19192026 A configured spend limit: a cap on metered spend for one scope and period.
from line 2049
19422049
19432050 ISO 4217 code of the organization's billing currency; the unit for `amount`.
19442051
2052 - `is_enabled: boolean`
2053
2054 Read-only. `false` when extra usage is switched off for this organization (`organization` limit) or for this member (`user` limit); `amount` is kept and applies again when it's switched back on. Always `true` for other limits.
2055
19452056 - `period: BetaSpendLimitPeriod`
19462057
19472058 Length of the window the limit resets over. `amount` caps spend within each period.
19482059
1949 - `scope: User or SeatTier or RBACGroup or 3 more`
2060 - `scope: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
19502061
19512062 What the limit applies to. A tagged union on `type`; each variant carries the identifier for its scope.
19522063
1953 - `User object`
2064 - `BetaSpendLimitUserScope object`
19542065
19552066 Scope selecting a single member of the organization.
19562067
from line 2075
19642075
19652076 Tagged ID of the member the spend limit applies to.
19662077
1967 - `SeatTier object`
2078 - `BetaSpendLimitSeatTierScope object`
19682079
19692080 - `type: "seat_tier"`
19702081
from line 2083
19722083
19732084 - `seat_tier: string`
19742085
1975 - `RBACGroup object`
2086 - `BetaSpendLimitRBACGroupScope object`
19762087
19772088 - `type: "rbac_group"`
19782089
from line 2091
19802091
19812092 - `rbac_group_id: string`
19822093
1983 - `OrganizationService object`
2094 - `BetaSpendLimitOrganizationServiceScope object`
19842095
19852096 - `type: "organization_service"`
19862097
from line 2099
19882099
19892100 - `service: string`
19902101
1991 - `Organization object`
2102 - `BetaSpendLimitOrganizationScope object`
19922103
19932104 - `type: "organization"`
19942105
19952106 default: organization
19962107
1997 - `Workspace object`
2108 - `BetaSpendLimitWorkspaceScope object`
19982109
19992110 Scope selecting one workspace of a Claude Console organization.
20002111
from line 2129
20182129
20192130 Per-member effective-limit report row (`GET /spend_limits/effective`).
20202131
2021 - `actor: UserActor or ScopedAPIKeyActor`
2022
2023 - `UserActor object`
2132 - `actor: BetaSpendLimitUserActor or BetaSpendLimitScopedAPIKeyActor`
2133
2134 - `BetaSpendLimitUserActor object`
20242135
20252136 A user within the organization. `name` and `email_address` are
20262137 null when the underlying account is unavailable or has been deleted;
20272138 `deleted` is true only for deleted accounts.
20282139
2029 - `type: "user_actor"`
2030
2031 Actor type. Always `user_actor`.
2032
2033 default: user_actor
2034
2035 - `deleted: boolean`
2036
2037 True only when the underlying account has been deleted.
2038
2039 default: false
2040
2041 - `email_address: string or null`
2042
2043 The user's email address. Null when the account is unavailable or has been deleted.
2044
2045 - `name: string or null`
2046
2047 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.
2048
2049 - `user_id: string`
2050
2051 Tagged ID of the user.
2052
2053 - `ScopedAPIKeyActor object`
2140 - `BetaSpendLimitScopedAPIKeyActor object`
20542141
20552142 A scoped Admin API key acting on behalf of the organization.
20562143
2057 - `type: "scoped_api_key_actor"`
2058
2059 default: scoped_api_key_actor
2060
2061 - `scoped_api_key_id: string`
2062
20632144 - `amount: string or null`
20642145
20652146 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.
from line 2157
20762157
20772158 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.
20782159
2079 - `scope: User or SeatTier or RBACGroup or 3 more`
2080
2081 - `User object`
2160 - `scope: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
2161
2162 - `BetaSpendLimitUserScope object`
20822163
20832164 Scope selecting a single member of the organization.
20842165
2085 - `type: "user"`
2086
2087 Scope type. Always `user` for this scope.
2088
2089 default: user
2090
2091 - `user_id: string`
2092
2093 Tagged ID of the member the spend limit applies to.
2094
2095 - `SeatTier object`
2096
2097 - `type: "seat_tier"`
2098
2099 default: seat_tier
2100
2101 - `seat_tier: string`
2102
2103 - `RBACGroup object`
2104
2105 - `type: "rbac_group"`
2106
2107 default: rbac_group
2108
2109 - `rbac_group_id: string`
2110
2111 - `OrganizationService object`
2112
2113 - `type: "organization_service"`
2114
2115 default: organization_service
2116
2117 - `service: string`
2118
2119 - `Organization object`
2120
2121 - `type: "organization"`
2122
2123 default: organization
2124
2125 - `Workspace object`
2166 - `BetaSpendLimitSeatTierScope object`
2167
2168 - `BetaSpendLimitRBACGroupScope object`
2169
2170 - `BetaSpendLimitOrganizationServiceScope object`
2171
2172 - `BetaSpendLimitOrganizationScope object`
2173
2174 - `BetaSpendLimitWorkspaceScope object`
21262175
21272176 Scope selecting one workspace of a Claude Console organization.
21282177
2129 - `type: "workspace"`
2130
2131 Scope type. Always `workspace` for this scope.
2132
2133 default: workspace
2134
2135 - `workspace_id: string`
2136
2137 Tagged ID of the workspace the spend limit applies to.
2138
2139 - `source: User or SeatTier or RBACGroup or 3 more`
2140
2141 - `User object`
2178 - `source: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
2179
2180 - `BetaSpendLimitUserScope object`
21422181
21432182 Scope selecting a single member of the organization.
21442183
2145 - `type: "user"`
2146
2147 Scope type. Always `user` for this scope.
2148
2149 default: user
2150
2151 - `user_id: string`
2152
2153 Tagged ID of the member the spend limit applies to.
2154
2155 - `SeatTier object`
2156
2157 - `type: "seat_tier"`
2158
2159 default: seat_tier
2160
2161 - `seat_tier: string`
2162
2163 - `RBACGroup object`
2164
2165 - `type: "rbac_group"`
2166
2167 default: rbac_group
2168
2169 - `rbac_group_id: string`
2170
2171 - `OrganizationService object`
2172
2173 - `type: "organization_service"`
2174
2175 default: organization_service
2176
2177 - `service: string`
2178
2179 - `Organization object`
2180
2181 - `type: "organization"`
2182
2183 default: organization
2184
2185 - `Workspace object`
2184 - `BetaSpendLimitSeatTierScope object`
2185
2186 - `BetaSpendLimitRBACGroupScope object`
2187
2188 - `BetaSpendLimitOrganizationServiceScope object`
2189
2190 - `BetaSpendLimitOrganizationScope object`
2191
2192 - `BetaSpendLimitWorkspaceScope object`
21862193
21872194 Scope selecting one workspace of a Claude Console organization.
2188
2189 - `type: "workspace"`
2190
2191 Scope type. Always `workspace` for this scope.
2192
2193 default: workspace
2194
2195 - `workspace_id: string`
2196
2197 Tagged ID of the workspace the spend limit applies to.
21982195
21992196 - `spend_limit_id: string`
22002197
from line 2243
22462243 "amount": "50000",
22472244 "created_at": "2019-12-27T18:11:19.117Z",
22482245 "currency": "USD",
2246 "is_enabled": true,
22492247 "period": "daily",
22502248 "scope": {
22512249 "type": "user",
from line 2308
23102308
23112309 - `id: string`
23122310
2313 - `actor: UserActor or ScopedAPIKeyActor`
2314
2315 - `UserActor object`
2311 - `actor: BetaSpendLimitUserActor or BetaSpendLimitScopedAPIKeyActor`
2312
2313 - `BetaSpendLimitUserActor object`
23162314
23172315 A user within the organization. `name` and `email_address` are
23182316 null when the underlying account is unavailable or has been deleted;
from line 2340
23422340
23432341 Tagged ID of the user.
23442342
2345 - `ScopedAPIKeyActor object`
2343 - `BetaSpendLimitScopedAPIKeyActor object`
23462344
23472345 A scoped Admin API key acting on behalf of the organization.
23482346
from line 2366
23682366
23692367 format: date-time
23702368
2371 - `resolved_by: UserActor or ScopedAPIKeyActor or null`
2372
2373 - `UserActor object`
2369 - `resolved_by: BetaSpendLimitUserActor or BetaSpendLimitScopedAPIKeyActor or null`
2370
2371 - `BetaSpendLimitUserActor object`
23742372
23752373 A user within the organization. `name` and `email_address` are
23762374 null when the underlying account is unavailable or has been deleted;
23772375 `deleted` is true only for deleted accounts.
23782376
2379 - `type: "user_actor"`
2380
2381 Actor type. Always `user_actor`.
2382
2383 default: user_actor
2384
2385 - `deleted: boolean`
2386
2387 True only when the underlying account has been deleted.
2388
2389 default: false
2390
2391 - `email_address: string or null`
2392
2393 The user's email address. Null when the account is unavailable or has been deleted.
2394
2395 - `name: string or null`
2396
2397 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.
2398
2399 - `user_id: string`
2400
2401 Tagged ID of the user.
2402
2403 - `ScopedAPIKeyActor object`
2377 - `BetaSpendLimitScopedAPIKeyActor object`
24042378
24052379 A scoped Admin API key acting on behalf of the organization.
24062380
2407 - `type: "scoped_api_key_actor"`
2408
2409 default: scoped_api_key_actor
2410
2411 - `scoped_api_key_id: string`
2412
24132381 - `spend_summary: BetaSpendSummary or null`
24142382
24152383 Per-member effective-limit report row (`GET /spend_limits/effective`).
24162384
2417 - `actor: UserActor or ScopedAPIKeyActor`
2418
2419 - `UserActor object`
2385 - `actor: BetaSpendLimitUserActor or BetaSpendLimitScopedAPIKeyActor`
2386
2387 - `BetaSpendLimitUserActor object`
24202388
24212389 A user within the organization. `name` and `email_address` are
24222390 null when the underlying account is unavailable or has been deleted;
24232391 `deleted` is true only for deleted accounts.
24242392
2425 - `type: "user_actor"`
2426
2427 Actor type. Always `user_actor`.
2428
2429 default: user_actor
2430
2431 - `deleted: boolean`
2432
2433 True only when the underlying account has been deleted.
2434
2435 default: false
2436
2437 - `email_address: string or null`
2438
2439 The user's email address. Null when the account is unavailable or has been deleted.
2440
2441 - `name: string or null`
2442
2443 The user's current display name. Null when the account is unavailable, has been deleted, or has no name set.
2393 - `BetaSpendLimitScopedAPIKeyActor object`
2394
2395 A scoped Admin API key acting on behalf of the organization.
2396
2397 - `amount: string or null`
2398
2399 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.
2400
2401 - `currency: string`
2402
2403 ISO 4217 code of the organization's billing currency; the unit for `amount` and `period_to_date_spend`.
2404
2405 - `period: BetaSpendLimitPeriod`
2406
2407 Period this row's effective limit and spend are reported for.
2408
2409 - `period_to_date_spend: string`
2410
2411 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.
2412
2413 - `scope: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
2414
2415 - `BetaSpendLimitUserScope object`
2416
2417 Scope selecting a single member of the organization.
2418
2419 - `type: "user"`
2420
2421 Scope type. Always `user` for this scope.
2422
2423 default: user
24442424
24452425 - `user_id: string`
24462426
2447 Tagged ID of the user.
2448
2449 - `ScopedAPIKeyActor object`
2450
2451 A scoped Admin API key acting on behalf of the organization.
2452
2453 - `type: "scoped_api_key_actor"`
2454
2455 default: scoped_api_key_actor
2456
2457 - `scoped_api_key_id: string`
2458
2459 - `amount: string or null`
2460
2461 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.
2462
2463 - `currency: string`
2464
2465 ISO 4217 code of the organization's billing currency; the unit for `amount` and `period_to_date_spend`.
2466
2467 - `period: BetaSpendLimitPeriod`
2468
2469 Period this row's effective limit and spend are reported for.
2470
2471 - `period_to_date_spend: string`
2472
2473 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.
2474
2475 - `scope: User or SeatTier or RBACGroup or 3 more`
2476
2477 - `User object`
2427 Tagged ID of the member the spend limit applies to.
2428
2429 - `BetaSpendLimitSeatTierScope object`
2430
2431 - `type: "seat_tier"`
2432
2433 default: seat_tier
2434
2435 - `seat_tier: string`
2436
2437 - `BetaSpendLimitRBACGroupScope object`
2438
2439 - `type: "rbac_group"`
2440
2441 default: rbac_group
2442
2443 - `rbac_group_id: string`
2444
2445 - `BetaSpendLimitOrganizationServiceScope object`
2446
2447 - `type: "organization_service"`
2448
2449 default: organization_service
2450
2451 - `service: string`
2452
2453 - `BetaSpendLimitOrganizationScope object`
2454
2455 - `type: "organization"`
2456
2457 default: organization
2458
2459 - `BetaSpendLimitWorkspaceScope object`
2460
2461 Scope selecting one workspace of a Claude Console organization.
2462
2463 - `type: "workspace"`
2464
2465 Scope type. Always `workspace` for this scope.
2466
2467 default: workspace
2468
2469 - `workspace_id: string`
2470
2471 Tagged ID of the workspace the spend limit applies to.
2472
2473 - `source: BetaSpendLimitUserScope or BetaSpendLimitSeatTierScope or BetaSpendLimitRBACGroupScope or 3 more`
2474
2475 - `BetaSpendLimitUserScope object`
24782476
24792477 Scope selecting a single member of the organization.
24802478
2481 - `type: "user"`
2482
2483 Scope type. Always `user` for this scope.
2484
2485 default: user
2486
2487 - `user_id: string`
2488
2489 Tagged ID of the member the spend limit applies to.
2490
2491 - `SeatTier object`
2492
2493 - `type: "seat_tier"`
2494
2495 default: seat_tier
2496
2497 - `seat_tier: string`
2498
2499 - `RBACGroup object`
2500
2501 - `type: "rbac_group"`
2502
2503 default: rbac_group
2504
2505 - `rbac_group_id: string`
2506
2507 - `OrganizationService object`
2508
2509 - `type: "organization_service"`
2510
2511 default: organization_service
2512
2513 - `service: string`
2514
2515 - `Organization object`
2516
2517 - `type: "organization"`
2518
2519 default: organization
2520
2521 - `Workspace object`
2479 - `BetaSpendLimitSeatTierScope object`
2480
2481 - `BetaSpendLimitRBACGroupScope object`
2482
2483 - `BetaSpendLimitOrganizationServiceScope object`
2484
2485 - `BetaSpendLimitOrganizationScope object`
2486
2487 - `BetaSpendLimitWorkspaceScope object`
25222488
25232489 Scope selecting one workspace of a Claude Console organization.
2524
2525 - `type: "workspace"`
2526
2527 Scope type. Always `workspace` for this scope.
2528
2529 default: workspace
2530
2531 - `workspace_id: string`
2532
2533 Tagged ID of the workspace the spend limit applies to.
2534
2535 - `source: User or SeatTier or RBACGroup or 3 more`
2536
2537 - `User object`
2538
2539 Scope selecting a single member of the organization.
2540
2541 - `type: "user"`
2542
2543 Scope type. Always `user` for this scope.
2544
2545 default: user
2546
2547 - `user_id: string`
2548
2549 Tagged ID of the member the spend limit applies to.
2550
2551 - `SeatTier object`
2552
2553 - `type: "seat_tier"`
2554
2555 default: seat_tier
2556
2557 - `seat_tier: string`
2558
2559 - `RBACGroup object`
2560
2561 - `type: "rbac_group"`
2562
2563 default: rbac_group
2564
2565 - `rbac_group_id: string`
2566
2567 - `OrganizationService object`
2568
2569 - `type: "organization_service"`
2570
2571 default: organization_service
2572
2573 - `service: string`
2574
2575 - `Organization object`
2576
2577 - `type: "organization"`
2578
2579 default: organization
2580
2581 - `Workspace object`
2582
2583 Scope selecting one workspace of a Claude Console organization.
2584
2585 - `type: "workspace"`
2586
2587 Scope type. Always `workspace` for this scope.
2588
2589 default: workspace
2590
2591 - `workspace_id: string`
2592
2593 Tagged ID of the workspace the spend limit applies to.
25942490
25952491 - `spend_limit_id: string`
25962492
25972493
No line in this hunk matches that.