GET

Get descendants of a whiteboard

Returns descendants in the content tree for a given whiteboard by ID in top-to-bottom order (that is, the highest descendant is the first item in the response payload). The number of results is limited by the limit parameter and additional results (if available) will be available by calling this endpoint with the cursor in the response payload. There is also a depth parameter specifying depth of descendants to be fetched.

The following types of content will be returned:

  • Database
  • Embed
  • Folder
  • Page
  • Whiteboard

This endpoint returns minimal information about each descendant. To fetch more details, use a related endpoint based on the content type, such as:

Permissions required: Permission to access the Confluence site ('Can use' global permission). Permission to view the whiteboard and its corresponding space

Data Security Policy: Not exempt from app access rules
Scopes
read:hierarchical-content:confluence

Connect app scope requiredREAD

Request

Path parameters

id

integer

Required

Query parameters

limit

integer

depth

integer

cursor

string

Responses

Returned if the requested descendants are returned.

Headers

Link

string

application/json

MultiEntityResult<DescendantsResponse>
GET/whiteboards/{id}/descendants
1 2 3 4 5 6 7 8 9 10 11 12 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/whiteboards/{id}/descendants`, { headers: { 'Accept': 'application/json' } }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.json());
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 { "results": [ { "id": "<string>", "status": "current", "title": "<string>", "type": "<string>", "childPosition": 55 } ], "_links": { "next": "<string>", "base": "<string>" } }
GET

Get descendants of a database

Returns descendants in the content tree for a given database by ID in top-to-bottom order (that is, the highest descendant is the first item in the response payload). The number of results is limited by the limit parameter and additional results (if available) will be available by calling this endpoint with the cursor in the response payload. There is also a depth parameter specifying depth of descendants to be fetched.

The following types of content will be returned:

  • Database
  • Embed
  • Folder
  • Page
  • Whiteboard

This endpoint returns minimal information about each descendant. To fetch more details, use a related endpoint based on the content type, such as:

Permissions required: Permission to access the Confluence site ('Can use' global permission). Permission to view the database and its corresponding space

Data Security Policy: Not exempt from app access rules
Scopes
read:hierarchical-content:confluence

Connect app scope requiredREAD

Request

Path parameters

id

integer

Required

Query parameters

limit

integer

depth

integer

cursor

string

Responses

Returned if the requested descendants are returned.

Headers

Link

string

application/json

MultiEntityResult<DescendantsResponse>
GET/databases/{id}/descendants
1 2 3 4 5 6 7 8 9 10 11 12 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/databases/{id}/descendants`, { headers: { 'Accept': 'application/json' } }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.json());
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 { "results": [ { "id": "<string>", "status": "current", "title": "<string>", "type": "<string>", "childPosition": 55 } ], "_links": { "next": "<string>", "base": "<string>" } }
GET

Get descendants of a smart link

Returns descendants in the content tree for a given smart link by ID in top-to-bottom order (that is, the highest descendant is the first item in the response payload). The number of results is limited by the limit parameter and additional results (if available) will be available by calling this endpoint with the cursor in the response payload. There is also a depth parameter specifying depth of descendants to be fetched.

The following types of content will be returned:

  • Database
  • Embed
  • Folder
  • Page
  • Whiteboard

This endpoint returns minimal information about each descendant. To fetch more details, use a related endpoint based on the content type, such as:

Permissions required: Permission to access the Confluence site ('Can use' global permission). Permission to view the smart link and its corresponding space

Data Security Policy: Not exempt from app access rules
Scopes
read:hierarchical-content:confluence

Connect app scope requiredREAD

Request

Path parameters

id

integer

Required

Query parameters

limit

integer

depth

integer

cursor

string

Responses

Returned if the requested descendants are returned.

Headers

Link

string

application/json

MultiEntityResult<DescendantsResponse>
GET/embeds/{id}/descendants
1 2 3 4 5 6 7 8 9 10 11 12 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/embeds/{id}/descendants`, { headers: { 'Accept': 'application/json' } }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.json());
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 { "results": [ { "id": "<string>", "status": "current", "title": "<string>", "type": "<string>", "childPosition": 55 } ], "_links": { "next": "<string>", "base": "<string>" } }
GET

Get descendants of folder

Returns descendants in the content tree for a given folder by ID in top-to-bottom order (that is, the highest descendant is the first item in the response payload). The number of results is limited by the limit parameter and additional results (if available) will be available by calling this endpoint with the cursor in the response payload. There is also a depth parameter specifying depth of descendants to be fetched.

The following types of content will be returned:

  • Database
  • Embed
  • Folder
  • Page
  • Whiteboard

This endpoint returns minimal information about each descendant. To fetch more details, use a related endpoint based on the content type, such as:

Permissions required: Permission to access the Confluence site ('Can use' global permission). Permission to view the and its corresponding space

Data Security Policy: Not exempt from app access rules
Scopes
read:hierarchical-content:confluence

Connect app scope requiredREAD

Request

Path parameters

id

integer

Required

Query parameters

limit

integer

depth

integer

cursor

string

Responses

Returned if the requested descendants are returned.

Headers

Link

string

application/json

MultiEntityResult<DescendantsResponse>
GET/folders/{id}/descendants
1 2 3 4 5 6 7 8 9 10 11 12 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/folders/{id}/descendants`, { headers: { 'Accept': 'application/json' } }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.json());
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 { "results": [ { "id": "<string>", "status": "current", "title": "<string>", "type": "<string>", "childPosition": 55 } ], "_links": { "next": "<string>", "base": "<string>" } }
GET

Get descendants of page

Returns descendants in the content tree for a given page by ID in top-to-bottom order (that is, the highest descendant is the first item in the response payload). The number of results is limited by the limit parameter and additional results (if available) will be available by calling this endpoint with the cursor in the response payload. There is also a depth parameter specifying depth of descendants to be fetched.

The following types of content will be returned:

  • Database
  • Embed
  • Folder
  • Page
  • Whiteboard

This endpoint returns minimal information about each descendant. To fetch more details, use a related endpoint based on the content type, such as:

Permissions required: Permission to access the Confluence site ('Can use' global permission). Permission to view the page and its corresponding space

Data Security Policy: Not exempt from app access rules
Scopes
read:hierarchical-content:confluence

Connect app scope requiredREAD

Request

Path parameters

id

integer

Required

Query parameters

limit

integer

depth

integer

cursor

string

Responses

Returned if the requested descendants are returned.

Headers

Link

string

application/json

MultiEntityResult<DescendantsResponse>
GET/pages/{id}/descendants
1 2 3 4 5 6 7 8 9 10 11 12 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/pages/{id}/descendants`, { headers: { 'Accept': 'application/json' } }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.json());
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 { "results": [ { "id": "<string>", "status": "current", "title": "<string>", "type": "<string>", "childPosition": 55 } ], "_links": { "next": "<string>", "base": "<string>" } }

Rate this page: