---
title: "Get content state settings for space"
method: GET
path: "/wiki/rest/api/space/{spaceKey}/state/settings"
tags: ["Content states"]
---

# Get content state settings for space

`GET /wiki/rest/api/space/{spaceKey}/state/settings`

Get object describing whether content states are allowed at all, if custom content states or space content states
are restricted, and a list of space content states allowed for the space if they are not restricted.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
'Admin' permission for the space.

## Path parameters

- `spaceKey` string, required

## Response `200`

Returned if the requested space exists, and user has space admin permission.

- ContentStateSettings
  - `contentStatesAllowed` boolean, required — Whether users can place any content states on content
  - `customContentStatesAllowed` boolean, required — Whether users can place their custom states on content
  - `spaceContentStatesAllowed` boolean, required — Whether users can place space suggested states on content
  - `spaceContentStates` ContentState[] — space suggested content states that users can choose from
    - `id` integer, required — identifier of content state. If 0, 1, or 2, this is a default space state
    - `name` string, required — name of content state.
    - `color` string, required — hex string representing color of state

## Other responses

- `401` — Returned if the authentication credentials are incorrect or missing from the request.
- `403` — Returned if user does not have space admin permission.
- `404` — Returned if the space with given key can not be found.

---

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