Skip to content
API Documents/
/
/
Get sub users

Get sub users

Request

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.

Security
ApiKeyAuth
Query
parent_user_idinteger(id)

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

Example:parent_user_id=123
curl -i -X GET \
  'https://api.treasuredata.com/v3/sub_user/list?parent_user_id=123' \
  -H 'Authorization: TD1 <YOUR_TOKEN_HERE>'

Responses

OK

Bodyapplication/json
sub_usersArray of objects(Sub User)required
Response
{
  "sub_users": [
    { … }
  ]
}