Sign in
Sub Users

Get sub users

Retrieves the sub users the calling user may manage: every sub user in the account for an administrator, only the caller's own sub users otherwise. Sub users themselves are refused entirely.

get/sub_user/list

Query parameters

parent_user_idId — unresolved $ref

narrows the listing to the sub users of one owner. It can only narrow: what the caller may see is decided first, so a non-administrator naming another user gets an empty list rather than a wider one. The parameter is deliberately not called user_id, which means the sub user's own id here; note that this differs from GET /v4/api_keys, where user_id names the owner

Response

OK

Example response

{
  "sub_users": [
    {
      "id": 123,
      "assigned_policies": [
        {
          "id": 456
        }
      ],
      "effective_policies": [
        {
          "id": 456
        }
      ],
      "parent_user": {
        "id": 123
      }
    }
  ]
}

Changes