For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Add a new member to the workspace with specified roles.
This creates role bindings for the specified principal with the given roles.
By default, this endpoint waits for the roles to propagate before returning.
Use wait_role_propagation=false to skip waiting (useful for bulk operations).
Example:
POST /apis/entities/v2/workspaces/ml-team/members
{
"principal": "user@example.com",
"roles": ["Editor"]
}
Path parameters
workspacestringRequired
Query parameters
wait_role_propagationbooleanOptionalDefaults to true
If true, wait for roles to propagate before returning (default: true). Set to false for bulk operations.
Request
This endpoint expects an object.
principalstringRequired
The principal identifier (email, user ID, or group ID)
roleslist of stringsOptionalDefaults to ["Editor"]
List of roles to grant to the principal
Response
Successful Response
principalstring
The principal identifier
roleslist of strings
List of roles granted to the principal
granted_atdatetimeOptional
Earliest date when a role was granted to this principal
