Dremio Cloud
Dremio Software
 
On this page

    View a User

    This API retrieves a specific user’s information.

    Only users with administrator privileges can use the accounts API.

    Note:

    You must enable Personal Access Tokens to successfully call this API.

    Syntax

    Operation URI
    Get a user by name GET /api/v3/user/by-name/{name}
    Get a user by id GET /api/v3/user/{id}

    Response Output

    Dremio user output in JSON:

    Response output 
    {
  "id": String [immutable, generated by Dremio],
  "name": String
}
    Name Type Description
    id String User ID. Generated by Dremio, immutable.
    name String Name of the user.

    Response Codes

    403 - user does not have permission (has to be an administrator).
    404 - user could not be found.

    Example: Get user information

    In the following examples, a Dremio Admin retrieves the user information by their username, cdarling and by their ID.

    Curl Request

    curl request example: User name 
    curl -X GET \
	http://localhost:9047/api/v3/user/by-name/cdarling \
	-H "Content-Type: application/json" \
	-H "Authorization: _dremiohs85l11k2mh0b10l51ett9fsca"

    Alternatively, you can access the user information by the user ID.

    curl request example: User ID 
    curl -X GET \
	http://localhost:9047/api/v3/user/6be1a04a-f0bb-4ea8-a4f3-f86bf5e02bec \
	-H "Content-Type: application/json" \
	-H "Authorization: _dremiomn9i63s3r6sokad6hoif2j7730"

    Response

    The response body includes the username and their user ID.

    Response body 
    {
  "id": "6be1a04a-f0bb-4ea8-a4f3-f86bf5e02bec",
  "name": "cdarling"
}