Users

Manage users and authentication

The Users API allows you to manage user accounts.

List Users

GET /users

Example:

curl "https://your-directus-instance.com/users" \
  -H "Authorization: Bearer YOUR_TOKEN"

Get User

GET /users/:id

Get Current User

GET /users/me

Create User

POST /users

Request Body:

{
  "email": "[e-mail]",
  "password": "secure-password",
  "role": "role-uuid",
  "first_name": "John",
  "last_name": "Doe"
}

Update User

PATCH /users/:id

Delete User

DELETE /users/:id

Invite User

Send an invitation email:

POST /users/invite

Request Body:

{
  "email": "[e-mail]",
  "role": "role-uuid"
}

User Properties

id · string

User UUID

email · string

Email address

first_name · string

First name

last_name · string

Last name

role · string

Role UUID

status · string

User status: active, invited, draft, suspended, archived

Next Steps

Roles

Manage roles

Permissions

Manage permissions