List role bindings

GET

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

List all role bindings (Platform Admin only)

pageintegerOptionalDefaults to 1

Page number.

page_sizeintegerOptionalDefaults to 10

Page size.

sortstringOptionalDefaults to created_at

The field to sort by. To sort in decreasing order, use - in front of the field name.

filterobjectOptional

Filter role bindings by principal, workspace, role, granted_by, is_active, granted_at, and revoked_at.

Successful Response

datalist of objects

paginationobject

Pagination information.

sortstring

The field on which the results are sorted.

filtermap from strings to any

Filtering information.

422

Unprocessable Entity Error

1	{
2	"data": [
3	{
4	"id": "rb-9f8c7d6e5b4a3c2d1e0f",
5	"name": "Workspace Admin Binding",
6	"principal": "user-123e4567-e89b-12d3-a456-426614174000",
7	"workspace": "workspace-9876abcd-4321-efgh-5678-ijklmnopqrst",
8	"role": "admin",
9	"granted_by": "user-abcdef12-3456-7890-abcd-ef1234567890",
10	"granted_at": "2024-01-15T09:30:00Z",
11	"revoked_at": "2024-02-20T17:45:00Z"
12	}
13	],
14	"pagination": {
15	"page": 1,
16	"page_size": 10,
17	"current_page_size": 1,
18	"total_pages": 1,
19	"total_results": 1
20	},
21	"sort": "created_at",
22	"filter": {}
23	}

$	curl https://host.com/apis/auth/v2/iam/role-bindings \
>	-H "Content-Type: application/json"