Users

note

Different from contacts. See glossary.

Users are not directly managed by Airy. Instead, users are managed by an authentication provider and whenever a user interacts with Airy their profile is presented in this API.

List

This is a paginated endpoint.

POST /users.list

Sample request

{
  "cursor": "next-cursor",
  "page_size": 2
}

Sample Response

{
  "data": [
    {
      "id": "user-id",
      "first_seen_at": "2022-01-11T16:07:23.602Z",
      "last_seen_at": "2022-01-12T16:07:23.602Z",
      "name": "Barbara Liskov", // optional
      "avatar_url": "http://example.org/profile.jpg" // optional
    },
    {
      "id": "user-id",
      "first_seen_at": "2022-01-11T16:07:23.602Z",
      "last_seen_at": "2022-01-12T16:07:23.602Z",
      "name": "Ada Lovelace"
    }
  ],
  "pagination_data": {
    "previous_cursor": null,
    "next_cursor": "2",
    "total": 104
  }
}