User Profiles changedapi/beta/user_profiles
Nearest release: v2.1.238, published under an hour after 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+258added
Lines−188removed
From line
19
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits20to this page, all time
The whole hunk
from line 19, old and new numbered
/
from line 19
1919
2020 - `string`
2121
22 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
22 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2323
2424 - `"message-batches-2024-09-24"`
2525
from line 65
6565
6666 - `"user-profiles-2026-03-24"`
6767
68 - `"user-profiles-2026-08-18"`
69
6870 - `"advisor-tool-2026-03-01"`
6971
7072 - `"managed-agents-2026-04-01"`
from line 91
8991
9092### Body Parameters
9193
94- `access_type: optional "application" or "passthrough"`
95
96 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
97
98 - `"application"`
99
100 - `"passthrough"`
101
92102- `external_id: optional string or null`
93103
94104 Platform's own identifier for this user. Not enforced unique. Maximum 255 characters.
from line 109
99109
100110- `name: optional string or null`
101111
102 Display name of the entity this profile represents. Required when relationship is `resold` (the resold-to company's name); optional otherwise. Maximum 255 characters.
112 Optional for all profiles. Real-world name of the entity this profile represents (company or individual); for a resold-to company (`relationship` `resold` / `access_type` `passthrough`), that company's name where known. Maximum 255 characters.
103113
104114- `relationship: optional "external" or "resold" or "internal"`
105115
from line 123
113123
114124### Returns
115125
116- `BetaUserProfile object { id, created_at, metadata, 6 more }`
126- `BetaUserProfile object { id, created_at, metadata, 7 more }`
117127
118128 - `id: string`
119129
from line 137
127137
128138 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
129139
130 - `relationship: "external" or "resold" or "internal"`
131
132 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
133
134 - `"external"`
135
136 - `"resold"`
137
138 - `"internal"`
139
140140 - `trust_grants: map[BetaUserProfileTrustGrant]`
141141
142142 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 161
161161
162162 A timestamp in RFC 3339 format
163163
164 - `access_type: optional "application" or "passthrough"`
165
166 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
167
168 - `"application"`
169
170 - `"passthrough"`
171
164172 - `external_id: optional string or null`
165173
166174 Platform's own identifier for this user. Not enforced unique.
from line 175
167175
168176 - `name: optional string or null`
169177
170 Display name of the entity this profile represents. For `resold` this is the resold-to company's name.
178 Real-world name of the entity this profile represents (company or individual). For a resold-to company (`access_type` `passthrough`, or `relationship` `resold` under the `user-profiles-2026-03-24` header) this is that company's name.
171179
180 - `relationship: optional "external" or "resold" or "internal"`
181
182 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
183
184 - `"external"`
185
186 - `"resold"`
187
188 - `"internal"`
189
172190### Example
173191
174192```http
from line 193
175193curl https://api.anthropic.com/v1/user_profiles \
176194 -H 'Content-Type: application/json' \
177195 -H 'anthropic-version: 2023-06-01' \
178 -H 'anthropic-beta: user-profiles-2026-03-24' \
196 -H 'anthropic-beta: user-profiles-2026-08-18' \
179197 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
180198 -d '{
181199 "external_id": "user_12345",
from line 208
190208 "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
191209 "created_at": "2026-03-15T10:00:00Z",
192210 "metadata": {},
193 "relationship": "external",
194211 "trust_grants": {
195212 "cyber": {
196213 "status": "active"
from line 215
198215 },
199216 "type": "user_profile",
200217 "updated_at": "2026-03-15T10:00:00Z",
218 "access_type": "application",
201219 "external_id": "user_12345",
202 "name": "Example User"
220 "name": "Example User",
221 "relationship": "external"
203222}
204223```
205224
from line 254
235254
236255 - `string`
237256
238 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
257 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
239258
240259 - `"message-batches-2024-09-24"`
241260
from line 300
281300
282301 - `"user-profiles-2026-03-24"`
283302
303 - `"user-profiles-2026-08-18"`
304
284305 - `"advisor-tool-2026-03-01"`
285306
286307 - `"managed-agents-2026-04-01"`
from line 342
321342
322343 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
323344
324 - `relationship: "external" or "resold" or "internal"`
325
326 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
327
328 - `"external"`
329
330 - `"resold"`
331
332 - `"internal"`
333
334345 - `trust_grants: map[BetaUserProfileTrustGrant]`
335346
336347 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 366
355366
356367 A timestamp in RFC 3339 format
357368
369 - `access_type: optional "application" or "passthrough"`
370
371 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
372
373 - `"application"`
374
375 - `"passthrough"`
376
358377 - `external_id: optional string or null`
359378
360379 Platform's own identifier for this user. Not enforced unique.
from line 380
361380
362381 - `name: optional string or null`
363382
364 Display name of the entity this profile represents. For `resold` this is the resold-to company's name.
383 Real-world name of the entity this profile represents (company or individual). For a resold-to company (`access_type` `passthrough`, or `relationship` `resold` under the `user-profiles-2026-03-24` header) this is that company's name.
365384
385 - `relationship: optional "external" or "resold" or "internal"`
386
387 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
388
389 - `"external"`
390
391 - `"resold"`
392
393 - `"internal"`
394
366395- `next_page: string or null`
367396
368397 Cursor for the next page, or `null` when there are no more results.
from line 401
372401```http
373402curl https://api.anthropic.com/v1/user_profiles \
374403 -H 'anthropic-version: 2023-06-01' \
375 -H 'anthropic-beta: user-profiles-2026-03-24' \
404 -H 'anthropic-beta: user-profiles-2026-08-18' \
376405 -H "X-Api-Key: $ANTHROPIC_API_KEY"
377406```
378407
from line 414
385414 "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
386415 "created_at": "2026-03-15T10:00:00Z",
387416 "metadata": {},
388 "relationship": "external",
389417 "trust_grants": {
390418 "cyber": {
391419 "status": "active"
from line 421
393421 },
394422 "type": "user_profile",
395423 "updated_at": "2026-03-15T10:00:00Z",
424 "access_type": "application",
396425 "external_id": "user_12345",
397 "name": "Example User"
426 "name": "Example User",
427 "relationship": "external"
398428 }
399429 ],
400430 "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
from line 449
419449
420450 - `string`
421451
422 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
452 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
423453
424454 - `"message-batches-2024-09-24"`
425455
from line 495
465495
466496 - `"user-profiles-2026-03-24"`
467497
498 - `"user-profiles-2026-08-18"`
499
468500 - `"advisor-tool-2026-03-01"`
469501
470502 - `"managed-agents-2026-04-01"`
from line 521
489521
490522### Returns
491523
492- `BetaUserProfile object { id, created_at, metadata, 6 more }`
524- `BetaUserProfile object { id, created_at, metadata, 7 more }`
493525
494526 - `id: string`
495527
from line 535
503535
504536 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
505537
506 - `relationship: "external" or "resold" or "internal"`
507
508 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
509
510 - `"external"`
511
512 - `"resold"`
513
514 - `"internal"`
515
516538 - `trust_grants: map[BetaUserProfileTrustGrant]`
517539
518540 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 559
537559
538560 A timestamp in RFC 3339 format
539561
562 - `access_type: optional "application" or "passthrough"`
563
564 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
565
566 - `"application"`
567
568 - `"passthrough"`
569
540570 - `external_id: optional string or null`
541571
542572 Platform's own identifier for this user. Not enforced unique.
from line 573
543573
544574 - `name: optional string or null`
545575
546 Display name of the entity this profile represents. For `resold` this is the resold-to company's name.
576 Real-world name of the entity this profile represents (company or individual). For a resold-to company (`access_type` `passthrough`, or `relationship` `resold` under the `user-profiles-2026-03-24` header) this is that company's name.
547577
578 - `relationship: optional "external" or "resold" or "internal"`
579
580 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
581
582 - `"external"`
583
584 - `"resold"`
585
586 - `"internal"`
587
548588### Example
549589
550590```http
551591curl https://api.anthropic.com/v1/user_profiles/$USER_PROFILE_ID \
552592 -H 'anthropic-version: 2023-06-01' \
553 -H 'anthropic-beta: user-profiles-2026-03-24' \
593 -H 'anthropic-beta: user-profiles-2026-08-18' \
554594 -H "X-Api-Key: $ANTHROPIC_API_KEY"
555595```
556596
from line 601
561601 "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
562602 "created_at": "2026-03-15T10:00:00Z",
563603 "metadata": {},
564 "relationship": "external",
565604 "trust_grants": {
566605 "cyber": {
567606 "status": "active"
from line 608
569608 },
570609 "type": "user_profile",
571610 "updated_at": "2026-03-15T10:00:00Z",
611 "access_type": "application",
572612 "external_id": "user_12345",
573 "name": "Example User"
613 "name": "Example User",
614 "relationship": "external"
574615}
575616```
576617
from line 633
592633
593634 - `string`
594635
595 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
636 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
596637
597638 - `"message-batches-2024-09-24"`
598639
from line 679
638679
639680 - `"user-profiles-2026-03-24"`
640681
682 - `"user-profiles-2026-08-18"`
683
641684 - `"advisor-tool-2026-03-01"`
642685
643686 - `"managed-agents-2026-04-01"`
from line 705
662705
663706### Body Parameters
664707
708- `access_type: optional "application" or "passthrough" or null`
709
710 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
711
712 - `"application"`
713
714 - `"passthrough"`
715
665716- `external_id: optional string or null`
666717
667718 If present, replaces the stored external_id. Omit to leave unchanged. Maximum 255 characters.
from line 737
686737
687738### Returns
688739
689- `BetaUserProfile object { id, created_at, metadata, 6 more }`
740- `BetaUserProfile object { id, created_at, metadata, 7 more }`
690741
691742 - `id: string`
692743
from line 751
700751
701752 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
702753
703 - `relationship: "external" or "resold" or "internal"`
704
705 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
706
707 - `"external"`
708
709 - `"resold"`
710
711 - `"internal"`
712
713754 - `trust_grants: map[BetaUserProfileTrustGrant]`
714755
715756 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 775
734775
735776 A timestamp in RFC 3339 format
736777
778 - `access_type: optional "application" or "passthrough"`
779
780 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
781
782 - `"application"`
783
784 - `"passthrough"`
785
737786 - `external_id: optional string or null`
738787
739788 Platform's own identifier for this user. Not enforced unique.
from line 789
740789
741790 - `name: optional string or null`
742791
743 Display name of the entity this profile represents. For `resold` this is the resold-to company's name.
792 Real-world name of the entity this profile represents (company or individual). For a resold-to company (`access_type` `passthrough`, or `relationship` `resold` under the `user-profiles-2026-03-24` header) this is that company's name.
744793
794 - `relationship: optional "external" or "resold" or "internal"`
795
796 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
797
798 - `"external"`
799
800 - `"resold"`
801
802 - `"internal"`
803
745804### Example
746805
747806```http
from line 807
748807curl https://api.anthropic.com/v1/user_profiles/$USER_PROFILE_ID \
749808 -H 'Content-Type: application/json' \
750809 -H 'anthropic-version: 2023-06-01' \
751 -H 'anthropic-beta: user-profiles-2026-03-24' \
810 -H 'anthropic-beta: user-profiles-2026-08-18' \
752811 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
753812 -d '{
754813 "external_id": "user_12345"
from line 821
762821 "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
763822 "created_at": "2026-03-15T10:00:00Z",
764823 "metadata": {},
765 "relationship": "external",
766824 "trust_grants": {
767825 "cyber": {
768826 "status": "active"
from line 828
770828 },
771829 "type": "user_profile",
772830 "updated_at": "2026-03-15T10:00:00Z",
831 "access_type": "application",
773832 "external_id": "user_12345",
774 "name": "Example User"
833 "name": "Example User",
834 "relationship": "external"
775835}
776836```
777837
from line 853
793853
794854 - `string`
795855
796 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
856 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
797857
798858 - `"message-batches-2024-09-24"`
799859
from line 899
839899
840900 - `"user-profiles-2026-03-24"`
841901
902 - `"user-profiles-2026-08-18"`
903
842904 - `"advisor-tool-2026-03-01"`
843905
844906 - `"managed-agents-2026-04-01"`
from line 947
885947curl https://api.anthropic.com/v1/user_profiles/$USER_PROFILE_ID/enrollment_url \
886948 -X POST \
887949 -H 'anthropic-version: 2023-06-01' \
888 -H 'anthropic-beta: user-profiles-2026-03-24' \
950 -H 'anthropic-beta: user-profiles-2026-08-18' \
889951 -H "X-Api-Key: $ANTHROPIC_API_KEY"
890952```
891953
from line 965
903965
904966### Beta User Profile
905967
906- `BetaUserProfile object { id, created_at, metadata, 6 more }`
968- `BetaUserProfile object { id, created_at, metadata, 7 more }`
907969
908970 - `id: string`
909971
from line 979
917979
918980 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
919981
920 - `relationship: "external" or "resold" or "internal"`
921
922 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
923
924 - `"external"`
925
926 - `"resold"`
927
928 - `"internal"`
929
930982 - `trust_grants: map[BetaUserProfileTrustGrant]`
931983
932984 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 1003
9511003
9521004 A timestamp in RFC 3339 format
9531005
1006 - `access_type: optional "application" or "passthrough"`
1007
1008 How the platform uses the API on behalf of the entity this profile represents. `application`: the platform sells a product that uses the API behind the scenes, and the profile represents an individual end-user of that product. `passthrough`: the platform resells raw inference, and the profile identifies the resold-to company.
1009
1010 - `"application"`
1011
1012 - `"passthrough"`
1013
9541014 - `external_id: optional string or null`
9551015
9561016 Platform's own identifier for this user. Not enforced unique.
from line 1017
9571017
9581018 - `name: optional string or null`
9591019
960 Display name of the entity this profile represents. For `resold` this is the resold-to company's name.
1020 Real-world name of the entity this profile represents (company or individual). For a resold-to company (`access_type` `passthrough`, or `relationship` `resold` under the `user-profiles-2026-03-24` header) this is that company's name.
1021
1022 - `relationship: optional "external" or "resold" or "internal"`
1023
1024 How the entity behind a user profile relates to the platform that owns the API key. `external`: an individual end-user of the platform. `resold`: a company the platform resells Claude access to. `internal`: the platform's own usage.
1025
1026 - `"external"`
1027
1028 - `"resold"`
1029
1030 - `"internal"`
9611031
9621032### Beta User Profile Enrollment URL
9631033
No line in this hunk matches that.