List users

GET /v1/users

Returns every user that is a member of the team the API key is bound to, ordered by name. Use this to discover valid assigneeIds values for Create a task.

Request

This endpoint takes no query parameters or body.

Response

200 OK — array of user objects:

Field	Type	Description
id	string	User ID (UUID). Pass this as assigneeIds[] items.
name	string	User’s display name.
email	string	User’s email address.
image	string | null	URL of the user’s avatar image, or null.
role	string	Team role: owner, admin, or member.

Example response

[
  {
    "id": "u_abc123",
    "name": "Tom",
    "email": "tom@example.com",
    "image": "https://orsane.app/avatars/u_abc123.png",
    "role": "owner"
  },
  {
    "id": "u_def456",
    "name": "Sara",
    "email": "sara@example.com",
    "image": null,
    "role": "member"
  }
]