Follow Discord
Sweep 22 Oct 2026 · 21:04Z Build v2.1.309 528 read Stable v2.1.308 Latest v2.1.309 Next v2.1.309 Feeds RSS JSON llms.txt llms-full.txt Unofficial
One change · api

Users changedapi/admin/users

Nearest release: v2.1.245, published 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+40added
Lines−33removed
From line 1 where the diff opens
First seen 14 Aug 2026 this site's first read of the page
Recorded edits5to this page, all time

### Path parameters #### Response (200) ### Query parameters #### Response (200) ### Path parameters ### Body parameters #### Response (200) ### Path parameters #### Response (200) ## Domain types ### Path Parameters #### Response ### Query Parameters #### Response ### Path Parameters ### Body Parameters #### Response ### Path Parameters #### Response ## Domain Types

The whole hunk

from line 1, old and new numbered
/
lines
from line 1
1---
2title: Users
3url: https://platform.claude.com/docs/en/api/admin/users
4---
5 
61# Users
72 
83## Get User
94 
10**get** `/v1/organizations/users/{user_id}`
5**GET** `/v1/organizations/users/{user_id}`
116 
127For Claude Enterprise organizations, this endpoint's availability is in beta.
138 
14### Path Parameters
9### Path parameters
1510 
1611- `user_id: string`
1712 
from line 14
1914 
2015### Returns
2116 
22- `User object { id, added_at, email, 3 more }`
17- `User object`
2318 
2419 - `id: string`
2520 
from line 24
2924 
3025 RFC 3339 datetime string indicating when the User joined the Organization.
3126 
27 format: date-time
28 
3229 - `email: string`
3330 
3431 Email of the User.
from line 62
6562 
6663 For Users, this is always `"user"`.
6764 
68 - `"user"`
65 default: user
6966 
7067### Example
7168 
72```http
69```bash
7370curl https://api.anthropic.com/v1/organizations/users/$USER_ID \
7471 -H 'anthropic-version: 2023-06-01' \
7572 -H "Authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"
7673```
7774 
78#### Response
75#### Response (200)
7976 
8077```json
8178{
from line 87
9087 
9188## List Users
9289 
93**get** `/v1/organizations/users`
90**GET** `/v1/organizations/users`
9491 
9592For Claude Enterprise organizations, this endpoint's availability is in beta.
9693 
97### Query Parameters
94### Query parameters
9895 
9996- `after_id: optional string`
10097 
from line 105
108105 
109106 Filter by user email.
110107 
108 format: email
109 
111110- `limit: optional number`
112111 
113112 Number of items to return per page.
from line 113
114113 
115114 Defaults to `20`. Ranges from `1` to `1000`.
116115 
116 default: 20, maximum: 1000, minimum: 1
117 
117118- `roles: optional array of string`
118119 
119120 Filter to items whose `role` equals one of the supplied values. Repeatable; values are OR'ed together.
from line 133
132133 
133134 RFC 3339 datetime string indicating when the User joined the Organization.
134135 
136 format: date-time
137 
135138 - `email: string`
136139 
137140 Email of the User.
from line 171
168171 
169172 For Users, this is always `"user"`.
170173 
171 - `"user"`
174 default: user
172175 
173176- `first_id: string or null`
174177 
from line 187
184187 
185188### Example
186189 
187```http
190```bash
188191curl https://api.anthropic.com/v1/organizations/users \
189192 -H 'anthropic-version: 2023-06-01' \
190193 -H "Authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"
191194```
192195 
193#### Response
196#### Response (200)
194197 
195198```json
196199{
from line 215
212215 
213216## Update User
214217 
215**post** `/v1/organizations/users/{user_id}`
218**POST** `/v1/organizations/users/{user_id}`
216219 
217220For Claude Enterprise organizations, this endpoint's availability is in beta.
218221 
219### Path Parameters
222### Path parameters
220223 
221224- `user_id: string`
222225 
223226 ID of the User.
224227 
225### Body Parameters
228### Body parameters
226229 
227230- `role: "billing" or "claude_code_user" or "developer" or 2 more`
228231 
from line 245
242245 
243246### Returns
244247 
245- `User object { id, added_at, email, 3 more }`
248- `User object`
246249 
247250 - `id: string`
248251 
from line 255
252255 
253256 RFC 3339 datetime string indicating when the User joined the Organization.
254257 
258 format: date-time
259 
255260 - `email: string`
256261 
257262 Email of the User.
from line 293
288293 
289294 For Users, this is always `"user"`.
290295 
291 - `"user"`
296 default: user
292297 
293298### Example
294299 
295```http
300```bash
296301curl https://api.anthropic.com/v1/organizations/users/$USER_ID \
297302 -H 'Content-Type: application/json' \
298303 -H 'anthropic-version: 2023-06-01' \
from line 307
302307 }'
303308```
304309 
305#### Response
310#### Response (200)
306311 
307312```json
308313{
from line 322
317322 
318323## Remove User
319324 
320**delete** `/v1/organizations/users/{user_id}`
325**DELETE** `/v1/organizations/users/{user_id}`
321326 
322327For Claude Enterprise organizations, this endpoint's availability is in beta.
323328 
324### Path Parameters
329### Path parameters
325330 
326331- `user_id: string`
327332 
from line 344
339344 
340345 For Users, this is always `"user_deleted"`.
341346 
342 - `"user_deleted"`
347 default: user_deleted
343348 
344349### Example
345350 
346```http
351```bash
347352curl https://api.anthropic.com/v1/organizations/users/$USER_ID \
348353 -X DELETE \
349354 -H 'anthropic-version: 2023-06-01' \
from line 355
350355 -H "Authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"
351356```
352357 
353#### Response
358#### Response (200)
354359 
355360```json
356361{
from line 364
359364}
360365```
361366 
362## Domain Types
367## Domain types
363368 
364369### User
365370 
366- `User object { id, added_at, email, 3 more }`
371- `User object`
367372 
368373 - `id: string`
369374 
from line 378
373378 
374379 RFC 3339 datetime string indicating when the User joined the Organization.
375380 
381 format: date-time
382 
376383 - `email: string`
377384 
378385 Email of the User.
from line 416
409416 
410417 For Users, this is always `"user"`.
411418 
412 - `"user"`
419 default: user
413420 
414421### User Delete Response
415422 
416- `UserDeleteResponse object { id, type }`
423- `UserDeleteResponse object`
417424 
418425 - `id: string`
419426 
from line 432
425432 
426433 For Users, this is always `"user_deleted"`.
427434 
428 - `"user_deleted"`
435 default: user_deleted
429436 
Feedback