Get a role | Documentation | Contentful Docs

{
  "sys": {
    "type": "Role",
    "id": "0xvkNW6WdQ8JkWlWZ8BC4x",
    "version": 0,
    "createdAt": "2025-07-25T23:44:35.000Z",
    "createdBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "7BslKh9TdKGOK41VmLDjFZ"
      }
    },
    "updatedAt": "2025-07-25T23:44:35.000Z",
    "updatedBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "4FLrUHftHW3v2BLi9fzfjU"
      }
    }
  },
  "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"
          ]
        ]
      }
    }
  ]
}

Use this endpoint to read an existing single role.

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

role_idstringRequired

ID of the role in a form of a string

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful

$	curl https://api.contentful.com/spaces/yadj1kx9rmg0/roles/0xvkNW6WdQ8JkWlWZ8BC4x \
>	-H "Authorization: Bearer <token>"