Users

List users

Changed on

Returns the users of the organization named by x-organization-id, with search, sort and cursor pagination. Optionally narrow to a team within the org via ?property=teamId==<id>.

get/api/v3/users

Request

  • Base URL: https://fusion.adobe.io
  • URL: https://fusion.adobe.io/api/v3/users
  • Auth: HTTP bearer and API key in header x-organization-id and API key in header x-api-key and API key in header x-gw-region

Query parameters

propertystring[] 
Property filters. Can be repeated and are AND-ed together.

Allowed fields:
- id (multi-value)
- name
- email
- lastLogin
- teamId

Fields marked "multi-value" accept comma-separated values with == and !=.
Example: property=id==123,456

Supported operators:
- ==  (equals)
- !=  (not equals)
- >   (greater than)
- >=  (greater than or equal)
- <   (less than)
- <=  (less than or equal)
- ~   (case-insensitive regex match)

Special cases:
- field           → field exists
- !field          → field does not exist

[
  "teamId==3849"
]
startstring

Paging cursor. Must correspond to "orderby" field and used only when it is set.

limitinteger

Maximum number of items to return. Must be a positive integer. Range 1–200.

orderbystring
Example:+id

Sort property and direction, e.g. +id (ascending) or -id (descending). Allowed fields: id, name, email, lastLogin.

Headers

x-organization-idstring required

Response

Cursor-paginated users

Example response

{
  "_page": {
    "orderby": "+id",
    "start": "123",
    "next": "124",
    "count": 100
  },
  "_links": {
    "next": "/v3/{{resource}}?orderby=+id&start=123&property=teamId==304",
    "page": "/v3/{{resource}}{?orderby,start,limit,property,type}"
  },
  "items": [
    {
      "id": 42,
      "name": "Ada Lovelace",
      "email": "ada@example.com",
      "timezoneId": 1,
      "localeId": 1,
      "countryId": 1,
      "features": {},
      "avatar": "https://secure.gravatar.com/avatar/abc.jpg?d=mm"
    }
  ]
}

Changes