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
No line in this hunk matches that.