List users | AskElephant

Returns workspace users using cursor pagination ordered by updated_at descending by default.

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

limitintegerOptional1-100Defaults to 25

Maximum number of results to return. Defaults to 25 and is capped at 100.

cursorstringOptional

Opaque cursor from a previous list response.

searchstringOptional

Free-text search string matched against user full names and email addresses. This does not search job titles, roles, or other profile fields.

order_byenumOptional

Sort order for the list. Defaults to updated_at:desc.

Allowed values:

filter[updated_at][gt]datetimeOptional

Return resources updated strictly after the provided ISO-8601 UTC timestamp.

filter[updated_at][gte]datetimeOptional

Return resources updated at or after the provided ISO-8601 UTC timestamp.

filter[updated_at][lt]datetimeOptional

Return resources updated strictly before the provided ISO-8601 UTC timestamp.

filter[updated_at][lte]datetimeOptional

Return resources updated at or before the provided ISO-8601 UTC timestamp.

X-Api-Versionstring

Paginated users list.

objectenum

Allowed values:

datalist of objects

has_moreboolean

next_cursorstring or null

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error

1	{
2	"object": "list",
3	"data": [
4	{
5	"object": "user",
6	"id": "usr_9X7aB3kLpQ",
7	"role": "OWNER",
8	"created_at": "2023-11-10T08:15:00Z",
9	"updated_at": "2024-04-20T14:45:00Z",
10	"first_name": "Emily",
11	"last_name": "Johnson",
12	"job_title": "Product Manager",
13	"emails": [
14	{
15	"email": "emily.johnson@askelephant.ai",
16	"is_primary": true
17	}
18	],
19	"time_zone": "America/New_York",
20	"last_activity_at": "2024-04-20T14:45:00Z"
21	}
22	],
23	"has_more": true,
24	"next_cursor": "eyJjdXJzb3IiOiJ1c3JfOXg3YUIza0xwUSJ9"
25	}

1	curl https://app.askelephant.ai/api/v2/users \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json"