Update User Profile changedapi/beta/user_profiles/update
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+57added
Lines−38removed
From line
21
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits19to 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### Body Parameters
9395
96- `access_type: optional "application" or "passthrough" or null`
97
98 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.
99
100 - `"application"`
101
102 - `"passthrough"`
103
94104- `external_id: optional string or null`
95105
96106 If present, replaces the stored external_id. Omit to leave unchanged. Maximum 255 characters.
from line 125
115125
116126### Returns
117127
118- `BetaUserProfile object { id, created_at, metadata, 6 more }`
128- `BetaUserProfile object { id, created_at, metadata, 7 more }`
119129
120130 - `id: string`
121131
from line 139
129139
130140 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
131141
132 - `relationship: "external" or "resold" or "internal"`
133
134 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.
135
136 - `"external"`
137
138 - `"resold"`
139
140 - `"internal"`
141
142142 - `trust_grants: map[BetaUserProfileTrustGrant]`
143143
144144 Trust grants for this profile, keyed by grant name. Key omitted when no grant is active or in flight.
from line 163
163163
164164 A timestamp in RFC 3339 format
165165
166 - `access_type: optional "application" or "passthrough"`
167
168 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.
169
170 - `"application"`
171
172 - `"passthrough"`
173
166174 - `external_id: optional string or null`
167175
168176 Platform's own identifier for this user. Not enforced unique.
from line 177
169177
170178 - `name: optional string or null`
171179
172 Display name of the entity this profile represents. For `resold` this is the resold-to company's name.
180 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.
173181
182 - `relationship: optional "external" or "resold" or "internal"`
183
184 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.
185
186 - `"external"`
187
188 - `"resold"`
189
190 - `"internal"`
191
174192### Example
175193
176194```http
from line 195
177195curl https://api.anthropic.com/v1/user_profiles/$USER_PROFILE_ID \
178196 -H 'Content-Type: application/json' \
179197 -H 'anthropic-version: 2023-06-01' \
180 -H 'anthropic-beta: user-profiles-2026-03-24' \
198 -H 'anthropic-beta: user-profiles-2026-08-18' \
181199 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
182200 -d '{
183201 "external_id": "user_12345"
from line 209
191209 "id": "uprof_011CZkZCu8hGbp5mYRQgUmz9",
192210 "created_at": "2026-03-15T10:00:00Z",
193211 "metadata": {},
194 "relationship": "external",
195212 "trust_grants": {
196213 "cyber": {
197214 "status": "active"
from line 216
199216 },
200217 "type": "user_profile",
201218 "updated_at": "2026-03-15T10:00:00Z",
219 "access_type": "application",
202220 "external_id": "user_12345",
203 "name": "Example User"
221 "name": "Example User",
222 "relationship": "external"
204223}
205224```
206225
No line in this hunk matches that.