Function: getSmartLinkDescendants()
function getSmartLinkDescendants(client, parameters): Promise<{
[key: string]: unknown;
_links?: {
[key: string]: unknown;
base?: string;
byOperation?: string;
collection?: string;
context?: string;
download?: string;
editui?: string;
edituiv2?: string;
next?: string;
prev?: string;
self?: string;
tinyui?: string;
webui?: string;
};
results?: object[];
}>;Defined in: src/v2/api/descendants.ts:133
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
Parameters
| Parameter | Type | Description |
|---|---|---|
client | Client | - |
parameters | { cursor?: string; depth?: number; id: number; limit?: number; } | - |
parameters.cursor? | string | 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. |
parameters.depth? | number | Maximum depth of descendants to return. If more results are required, use the endpoint corresponding to the content type of the deepest descendant to fetch more descendants. |
parameters.id | number | The ID of the smart link. |
parameters.limit? | number | Maximum number of items per result to return. If more results exist, call the endpoint with the cursor to fetch the next set of results. |
Returns
Promise<{ [key: string]: unknown; _links?: { [key: string]: unknown; base?: string; byOperation?: string; collection?: string; context?: string; download?: string; editui?: string; edituiv2?: string; next?: string; prev?: string; self?: string; tinyui?: string; webui?: string; }; results?: object[]; }>