Update User Profile changedapi/beta/user_profiles/update
Nearest release: v2.1.268, 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+125added
Lines−7removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits23to this page, all time
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Update User Profile
3url: https://platform.claude.com/docs/en/api/beta/user_profiles/update
4---
5
16# Update User Profile
27
38**POST** `/v1/user_profiles/{user_profile_id}`
from line 21
1621
1722 - `string`
1823
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2025
2126 - `"message-batches-2024-09-24"`
2227
from line 69
6469
6570 - `"user-profiles-2026-08-18"`
6671
72 - `"user-profiles-2026-09-04"`
73
6774 - `"advisor-tool-2026-03-01"`
6875
6976 - `"managed-agents-2026-04-01"`
from line 125
118125
119126- `external_id: optional string or null`
120127
121 If present, replaces the stored external_id. Omit to leave unchanged. Maximum 255 characters.
128 If present, replaces the stored external_id. Omit to leave unchanged. Maximum 255 characters. Accepted under the `user-profiles-2026-03-24` and `user-profiles-2026-08-18` beta headers; under `user-profiles-2026-09-04` send `external_user_details.reference_id` instead.
122129
123130 minLength: 1, maxLength: 255
124131
132- `external_user_details: optional BetaUserProfileExternalUserDetailsParams`
133
134 Details about the entity this profile represents, as the platform states them. Each field sent replaces the stored value; omit a field to leave it unchanged. Once set, a value cannot be cleared and `null` is rejected. Accepted under the `user-profiles-2026-09-04` beta header only.
135
136 - `account_status: optional "active" or "suspended" or "blocked" or null`
137
138 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
139
140 - `"active"`
141
142 - `"suspended"`
143
144 - `"blocked"`
145
146 - `country: optional string or null`
147
148 The country of the entity (not of the platform), as the platform determines it: an ISO 3166-1 alpha-2 code in upper case, for example `US`. Only the form, two uppercase ASCII letters, is checked.
149
150 - `email_hash: optional string or null`
151
152 A hash of the entity's email address, computed by the platform. Anthropic treats it as an opaque string and does not prescribe the hash function. 1 to 255 characters.
153
154 minLength: 1, maxLength: 255
155
156 - `entity_type: optional "individual" or "business" or "non_profit" or "government" or null`
157
158 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
159
160 - `"individual"`
161
162 - `"business"`
163
164 - `"non_profit"`
165
166 - `"government"`
167
168 - `name_hash: optional string or null`
169
170 A hash of the entity's name, computed by the platform. Anthropic treats it as an opaque string and does not prescribe the hash function. 1 to 255 characters.
171
172 minLength: 1, maxLength: 255
173
174 - `onboarded_at: optional string`
175
176 A timestamp in RFC 3339 format
177
178 format: date-time
179
180 - `reference_id: optional string or null`
181
182 The platform's own reference for the entity, for example the key of the end-user's row in the platform's database. Not interpreted by Anthropic and not enforced unique. 1 to 255 characters.
183
184 minLength: 1, maxLength: 255
185
125186- `external_user_onboarded_at: optional string`
126187
127188 A timestamp in RFC 3339 format
from line 203
142203
143204- `BetaUserProfile object`
144205
206 - `type: "user_profile"`
207
208 Object type. Always `user_profile`.
209
145210 - `id: string`
146211
147212 Unique identifier for this user profile, prefixed `uprof_`.
from line 235
170235
171236 - `"rejected"`
172237
173 - `type: "user_profile"`
174
175 Object type. Always `user_profile`.
176
177238 - `updated_at: string`
178239
179240 A timestamp in RFC 3339 format
from line 251
190251
191252 - `external_id: optional string or null`
192253
193 Platform's own identifier for this user. Not enforced unique.
254 Platform's own identifier for this user. Not enforced unique. Present under the `user-profiles-2026-03-24` and `user-profiles-2026-08-18` beta headers; under `user-profiles-2026-09-04` the value is `external_user_details.reference_id`.
194255
256 - `external_user_details: optional BetaUserProfileExternalUserDetails`
257
258 Details about the entity this profile represents, as the platform states them. Anthropic does not verify them. Every field is present, `null` until the platform supplies a value.
259
260 - `account_status: "active" or "suspended" or "blocked" or null`
261
262 The status of the entity's account on the platform, as the platform states it: `active`; `suspended`, when the platform has restricted the account and may restore it; or `blocked`, when the platform has barred it. It records the platform's decision only; the statuses in `trust_grants` are Anthropic's and do not follow it.
263
264 - `"active"`
265
266 - `"suspended"`
267
268 - `"blocked"`
269
270 - `country: string or null`
271
272 The country the platform associates with the entity, as an ISO 3166-1 alpha-2 code. `null` until the platform supplies one.
273
274 - `email_hash: string or null`
275
276 The platform-computed hash of the entity's email address. `null` until the platform supplies one.
277
278 - `entity_type: "individual" or "business" or "non_profit" or "government" or null`
279
280 What kind of entity the profile represents, as the platform states it: `individual`, `business`, `non_profit` or `government`.
281
282 - `"individual"`
283
284 - `"business"`
285
286 - `"non_profit"`
287
288 - `"government"`
289
290 - `name_hash: string or null`
291
292 The platform-computed hash of the entity's name. `null` until the platform supplies one.
293
294 - `onboarded_at: string or null`
295
296 A timestamp in RFC 3339 format
297
298 format: date-time
299
300 - `reference_id: string or null`
301
302 The platform's own reference for the entity. `null` until the platform supplies one.
303
195304 - `external_user_onboarded_at: optional string or null`
196305
197306 A timestamp in RFC 3339 format
from line 340
231340 "updated_at": "2026-03-15T10:00:00Z",
232341 "access_type": "application",
233342 "external_id": "user_12345",
343 "external_user_details": {
344 "account_status": "active",
345 "country": "country",
346 "email_hash": "email_hash",
347 "entity_type": "individual",
348 "name_hash": "name_hash",
349 "onboarded_at": "2019-12-27T18:11:19.117Z",
350 "reference_id": "reference_id"
351 },
234352 "external_user_onboarded_at": "2024-11-02T08:15:00Z",
235353 "name": "Example User"
236354}
No line in this hunk matches that.