ATatlassian
Page

Delete page

Delete a page by id.

By default this will delete pages that are non-drafts. To delete a page that is a draft, the endpoint must be called on a draft with the following param draft=true. Discarded drafts are not sent to the trash and are permanently deleted.

Deleting a page moves the page to the trash, where it can be restored later. To permanently delete a page (or "purge" it), the endpoint must be called on a trashed page with the following param purge=true.

Permissions required: Permission to view the page and its corresponding space. Permission to delete pages in the space. manage/content permission for the space (if attempting to purge).

Note: To find the display name for each permission ID, call the Get available space permissions API.

delete/pages/{id}

Request

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

Path parameters

idinteger required

The ID of the page to be deleted.

Query parameters

purgeboolean

If attempting to purge the page.

draftboolean

If attempting to delete a page that is a draft.

Response

Returned if the page was successfully deleted.

Changes

No recorded changes to this operation across all 5 revisions of this API.