Get User Profile changedapi/beta/user_profiles/retrieve
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+27added
Lines−16removed
From line
21
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 21, old and new numbered
/
from line 21
2121
2222 - `string`
2323
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more`
2525
2626 - `"message-batches-2024-09-24"`
2727
from line 67
6767
6868 - `"user-profiles-2026-03-24"`
6969
70 - `"user-profiles-2026-08-18"`
71
7072 - `"advisor-tool-2026-03-01"`
7173
7274 - `"managed-agents-2026-04-01"`
from line 93
9193
9294### Returns
9395
94- `BetaUserProfile object { id, created_at, metadata, 6 more }`
96- `BetaUserProfile object { id, created_at, metadata, 7 more }`
9597
9698 - `id: string`
9799
from line 107
105107
106108 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
107109
108 - `relationship: "external" or "resold" or "internal"`
109
110 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.
111
112 - `"external"`
113
114 - `"resold"`
115
116 - `"internal"`
117
118110 - `trust_grants: map[BetaUserProfileTrustGrant]`
119111
120112 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 131
139131
140132 A timestamp in RFC 3339 format
141133
134 - `access_type: optional "application" or "passthrough"`
135
136 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.
137
138 - `"application"`
139
140 - `"passthrough"`
141
142142 - `external_id: optional string or null`
143143
144144 Platform's own identifier for this user. Not enforced unique.
from line 145
145145
146146 - `name: optional string or null`
147147
148 Display name of the entity this profile represents. For `resold` this is the resold-to company's name.
148 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.
149149
150 - `relationship: optional "external" or "resold" or "internal"`
151
152 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.
153
154 - `"external"`
155
156 - `"resold"`
157
158 - `"internal"`
159
150160### Example
151161
152162```http
153163curl https://api.anthropic.com/v1/user_profiles/$USER_PROFILE_ID \
154164 -H 'anthropic-version: 2023-06-01' \
155 -H 'anthropic-beta: user-profiles-2026-03-24' \
165 -H 'anthropic-beta: user-profiles-2026-08-18' \
156166 -H "X-Api-Key: $ANTHROPIC_API_KEY"
157167```
158168
from line 173
163173 "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
164174 "created_at": "2026-03-15T10:00:00Z",
165175 "metadata": {},
166 "relationship": "external",
167176 "trust_grants": {
168177 "cyber": {
169178 "status": "active"
from line 180
171180 },
172181 "type": "user_profile",
173182 "updated_at": "2026-03-15T10:00:00Z",
183 "access_type": "application",
174184 "external_id": "user_12345",
175 "name": "Example User"
185 "name": "Example User",
186 "relationship": "external"
176187}
177188```
178189
No line in this hunk matches that.