Create role binding

POST

https://host.com/apis/auth/v2/iam/role-bindings

Create a new role binding (Platform Admin only)

wait_role_propagationbooleanOptionalDefaults to true

If true, wait for role to propagate before returning (default: true). Set to false for bulk operations.

This endpoint expects an object.

principalstringRequired

The principal identifier (email, user ID, or group ID)

rolestringRequired

The role name (e.g., ‘Viewer’, ‘Editor’, ‘Admin’)

workspacestringOptional

The workspace this binding applies to. None for platform-level roles.

Successful Response

idstring

namestring

principalstring

workspacestring

rolestring

granted_bystring

granted_atdatetime

revoked_atdatetime

422

Unprocessable Entity Error

$	curl -X POST https://host.com/apis/auth/v2/iam/role-bindings \
>	-H "Content-Type: application/json" \
>	-d '{
>	"principal": "jane.doe@example.com",
>	"role": "Admin"
>	}'

1	{
2	"id": "rb-123e4567-e89b-12d3-a456-426614174000",
3	"name": "Admin Role Binding for Jane Doe",
4	"principal": "jane.doe@example.com",
5	"workspace": "platform",
6	"role": "Admin",
7	"granted_by": "platform.admin@example.com",
8	"granted_at": "2024-01-15T09:30:00Z",
9	"revoked_at": "2024-12-31T23:59:59Z"
10	}