List organization roles

GET

/workos/roles

Lists the product role slugs for the caller's organization, shaped for the role picker.

AuthorizationBearer

WorkOS session JWT or an organization API key, sent as Authorization: Bearer <token>.

The organization's product roles.

roleslist of objects

400

Bad Request Error

401

Unauthorized Error

1	{
2	"roles": [
3	{
4	"id": "role_8f3b2c1d",
5	"slug": "admin",
6	"name": "Administrator",
7	"description": "Full access to all system features and settings."
8	},
9	{
10	"id": "role_4a7d9e2f",
11	"slug": "editor",
12	"name": "Editor",
13	"description": "Can create and modify content but cannot change system settings."
14	},
15	{
16	"id": "role_1c9e5b7a",
17	"slug": "viewer",
18	"name": "Viewer",
19	"description": "Read-only access to view content and reports."
20	}
21	]
22	}

1	curl https:/https://api/workos/roles \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json"