Create a role

POST

https://api.contentful.com/spaces/:space_id/roles

POST

/spaces/:space_id/roles

$ curl -X POST https://api.contentful.com/spaces/yadj1kx9rmg0/roles \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/vnd.contentful.management.v1+json" \
>      -d '{
>   "name": "Some role",
>   "description": "Test role",
>   "permissions": {
>     "ContentModel": [
>       "read"
>     ],
>     "ContentDelivery": "all",
>     "Environments": "all",
>     "EnvironmentAliases": "all",
>     "Settings": "all"
>   },
>   "policies": [
>     {
>       "effect": "allow",
>       "actions": [
>         "read",
>         "create",
>         "update",
>         "delete",
>         "publish",
>         "unpublish",
>         "archive",
>         "unarchive"
>       ],
>       "constraint": {
>         "and": [
>           [
>             "equals",
>             {
>               "doc": "sys.type"
>             },
>             "Entry"
>           ]
>         ]
>       }
>     }
>   ]
> }'

201Roles_createARole_example

1 {
2   "sys": {
3     "type": "Role",
4     "id": "0xvkNW6WdQ8JkWlWZ8BC4x",
5     "version": 0,
6     "createdAt": "2025-10-31T05:59:20.000Z",
7     "createdBy": {
8       "sys": {
9         "type": "Link",
10         "linkType": "User",
11         "id": "7BslKh9TdKGOK41VmLDjFZ"
12       }
13     },
14     "updatedAt": "2025-10-31T05:59:20.000Z",
15     "updatedBy": {
16       "sys": {
17         "type": "Link",
18         "linkType": "User",
19         "id": "4FLrUHftHW3v2BLi9fzfjU"
20       }
21     }
22   },
23   "name": "Some role",
24   "description": "Test role",
25   "permissions": {
26     "ContentModel": [
27       "read"
28     ],
29     "ContentDelivery": "all",
30     "Environments": "all",
31     "EnvironmentAliases": "all",
32     "Settings": "all"
33   },
34   "policies": [
35     {
36       "effect": "allow",
37       "actions": [
38         "read",
39         "create",
40         "update",
41         "delete",
42         "publish",
43         "unpublish",
44         "archive",
45         "unarchive"
46       ],
47       "constraint": {
48         "and": [
49           [
50             "equals",
51             {
52               "doc": "sys.type"
53             },
54             "Entry"
55           ]
56         ]
57       }
58     }
59   ]
60 }

Use this endpoint to create a custom role. The role name must be unique within the space.

Authentication

AuthorizationBearer

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

Path parameters

space_idstringRequired

ID of the Space in form of a string

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

Created - Resource created successfully