On this page

    Delete Role

    Note:
    Version Requirement:

    This functionality is for Dremio v18.0+ Enterprise Edition only.

    This API deletes a role with via an ID.

    Endpoint Syntax

    DELETE /api/v3/role/{id}
    

    Required Privileges

    All users executing this Rest API must have the MANAGE GRANTS privilege assigned to receive a response output.

    Response Output

    This is the standard response output for the API.

    {"data": [
      {
       "name": "src1.folder1.db1",
       "type": "dataset",
       "privilege": "SELECT"
      },
        
      ]
     }
    

    Response Codes

    • 204 - Successful if all operations are successful.
    • 403 - The user executing the API request lacks the MANAGE GRANTS permission.
    • 404 - The role is not found.

    Example

    curl -X DELETE --location "http://localhost:9047/api/v3/role/aa6d94e6-8cb7-4331-a881-e24945d74ad1" \
        -H "Authorization: _dremiopu2916f7aph06aahv4ksu4life" \
        -H "Content-Type: application/json" \
        -H "Accept: application/json"