The whole hunk
from line 1, old and new numbered
/
lines
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}