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, query): Permission to grant. One of “read”, “write”, “delete”, “share”.
- dataset_ids (List[UUID], JSON body): Array 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
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Query Parameters
Permission to grant. One of 'read', 'write', 'delete', 'share'.
Example:
"read"
Body
application/json
Example:
Response
Successful Response
Previous
Revoke Datasets Permission From PrincipalRevoke permission on datasets from a principal (user or role).
## Path Parameters
- **principal_id** (UUID): The UUID of the principal to revoke permission from
## Request Parameters
- **permission_name** (str): The name of the permission to revoke (e.g., "read", "write", "delete")
- **dataset_ids** (List[UUID]): List of dataset UUIDs to revoke permission on
Next
Give Datasets Permission To Principal