Skip to main content

Deprecated v1 Directory APIs

Note

These APIs have been deprecated and replaced by the Directory v2 graphQL APIs.

The Authorizer makes two APIs available to the calling application for the purpose of interacting with the Edge Directory Service:

  • dir/users
  • dir/users/\{id\}

Each of these APIs is a GET style API.

dir/users​

GET .../api/v1/dir/users?params

This will return a list of all users in the system.

parameters​

  • page.size=<number>: the number of results to return in a page
  • page.token=<token>: a token to use as the beginning of the next page (obtained from a previous call)
  • fields.mask=<field1>,<field2>: the set of fields to return (defaults to ALL if unspecified)

results​

{
  "page": {
    "nextToken": "string",
    "resultSize": 0,
    "totalSize": 0
  },
  "results": [
    { ... user info },
  ]
}

dir/users/{id}​

GET .../api/v1/dir/users/\{id\}?params

This will return the details of a user entry in the Edge Directory Service, by its ID.

parameters​

  • fields.mask=<field1>,<field2>: the set of fields to return (defaults to ALL if unspecified)

results​

{
  "result": {
    "displayName": "string",
    "email": "string",
    "enabled": true,
    "id": "string",
    "identities": {
      "additionalProp3": {
        "kind": "IDENTITY_KIND_UNKNOWN",
        "provider": "string",
        "verified": true
      }
    },
    "metadata": {
      "createdAt": "2021-05-22T02:23:06.199Z",
      "updatedAt": "2021-05-22T02:23:06.199Z"
    },
    "picture": "string",
    ...
  }
}