Get all space roles

GET

https://api.contentful.com/organizations/:organization_id/roles

GET

/organizations/:organization_id/roles

$ curl -G https://api.contentful.com/organizations/4EJGvuLTBUMG2A6wS8gfAS/roles \
>      -H "Authorization: Bearer <token>" \
>      -d skip=0 \
>      -d limit=25 \
>      -d include=sys.space

200Space Roles_getAllSpaceRoles_example

1 {
2   "total": 2,
3   "limit": 25,
4   "skip": 0,
5   "sys": {
6     "type": "Array"
7   },
8   "items": [
9     {
10       "name": "Developer",
11       "description": "Allows reading Entries and managing API Keys",
12       "policies": [
13         {
14           "effect": "allow",
15           "actions": [
16             "read"
17           ],
18           "constraint": {
19             "and": [
20               {
21                 "equals": [
22                   {
23                     "doc": "sys.type"
24                   },
25                   "Entry"
26                 ]
27               }
28             ]
29           }
30         }
31       ],
32       "permissions": {
33         "ContentModel": [
34           "read"
35         ],
36         "Settings": [],
37         "ContentDelivery": "all"
38       },
39       "sys": {
40         "type": "Role",
41         "id": "4hD58EyqKCOyHwo2nTzojk",
42         "version": 0,
43         "space": {
44           "sys": {
45             "type": "Link",
46             "linkType": "Space",
47             "id": "jn066pnp3hgr"
48           }
49         },
50         "createdAt": "2025-09-08T07:09:39Z",
51         "updatedAt": "2025-09-08T07:09:39Z"
52       }
53     }
54   ]
55 }

Returns a paginated list of all roles across all spaces in the organization. Accessible by all organization members.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

organization_idstringRequired

The organization ID

Query parameters

skipintegerOptional

Specify an offset to paginate through results

limitintegerOptional

Specify the maximum number of results

includeenumOptional

Specify linked resources to include in response

Allowed values:

Response

OK - Paginated list of space roles across all spaces in the organization