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

# Delete page permissions

`DELETE /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: `write:page:confluence`

Deletes direct content permissions from a page. Filters narrow the deletion scope; omitting all filters deletes all direct permissions.

The following filter combinations are supported:
- No filters: deletes all direct permissions.
- `principal-type` + `principal-id`: deletes the principal's direct `read` or `update` permission.
- `operation` + `principal-type` + `principal-id`: deletes the permission only when its operation matches.

Providing `operation` without `principal-type`/`principal-id`, or providing only one of `principal-type`/`principal-id`, returns a 400 error.

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

## Path parameters

- `id` integer, required

## Query parameters

- `operation` 'read' | 'update'
- `principal-type` 'user' | 'group'
- `principal-id` string
- `allow-self-lockout` boolean

## Response `204`

Returned if the permissions are successfully deleted.

## Other responses

- `400`: Returned if the filter combination is invalid or the operation would result in an invalid permission state.
- `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/delete.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)