permissions
Give Datasets Permission To Principal
Grant permission on datasets to a principal (user or role).
This endpoint allows granting specific permissions on one or more datasets to a principal (which can be a user or role). The authenticated user must have appropriate permissions to grant access to the specified datasets.
Path Parameters
- principal_id (UUID): The UUID of the principal (user or role) to grant permission to
Request Parameters
- permission_name (str): The name of the permission to grant (e.g., “read”, “write”, “delete”)
- dataset_ids (List[UUID]): List of dataset UUIDs to grant permission on
Response
Returns a success message indicating permission was assigned.
Error Codes
- 400 Bad Request: Invalid request parameters
- 403 Forbidden: User doesn’t have permission to grant access
- 500 Internal Server Error: Error granting permission
POST
Give Datasets Permission To Principal
Path Parameters
Query Parameters
Body
application/json · string<uuid>[]
The body is of type string<uuid>[].
Response
200
application/json
Successful Response
The response is of type any.
Previous
Create RoleCreate a new role.
This endpoint creates a new role with the specified name. Roles are used
to group permissions and can be assigned to users to manage access control
more efficiently. The authenticated user becomes the owner of the created role.
## Request Parameters
- **role_name** (str): The name of the role to create
## Response
Returns a success message indicating the role was created.
## Error Codes
- **400 Bad Request**: Invalid role name or role already exists
- **500 Internal Server Error**: Error creating the role
Next
Give Datasets Permission To Principal