v1

latestOpenAPI 3.0.32026-07-13218142597.2 KB
Page

Get pages in space

Returns all pages in a space. 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) and 'View' permission for the space. Only pages that the user has permission to view will be returned.

get/spaces/{id}/pages

Path parameters

idinteger required

The ID of the space for which pages should be returned.

Query parameters

depth'all' | 'root'

Filter the results to pages at the root level of the space or to all pages in the space.

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.

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.