> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful.com/developers/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/_mcp/server.

## Group Space Roles

A **role** inside a space represents a collection of policies which determine what kind of access a user (or team) has within that space. See the [complete documentation for space roles](/references/content-management-api/overview) in the Content Management API for more details about how roles and policies can be managed via API.

**Note:** Space roles should not be confused with the organization role, which is an attribute of an organization membership.

### Get all space roles in an organization

[Get all space roles in an organization](/references/user-management-api/space-roles/get-all-space-roles)

This endpoint returns a paginated list of all roles from all spaces across the organization.

#### Query Parameters

| Name            | Details                       | Description                                                                                                                                      |
| --------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `skip`, `limit` | -                             | Specify requested page of result set. See [Pagination](#/introduction/pagination) for more details.                                              |
| `include`       | Supported values: `sys.space` | Specify linked resources to include in response. See [Including Related Resources](#/introduction/including-related-resources) for more details. |

#### Response

```js
{
    "total": 2,
    "limit": 25,
    "skip": 0,
    "sys": {
        "type": "Array"
    },
    "items": [
        {
            "name": "Developer",
            "description": "Allows reading Entries and managing API Keys",
            "policies": [
                {
                    "effect": "allow",
                    "actions": [
                        "read"
                    ],
                    "constraint": {
                        "and": [
                            {
                                "equals": [
                                    {
                                        "doc": "sys.type"
                                    },
                                    "Entry"
                                ]
                            }
                        ]
                    }
                },
                {
                    "effect": "allow",
                    "actions": [
                        "read"
                    ],
                    "constraint": {
                        "and": [
                            {
                                "equals": [
                                    {
                                        "doc": "sys.type"
                                    },
                                    "Asset"
                                ]
                            }
                        ]
                    }
                }
            ],
            "permissions": {
                "ContentModel": [
                    "read"
                ],
                "Settings": [],
                "ContentDelivery": "all"
            },
            "sys": {
                "type": "Role",
                "id": "4hD58EyqKCOyHwo2nTzojk",
                "version": 0,
                "space": {
                    "sys": {
                        "type": "Link",
                        "linkType": "Space",
                        "id": "jn066pnp3hgr"
                    }
                },
                "createdBy": {
                    "sys": {
                        "type": "Link",
                        "linkType": "User",
                        "id": "3JE87mfI5hDuAaq0hpbbEh"
                    }
                },
                "createdAt": "2017-11-09T09:16:10Z",
                "updatedBy": {
                    "sys": {
                        "type": "Link",
                        "linkType": "User",
                        "id": "3JE87mfI5hDuAaq0hpbbEh"
                    }
                },
                "updatedAt": "2017-11-09T09:16:10Z"
            }
        },
        {
            "name": "Editor",
            "description": "Allows editing, publishing and archiving of content",
            "policies": [
                {
                    "effect": "allow",
                    "actions": "all",
                    "constraint": {
                        "and": [
                            {
                                "equals": [
                                    {
                                        "doc": "sys.type"
                                    },
                                    "Entry"
                                ]
                            }
                        ]
                    }
                },
                {
                    "effect": "allow",
                    "actions": "all",
                    "constraint": {
                        "and": [
                            {
                                "equals": [
                                    {
                                        "doc": "sys.type"
                                    },
                                    "Asset"
                                ]
                            }
                        ]
                    }
                }
            ],
            "permissions": {
                "ContentModel": [
                    "read"
                ],
                "Settings": [],
                "ContentDelivery": []
            },
            "sys": {
                "type": "Role",
                "id": "4hDOJRz3lT01Jv6WVogTfE",
                "version": 0,
                "space": {
                    "sys": {
                        "type": "Link",
                        "linkType": "Space",
                        "id": "jn066pnp3hgr"
                    }
                },
                "createdBy": {
                    "sys": {
                        "type": "Link",
                        "linkType": "User",
                        "id": "3JE87mfI5hDuAaq0hpbbEh"
                    }
                },
                "createdAt": "2017-11-09T09:16:10Z",
                "updatedBy": {
                    "sys": {
                        "type": "Link",
                        "linkType": "User",
                        "id": "3JE87mfI5hDuAaq0hpbbEh"
                    }
                },
                "updatedAt": "2017-11-09T09:16:10Z"
            }
        }
    ]
}
```


## API Docs

- Space Roles [Get all space roles](https://contentful.com/developers/docs/references/user-management-api/space-roles/get-all-space-roles.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://contentful.com/developers/docs/openapi.json)
- [OpenAPI YAML](https://contentful.com/developers/docs/openapi.yaml)