One change

Users

api/admin/users

25 Aug 2026 03:37 UTC first seen 14 Aug 2026 The page's own history The capture it came from

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.

api/admin/users Changed · +40 / -33 lines

### 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

from line 1

----
-title: Users
-url: https://platform.claude.com/docs/en/api/admin/users
----
-
 # Users
 
 ## Get User
 
-**get** `/v1/organizations/users/{user_id}`
+**GET** `/v1/organizations/users/{user_id}`
 
 For Claude Enterprise organizations, this endpoint's availability is in beta.
 
-### Path Parameters
+### Path parameters
 
 - `user_id: string`

from line 14

 
 ### Returns
 
-- `User object { id, added_at, email, 3 more }`
+- `User object`
 
   - `id: string`

from line 24

 
     RFC 3339 datetime string indicating when the User joined the Organization.
 
+    format: date-time
+
   - `email: string`
 
     Email of the User.

from line 62

 
     For Users, this is always `"user"`.
 
-    - `"user"`
+    default: user
 
 ### Example
 
-```http
+```bash
 curl https://api.anthropic.com/v1/organizations/users/$USER_ID \
     -H 'anthropic-version: 2023-06-01' \
     -H "Authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"
 ```
 
-#### Response
+#### Response (200)
 
 ```json
 {

from line 87

 
 ## List Users
 
-**get** `/v1/organizations/users`
+**GET** `/v1/organizations/users`
 
 For Claude Enterprise organizations, this endpoint's availability is in beta.
 
-### Query Parameters
+### Query parameters
 
 - `after_id: optional string`

from line 105

 
   Filter by user email.
 
+  format: email
+
 - `limit: optional number`
 
   Number of items to return per page.

from line 113

 
   Defaults to `20`. Ranges from `1` to `1000`.
 
+  default: 20, maximum: 1000, minimum: 1
+
 - `roles: optional array of string`
 
   Filter to items whose `role` equals one of the supplied values. Repeatable; values are OR'ed together.

from line 133

 
     RFC 3339 datetime string indicating when the User joined the Organization.
 
+    format: date-time
+
   - `email: string`
 
     Email of the User.

from line 171

 
     For Users, this is always `"user"`.
 
-    - `"user"`
+    default: user
 
 - `first_id: string or null`

from line 187

 
 ### Example
 
-```http
+```bash
 curl https://api.anthropic.com/v1/organizations/users \
     -H 'anthropic-version: 2023-06-01' \
     -H "Authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"
 ```
 
-#### Response
+#### Response (200)
 
 ```json
 {

from line 215

 
 ## Update User
 
-**post** `/v1/organizations/users/{user_id}`
+**POST** `/v1/organizations/users/{user_id}`
 
 For Claude Enterprise organizations, this endpoint's availability is in beta.
 
-### Path Parameters
+### Path parameters
 
 - `user_id: string`
 
   ID of the User.
 
-### Body Parameters
+### Body parameters
 
 - `role: "billing" or "claude_code_user" or "developer" or 2 more`

from line 245

 
 ### Returns
 
-- `User object { id, added_at, email, 3 more }`
+- `User object`
 
   - `id: string`

from line 255

 
     RFC 3339 datetime string indicating when the User joined the Organization.
 
+    format: date-time
+
   - `email: string`
 
     Email of the User.

from line 293

 
     For Users, this is always `"user"`.
 
-    - `"user"`
+    default: user
 
 ### Example
 
-```http
+```bash
 curl https://api.anthropic.com/v1/organizations/users/$USER_ID \
     -H 'Content-Type: application/json' \
     -H 'anthropic-version: 2023-06-01' \

from line 307

         }'
 ```
 
-#### Response
+#### Response (200)
 
 ```json
 {

from line 322

 
 ## Remove User
 
-**delete** `/v1/organizations/users/{user_id}`
+**DELETE** `/v1/organizations/users/{user_id}`
 
 For Claude Enterprise organizations, this endpoint's availability is in beta.
 
-### Path Parameters
+### Path parameters
 
 - `user_id: string`

from line 344

 
   For Users, this is always `"user_deleted"`.
 
-  - `"user_deleted"`
+  default: user_deleted
 
 ### Example
 
-```http
+```bash
 curl https://api.anthropic.com/v1/organizations/users/$USER_ID \
     -X DELETE \
     -H 'anthropic-version: 2023-06-01' \

from line 355

     -H "Authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"
 ```
 
-#### Response
+#### Response (200)
 
 ```json
 {

from line 364

 }
 ```
 
-## Domain Types
+## Domain types
 
 ### User
 
-- `User object { id, added_at, email, 3 more }`
+- `User object`
 
   - `id: string`

from line 378

 
     RFC 3339 datetime string indicating when the User joined the Organization.
 
+    format: date-time
+
   - `email: string`
 
     Email of the User.

from line 416

 
     For Users, this is always `"user"`.
 
-    - `"user"`
+    default: user
 
 ### User Delete Response
 
-- `UserDeleteResponse object { id, type }`
+- `UserDeleteResponse object`
 
   - `id: string`

from line 432

 
     For Users, this is always `"user_deleted"`.
 
-    - `"user_deleted"`
+    default: user_deleted