---
title: "Get available space roles"
method: GET
path: "/space-roles"
tags: ["Space Roles"]
---

# Get available space roles

`GET /space-roles`

Retrieves the available space roles.

Available on tenants with [Role-Based Access Control](https://support.atlassian.com/confluence-cloud/docs/manage-user-roles/). 

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
Permission to access the Confluence site; if requesting a certain space's roles, permission to view the space.

## Query parameters

- `space-id` string
- `role-type` string
- `principal-id` string
- `principal-type` 'USER' | 'GROUP' | 'ACCESS_CLASS' — The principal type.
- `cursor` string
- `limit` integer

## Response `200`

Returned if the requested space roles are retrieved.

- object
  - `results` SpaceRole[]
    - `id` string — The identifier for the space role.
    - `type` 'SYSTEM' | 'CUSTOM' — The role type.
    - `name` string — The name for the space role.
    - `description` string — The description for the space role’s usage.
    - `spacePermissions` string[] — The space permissions the space role is comprised of.
  - `_links` MultiEntityLinks
    - `next` string — Used for pagination. Contains the relative URL for the next set of results, using a cursor query parameter. This property will not be present if there is no additional data available.
    - `base` string — Base url of the Confluence site.

## Other responses

- `400` — Returned if an invalid request is provided.
- `401` — Returned if the authentication credentials are incorrect or missing from the request.
- `404` — Returned if the calling user does not have permission to view the available space roles.

---

[API](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api-v2.md) · [All operations](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-confluence-cloud-rest-api-v2/revisions/451377c5a598/schema)