---
title: "Get page permissions"
method: GET
path: "/pages/{id}/permissions"
tags: ["Content Permissions"]
---

# Get page permissions

`GET /pages/{id}/permissions`

## Request

- Base URL: `https://no-default/wiki/api/v2`
- URL: `https://no-default/wiki/api/v2/pages/{id}/permissions`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `https://auth.atlassian.com/authorize`
    - Token URL: `https://auth.atlassian.com/oauth/token` scopes: `read:page:confluence`

Returns the direct content permissions on a page with optional filtering by operation, principal-type, and principal-id.
Results are cursor-paginated (max 250 per page).

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
Permission to view the page.

## Path parameters

- `id` integer, required

## Query parameters

- `operation` 'read' | 'update'
- `principal-type` 'user' | 'group'
- `principal-id` string
- `cursor` string
- `limit` integer

## Response `200`

Returned if the permissions are successfully retrieved.

- object
  - `results` ContentPermissionOutput[]
    - `operation` 'read' | 'update', required: The operation the permission grants.
    - `principal` ContentPermissionPrincipal, required: A user or group principal on a content permission entry.
      - `principalType` 'user' | 'group', required: The type of principal.
      - `principalId` string, required: The identifier of the principal. For users, this is the Atlassian Account ID; for groups, this is the group ID.
    - `createdAt` string, date-time: ISO-8601 timestamp of when the permission was created.
    - `createdBy` string: Atlassian Account ID of the user who created the permission entry.
    - `createdByAaid` string: Deprecated alias for `createdBy`. Use `createdBy` instead.
  - `_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 the request parameters are invalid (e.g. `principal-id` provided without `principal-type`).
- `401`: Returned if the authentication credentials are incorrect or missing from the request.
- `404`: Returned if the content was not found or the calling user does not have permission to perform this operation.

## Changes

- **2026-10-15** `246e0eec8f43`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/atlassian/apis/the-confluence-cloud-rest-api-v2/changes/pages/:id/permissions/get.md)

---

[API](https://skmtc.dev/atlassian/apis/the-confluence-cloud-rest-api-v2.md) - [All operations](https://skmtc.dev/atlassian/apis/the-confluence-cloud-rest-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/the-confluence-cloud-rest-api-v2/revisions/246e0eec8f43?raw)