---
title: "Check content permissions"
method: POST
path: "/wiki/rest/api/content/{id}/permission/check"
tags: ["Content permissions"]
---

# Check content permissions

`POST /wiki/rest/api/content/{id}/permission/check`

Check if a user or a group can perform an operation to the specified content. The `operation` to check
must be provided. The user’s account ID or the ID of the group can be provided in the `subject` to check
permissions against a specified user or group. The following permission checks are done to make sure that the
user or group has the proper access:

- site permissions
- space permissions
- content restrictions

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
Permission to access the Confluence site ('Can use' global permission) if checking permission for self,
otherwise 'Confluence Administrator' global permission is required.

## Path parameters

- `id` string, required

## Request body

- ContentPermissionRequest — This object represents the request for the content permission check API.
  - `subject` PermissionSubjectWithGroupId, 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 ID of the group
  - `operation` 'read' | 'update' | 'delete', required — The content permission operation to check.

## Response `200`

Returned if the permission check completed successfully

- PermissionCheckResponse — This object represents the response for the content permission check API. If the user or group does not have permissions, the following errors may be returned: - Group does not have permission to the space - Group does not have permission to the content - User is not allowed to use Confluence - User does not have permission to the space - User does not have permission to the content - Anonymous users are not allowed to use Confluence - Anonymous user does not have permission to the space - Anonymous user does not have permission to the content
  - `hasPermission` boolean, required
  - `errors` Message[]
    - `translation` string
    - `args` union[], required
      - union
        - string
        - object
  - `_links` GenericLinks

## Other responses

- `400` — Returned if; - If any of the required fields are missing. - If specified `subject` or `operation` is invalid.
- `401` — Returned if the authentication credentials are incorrect or missing from the request.
- `403` — Returned if the user does not have permission perform the check.
- `404` — Returned if there is no content with the given ID.

---

[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)