v1

latestOpenAPI 3.0.32026-07-13218142597.2 KB
Page

Get pages

Returns all pages. The number of results is limited by the limit parameter and additional results (if available) will be available through the next URL present in the Link response header.

Permissions required: Permission to access the Confluence site ('Can use' global permission). Only pages that the user has permission to view will be returned.

get/pages

Query parameters

idinteger[]

Filter the results based on page ids. Multiple page ids can be specified as a comma-separated list.

space-idinteger[]

Filter the results based on space ids. Multiple space ids can be specified as a comma-separated list.

sort'id' | '-id' | 'created-date' | '-created-date' | 'modified-date' | '-modified-date' | 'title' | '-title'

The sort fields for pages. The default sort direction is ascending. To sort in descending order, append a - character before the sort field. For example, fieldName or -fieldName.

Used to sort the result by a particular field.

statusstring[]

Filter the results to pages based on their status. By default, current and archived are used.

titlestring

Filter the results to pages based on their title.

body-format'storage' | 'atlas_doc_format'

The primary formats a body can be represented as. A subset of BodyRepresentation. These formats are the only allowed formats in certain use cases.

The content format types to be returned in the body field of the response. If available, the representation will be available under a response field of the same name under the body field.

subtype'live' | 'page'

Filter the results to pages based on their subtype.

cursorstring

Used for pagination, this opaque cursor will be returned in the next URL in the Link response header. Use the relative URL in the Link header to retrieve the next set of results.

limitinteger

Maximum number of pages per result to return. If more results exist, use the Link header to retrieve a relative URL that will return the next set of results.

Response

Returned if the requested pages are returned.