TRtreasure
Sub Users

Get sub users

Changed on

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

Request

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

  • fb9de609df98Revision changes
    • breaking

      removed the required property // from the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

  • a6bfa4c037acRevision changes
    • info

      added the new optional query request parameter parent_user_id