The whole hunk
from line 1, old and new numbered
/
lines
from line 1
1---
2title: Service Accounts
3url: https://platform.claude.com/docs/en/api/beta/organization/service_accounts
4---
5
16# Service Accounts
27
38## Create Service Account
from line 29
2429
2530 - `string`
2631
27 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
32 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2833
2934 - `"message-batches-2024-09-24"`
3035
from line 77
7277
7378 - `"user-profiles-2026-08-18"`
7479
80 - `"user-profiles-2026-09-04"`
81
7582 - `"advisor-tool-2026-03-01"`
7683
7784 - `"managed-agents-2026-04-01"`
from line 152
145152 A service account is a pure identity: name + org. Authorization lives on
146153 whatever references it (federation rules).
147154
155 - `type: "service_account"`
156
157 default: service_account
158
148159 - `id: string`
149160
150161 Tagged ID of the service account.
from line 196
185196
186197 - `"developer"`
187198
188 - `type: "service_account"`
189
190 default: service_account
191
192199 - `updated_at: string`
193200
194201 When this service account was last updated.
from line 274
267274
268275 - `string`
269276
270 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
277 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
271278
272279 - `"message-batches-2024-09-24"`
273280
from line 322
315322
316323 - `"user-profiles-2026-08-18"`
317324
325 - `"user-profiles-2026-09-04"`
326
318327 - `"advisor-tool-2026-03-01"`
319328
320329 - `"managed-agents-2026-04-01"`
from line 370
361370
362371- `data: array of BetaServiceAccount`
363372
373 - `type: "service_account"`
374
375 default: service_account
376
364377 - `id: string`
365378
366379 Tagged ID of the service account.
from line 414
401414
402415 - `"developer"`
403416
404 - `type: "service_account"`
405
406 default: service_account
407
408417 - `updated_at: string`
409418
410419 When this service account was last updated.
from line 481
472481
473482 - `string`
474483
475 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
484 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
476485
477486 - `"message-batches-2024-09-24"`
478487
from line 529
520529
521530 - `"user-profiles-2026-08-18"`
522531
532 - `"user-profiles-2026-09-04"`
533
523534 - `"advisor-tool-2026-03-01"`
524535
525536 - `"managed-agents-2026-04-01"`
from line 582
571582 A service account is a pure identity: name + org. Authorization lives on
572583 whatever references it (federation rules).
573584
585 - `type: "service_account"`
586
587 default: service_account
588
574589 - `id: string`
575590
576591 Tagged ID of the service account.
from line 626
611626
612627 - `"developer"`
613628
614 - `type: "service_account"`
615
616 default: service_account
617
618629 - `updated_at: string`
619630
620631 When this service account was last updated.
from line 689
678689
679690 - `string`
680691
681 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
692 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
682693
683694 - `"message-batches-2024-09-24"`
684695
from line 737
726737
727738 - `"user-profiles-2026-08-18"`
728739
740 - `"user-profiles-2026-09-04"`
741
729742 - `"advisor-tool-2026-03-01"`
730743
731744 - `"managed-agents-2026-04-01"`
from line 806
793806 A service account is a pure identity: name + org. Authorization lives on
794807 whatever references it (federation rules).
795808
809 - `type: "service_account"`
810
811 default: service_account
812
796813 - `id: string`
797814
798815 Tagged ID of the service account.
from line 850
833850
834851 - `"developer"`
835852
836 - `type: "service_account"`
837
838 default: service_account
839
840853 - `updated_at: string`
841854
842855 When this service account was last updated.
from line 915
902915
903916 - `string`
904917
905 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
918 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
906919
907920 - `"message-batches-2024-09-24"`
908921
from line 963
950963
951964 - `"user-profiles-2026-08-18"`
952965
966 - `"user-profiles-2026-09-04"`
967
953968 - `"advisor-tool-2026-03-01"`
954969
955970 - `"managed-agents-2026-04-01"`
from line 1016
10011016 A service account is a pure identity: name + org. Authorization lives on
10021017 whatever references it (federation rules).
10031018
1019 - `type: "service_account"`
1020
1021 default: service_account
1022
10041023 - `id: string`
10051024
10061025 Tagged ID of the service account.
from line 1060
10411060
10421061 - `"developer"`
10431062
1044 - `type: "service_account"`
1045
1046 default: service_account
1047
10481063 - `updated_at: string`
10491064
10501065 When this service account was last updated.
from line 1108
10931108 A service account is a pure identity: name + org. Authorization lives on
10941109 whatever references it (federation rules).
10951110
1111 - `type: "service_account"`
1112
1113 default: service_account
1114
10961115 - `id: string`
10971116
10981117 Tagged ID of the service account.
from line 1152
11331152
11341153 - `"developer"`
11351154
1136 - `type: "service_account"`
1137
1138 default: service_account
1139
11401155 - `updated_at: string`
11411156
11421157 When this service account was last updated.
from line 1166
11511166
11521167- `BetaServiceAccountWorkspaceMember object`
11531168
1169 - `type: "service_account_workspace_member"`
1170
1171 default: service_account_workspace_member
1172
11541173 - `created_by_actor_id: string or null`
11551174
11561175 Tagged ID (`user_...`/`svac_...`) of the actor who created this membership.
from line 1182
11631182
11641183 Tagged service account ID (`svac_...`).
11651184
1166 - `type: "service_account_workspace_member"`
1167
1168 default: service_account_workspace_member
1169
11701185 - `workspace_id: string`
11711186
11721187 Tagged workspace ID (`wrkspc_...`).
from line 1231
12161231
12171232 - `string`
12181233
1219 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1234 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
12201235
12211236 - `"message-batches-2024-09-24"`
12221237
from line 1279
12641279
12651280 - `"user-profiles-2026-08-18"`
12661281
1282 - `"user-profiles-2026-09-04"`
1283
12671284 - `"advisor-tool-2026-03-01"`
12681285
12691286 - `"managed-agents-2026-04-01"`
from line 1345
13281345
13291346- `BetaServiceAccountWorkspaceMember object`
13301347
1348 - `type: "service_account_workspace_member"`
1349
1350 default: service_account_workspace_member
1351
13311352 - `created_by_actor_id: string or null`
13321353
13331354 Tagged ID (`user_...`/`svac_...`) of the actor who created this membership.
from line 1361
13401361
13411362 Tagged service account ID (`svac_...`).
13421363
1343 - `type: "service_account_workspace_member"`
1344
1345 default: service_account_workspace_member
1346
13471364 - `workspace_id: string`
13481365
13491366 Tagged workspace ID (`wrkspc_...`).
from line 1453
14361453
14371454 - `string`
14381455
1439 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1456 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
14401457
14411458 - `"message-batches-2024-09-24"`
14421459
from line 1501
14841501
14851502 - `"user-profiles-2026-08-18"`
14861503
1504 - `"user-profiles-2026-09-04"`
1505
14871506 - `"advisor-tool-2026-03-01"`
14881507
14891508 - `"managed-agents-2026-04-01"`
from line 1549
15301549
15311550- `data: array of BetaServiceAccountWorkspaceMember`
15321551
1552 - `type: "service_account_workspace_member"`
1553
1554 default: service_account_workspace_member
1555
15331556 - `created_by_actor_id: string or null`
15341557
15351558 Tagged ID (`user_...`/`svac_...`) of the actor who created this membership.
from line 1565
15421565
15431566 Tagged service account ID (`svac_...`).
15441567
1545 - `type: "service_account_workspace_member"`
1546
1547 default: service_account_workspace_member
1548
15491568 - `workspace_id: string`
15501569
15511570 Tagged workspace ID (`wrkspc_...`).
from line 1647
16281647
16291648 - `string`
16301649
1631 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
1650 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
16321651
16331652 - `"message-batches-2024-09-24"`
16341653
from line 1695
16761695
16771696 - `"user-profiles-2026-08-18"`
16781697
1698 - `"user-profiles-2026-09-04"`
1699
16791700 - `"advisor-tool-2026-03-01"`
16801701
16811702 - `"managed-agents-2026-04-01"`
from line 1741
17201741
17211742#### Returns
17221743
1723- `service_account_id: string`
1724
1725 Tagged service account ID (`svac_...`) named in the delete request. Removal is idempotent; see the endpoint description for the implicit-membership no-op.
1726
17271744- `type: "service_account_workspace_member_deleted"`
17281745
17291746 default: service_account_workspace_member_deleted
1747
1748- `service_account_id: string`
1749
1750 Tagged service account ID (`svac_...`) named in the delete request. Removal is idempotent; see the endpoint description for the implicit-membership no-op.
17301751
17311752- `workspace_id: string`
17321753