---
title: "Add new custom content permission to space"
method: POST
path: "/wiki/rest/api/space/{spaceKey}/permission/custom-content"
tags: ["Space permissions"]
---

# Add new custom content permission to space

`POST /wiki/rest/api/space/{spaceKey}/permission/custom-content`

Adds new custom content permission to space.

If the permission to be added is a group permission, the group can be identified
by its group name or group id.

Note: Only apps can access this REST resource and only make changes to the respective app permissions.

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

## Path parameters

- `spaceKey` string, required

## Request body

- SpacePermissionCustomContent — This object represents a list of space permissions for custom content type for an individual user. Permissions consist of a subjects object and a list with at least one operation object.
  - `subject` PermissionSubject, required — The user or group that the permission applies to.
    - `type` 'user' | 'group', required
    - `identifier` string, required — for `type=user`, identifier should be user's accountId or `anonymous` for anonymous users for `type=group`, identifier should be the groupId.
  - `operations` object[], required
    - `key` 'read' | 'create' | 'delete', required — The operation type
    - `target` string, required — The custom content type
    - `access` boolean, required — Grant or restrict access

## Response `200`

Returned if the requested content is returned.

## Other responses

- `400` — Used for various errors. Such as: - Permission already exists for the given user or group. - 'read space' permission doesn't exist for the given user or group. - No group found with the given groupName or groupId
- `401` — Returned if the authentication credentials are incorrect or missing from the request.
- `403` — Returned if the user isn't authorized.
- `404` — Returned if any of the following is true: - There is no space with the given key. - The calling user does not have permission to view the space.

---

[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/revisions/70088490f406/schema)