confluence.js 2.0.0 → 2.2.0-dev20260318121920

package/src/api/content.ts

@@ -1,7 +1,7 @@
 import type * as Models from './models';
 import type * as Parameters from './parameters';
-import type { Callback } from '../callback';
 import type { Client } from '../clients';
+import type { Callback } from '../callback';
 import type { RequestConfig } from '../requestConfig';
 
 export class Content {
@@ -14,6 +14,8 @@ export class Content {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
    * ('Can use' global permission). Only content that the user has permission to view will be returned.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async getContent<T = Models.ContentArray>(
     parameters: Parameters.GetContent | undefined,
@@ -26,6 +28,8 @@ export class Content {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
    * ('Can use' global permission). Only content that the user has permission to view will be returned.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async getContent<T = Models.ContentArray>(parameters?: Parameters.GetContent, callback?: never): Promise<T>;
   async getContent<T = Models.ContentArray>(
@@ -63,6 +67,8 @@ export class Content {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Add' permission for the space that the
    * content will be created in, and permission to view the draft if publishing a draft.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async createContent<T = Models.Content>(
     parameters: Parameters.CreateContent | undefined,
@@ -79,6 +85,8 @@ export class Content {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Add' permission for the space that the
    * content will be created in, and permission to view the draft if publishing a draft.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async createContent<T = Models.Content>(parameters?: Parameters.CreateContent, callback?: never): Promise<T>;
   async createContent<T = Models.Content>(
@@ -223,12 +231,7 @@ export class Content {
       },
       data: {
         ...parameters,
-        version: parameters.version,
-        title: parameters.title,
-        type: parameters.type,
         status: parameters.bodyStatus,
-        space: parameters.space,
-        ancestors: parameters.ancestors,
       },
     };
 
@@ -241,12 +244,13 @@ export class Content {
    *
    * When additional results are available, returns `next` and `prev` URLs to retrieve them in subsequent calls. The
    * URLs each contain a cursor that points to the appropriate set of results. Use `limit` to specify the number of
-   * results returned in each call. Example subsequent call (taken from example response):
-   *
-   *     https://your-domain.atlassian.net/wiki/rest/api/content/search?cql=type=page&limit=25&cursor=raNDoMsTRiNg
+   * results returned in each call.
    *
    * The response to this will have a `prev` URL similar to the `next` in the example response.
    *
+   * If the expand query parameter is used with the `body.export_view` and/or `body.styled_view` properties, then the
+   * query limit parameter will be restricted to a maximum value of 25.
+   *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
    * ('Can use' global permission). Only content that the user has permission to view will be returned.
    */
@@ -260,12 +264,13 @@ export class Content {
    *
    * When additional results are available, returns `next` and `prev` URLs to retrieve them in subsequent calls. The
    * URLs each contain a cursor that points to the appropriate set of results. Use `limit` to specify the number of
-   * results returned in each call. Example subsequent call (taken from example response):
-   *
-   *     https://your-domain.atlassian.net/wiki/rest/api/content/search?cql=type=page&limit=25&cursor=raNDoMsTRiNg
+   * results returned in each call.
    *
    * The response to this will have a `prev` URL similar to the `next` in the example response.
    *
+   * If the expand query parameter is used with the `body.export_view` and/or `body.styled_view` properties, then the
+   * query limit parameter will be restricted to a maximum value of 25.
+   *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
    * ('Can use' global permission). Only content that the user has permission to view will be returned.
    */
@@ -299,6 +304,8 @@ export class Content {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content. If the
    * content is a blog post, 'View' permission for the space is required.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async getContentById<T = Models.Content>(parameters: Parameters.GetContentById, callback: Callback<T>): Promise<void>;
   /**
@@ -308,6 +315,8 @@ export class Content {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content. If the
    * content is a blog post, 'View' permission for the space is required.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async getContentById<T = Models.Content>(parameters: Parameters.GetContentById, callback?: never): Promise<T>;
   async getContentById<T = Models.Content>(
@@ -336,6 +345,8 @@ export class Content {
    * Note, updating draft content is currently not supported.
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async updateContent<T = Models.Content>(parameters: Parameters.UpdateContent, callback: Callback<T>): Promise<void>;
   /**
@@ -345,6 +356,8 @@ export class Content {
    * Note, updating draft content is currently not supported.
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async updateContent<T = Models.Content>(parameters: Parameters.UpdateContent, callback?: never): Promise<T>;
   async updateContent<T = Models.Content>(
@@ -383,6 +396,8 @@ export class Content {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Delete' permission for the space that the
    * content is in.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async deleteContent<T = void>(parameters: Parameters.DeleteContent, callback: Callback<T>): Promise<void>;
   /**
@@ -397,6 +412,8 @@ export class Content {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Delete' permission for the space that the
    * content is in.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async deleteContent<T = void>(parameters: Parameters.DeleteContent, callback?: never): Promise<T>;
   async deleteContent<T = void>(parameters: Parameters.DeleteContent, callback?: Callback<T>): Promise<void | T> {
@@ -415,6 +432,8 @@ export class Content {
    * Returns the most recent update for a piece of content.
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async getHistoryForContent<T = Models.ContentHistory>(
     parameters: Parameters.GetHistoryForContent,
@@ -424,6 +443,8 @@ export class Content {
    * Returns the most recent update for a piece of content.
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async getHistoryForContent<T = Models.ContentHistory>(
     parameters: Parameters.GetHistoryForContent,

package/src/api/contentAttachments.ts

@@ -2,8 +2,8 @@
 import FormData from 'form-data';
 import type * as Models from './models';
 import type * as Parameters from './parameters';
-import type { Callback } from '../callback';
 import type { Client } from '../clients';
+import type { Callback } from '../callback';
 import type { RequestConfig } from '../requestConfig';
 
 export class ContentAttachments {
@@ -16,6 +16,8 @@ export class ContentAttachments {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content. If the
    * content is a blog post, 'View' permission for the space is required.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async getAttachments<T = Models.ContentArray<Models.Attachment>>(
     parameters: Parameters.GetAttachments,
@@ -28,6 +30,8 @@ export class ContentAttachments {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the content. If the
    * content is a blog post, 'View' permission for the space is required.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async getAttachments<T = Models.ContentArray<Models.Attachment>>(
     parameters: Parameters.GetAttachments,
@@ -273,6 +277,7 @@ export class ContentAttachments {
       responseType: 'arraybuffer',
       params: {
         version: parameters.version,
+        status: parameters.status,
       },
     };
 

package/src/api/contentBody.ts

@@ -1,7 +1,7 @@
 import type * as Models from './models';
 import type * as Parameters from './parameters';
-import type { Callback } from '../callback';
 import type { Client } from '../clients';
+import type { Callback } from '../callback';
 import type { RequestConfig } from '../requestConfig';
 
 export class ContentBody {
@@ -20,6 +20,8 @@ export class ContentBody {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: If request specifies 'contentIdContext',
    * 'View' permission for the space, and permission to view the content.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async convertContentBody<T = Models.ContentBody>(
     parameters: Parameters.ConvertContentBody,
@@ -38,6 +40,8 @@ export class ContentBody {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: If request specifies 'contentIdContext',
    * 'View' permission for the space, and permission to view the content.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async convertContentBody<T = Models.ContentBody>(
     parameters: Parameters.ConvertContentBody,
@@ -72,7 +76,9 @@ export class ContentBody {
    *
    * Supported conversions:
    *
-   * - Storage: export_view
+   * - Atlas_doc_format: editor, export_view, storage, styled_view, view
+   * - Storage: atlas_doc_format, editor, export_view, styled_view, view
+   * - Editor: storage
    *
    * No other conversions are supported at the moment. Once a conversion is completed, it will be available for 5
    * minutes at the result endpoint.
@@ -90,7 +96,9 @@ export class ContentBody {
    *
    * Supported conversions:
    *
-   * - Storage: export_view
+   * - Atlas_doc_format: editor, export_view, storage, styled_view, view
+   * - Storage: atlas_doc_format, editor, export_view, styled_view, view
+   * - Editor: storage
    *
    * No other conversions are supported at the moment. Once a conversion is completed, it will be available for 5
    * minutes at the result endpoint.
@@ -127,8 +135,8 @@ export class ContentBody {
   }
 
   /**
-   * Returns the Asynchronous Content Body for the corresponding asyncId if the task is complete or returns the status
-   * of the task.
+   * Returns the asynchronous content body for the corresponding id if the task is complete or returns the status of the
+   * task.
    *
    * After the task is completed, the result can be obtained for 5 minutes, or until an identical conversion request is
    * made again, with allowCache query param set to false.
@@ -141,8 +149,8 @@ export class ContentBody {
     callback: Callback<T>,
   ): Promise<void>;
   /**
-   * Returns the Asynchronous Content Body for the corresponding asyncId if the task is complete or returns the status
-   * of the task.
+   * Returns the asynchronous content body for the corresponding id if the task is complete or returns the status of the
+   * task.
    *
    * After the task is completed, the result can be obtained for 5 minutes, or until an identical conversion request is
    * made again, with allowCache query param set to false.
@@ -165,4 +173,102 @@ export class ContentBody {
 
     return this.client.sendRequest(config, callback);
   }
+
+  /**
+   * Returns the content body for the corresponding `asyncId` of a completed conversion task. If the task is not
+   * completed, the task status is returned instead.
+   *
+   * Once a conversion task is completed, the result can be obtained for up to 5 minutes, or until an identical
+   * conversion request is made again with the `allowCache` parameter set to false.
+   *
+   * Note that there is a maximum limit of 50 task results per request to this endpoint.
+   *
+   * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
+   * ('Can use' global permission).
+   */
+  async bulkAsyncConvertContentBodyResponse<T = Models.AsyncContentBody[]>(
+    parameters: Parameters.BulkAsyncConvertContentBodyResponse,
+    callback: Callback<T>,
+  ): Promise<void>;
+  /**
+   * Returns the content body for the corresponding `asyncId` of a completed conversion task. If the task is not
+   * completed, the task status is returned instead.
+   *
+   * Once a conversion task is completed, the result can be obtained for up to 5 minutes, or until an identical
+   * conversion request is made again with the `allowCache` parameter set to false.
+   *
+   * Note that there is a maximum limit of 50 task results per request to this endpoint.
+   *
+   * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
+   * ('Can use' global permission).
+   */
+  async bulkAsyncConvertContentBodyResponse<T = Models.AsyncContentBody[]>(
+    parameters: Parameters.BulkAsyncConvertContentBodyResponse,
+    callback?: never,
+  ): Promise<T>;
+  async bulkAsyncConvertContentBodyResponse<T = Models.AsyncContentBody[]>(
+    parameters: Parameters.BulkAsyncConvertContentBodyResponse,
+    callback?: Callback<T>,
+  ): Promise<void | T> {
+    const config: RequestConfig = {
+      url: '/api/contentbody/convert/async/bulk/tasks',
+      method: 'GET',
+      params: {
+        ids: parameters.ids,
+      },
+    };
+
+    return this.client.sendRequest(config, callback);
+  }
+
+  /**
+   * Asynchronously converts content bodies from one format to another format in bulk. Use the Content body REST API to
+   * get the status of conversion tasks. Note that there is a maximum limit of 10 conversions per request to this
+   * endpoint.
+   *
+   * Supported conversions:
+   *
+   * - Storage: editor, export_view, styled_view, view
+   * - Editor: storage
+   *
+   * Once a conversion task is completed, it is available for polling for up to 5 minutes.
+   *
+   * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and
+   * permission to view the content if the `spaceKeyContext` or `contentIdContext` are present.
+   */
+  async bulkAsyncConvertContentBodyRequest<T = Models.AsyncId[]>(
+    parameters: Parameters.BulkAsyncConvertContentBodyRequest,
+    callback: Callback<T>,
+  ): Promise<void>;
+  /**
+   * Asynchronously converts content bodies from one format to another format in bulk. Use the Content body REST API to
+   * get the status of conversion tasks. Note that there is a maximum limit of 10 conversions per request to this
+   * endpoint.
+   *
+   * Supported conversions:
+   *
+   * - Storage: editor, export_view, styled_view, view
+   * - Editor: storage
+   *
+   * Once a conversion task is completed, it is available for polling for up to 5 minutes.
+   *
+   * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and
+   * permission to view the content if the `spaceKeyContext` or `contentIdContext` are present.
+   */
+  async bulkAsyncConvertContentBodyRequest<T = Models.AsyncId[]>(
+    parameters: Parameters.BulkAsyncConvertContentBodyRequest,
+    callback?: never,
+  ): Promise<T>;
+  async bulkAsyncConvertContentBodyRequest<T = Models.AsyncId[]>(
+    parameters: Parameters.BulkAsyncConvertContentBodyRequest,
+    callback?: Callback<T>,
+  ): Promise<void | T> {
+    const config: RequestConfig = {
+      url: '/api/contentbody/convert/async/bulk/tasks',
+      method: 'POST',
+      data: parameters,
+    };
+
+    return this.client.sendRequest(config, callback);
+  }
 }

package/src/api/contentChildrenAndDescendants.ts

@@ -1,7 +1,7 @@
 import type * as Models from './models';
 import type * as Parameters from './parameters';
-import type { Callback } from '../callback';
 import type { Client } from '../clients';
+import type { Callback } from '../callback';
 import type { RequestConfig } from '../requestConfig';
 
 export class ContentChildrenAndDescendants {
@@ -24,6 +24,8 @@ export class ContentChildrenAndDescendants {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and
    * permission to view the content if it is a page.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async getContentChildren<T = Models.ContentChildren>(
     parameters: Parameters.GetContentChildren,
@@ -46,6 +48,8 @@ export class ContentChildrenAndDescendants {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and
    * permission to view the content if it is a page.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async getContentChildren<T = Models.ContentChildren>(
     parameters: Parameters.GetContentChildren,
@@ -61,6 +65,8 @@ export class ContentChildrenAndDescendants {
       params: {
         expand: parameters.expand,
         parentVersion: parameters.parentVersion,
+        start: parameters.start,
+        limit: parameters.limit,
       },
     };
 
@@ -119,6 +125,8 @@ export class ContentChildrenAndDescendants {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and
    * permission to view the content if it is a page.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async getContentChildrenByType<T = Models.ContentArray>(
     parameters: Parameters.GetContentChildrenByType,
@@ -140,6 +148,8 @@ export class ContentChildrenAndDescendants {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and
    * permission to view the content if it is a page.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async getContentChildrenByType<T = Models.ContentArray>(
     parameters: Parameters.GetContentChildrenByType,
@@ -169,7 +179,11 @@ export class ContentChildrenAndDescendants {
    *
    * A piece of content has different types of descendants, depending on its type:
    *
-   * - `page`: descendant is `page`, `comment`, `attachment`
+   * - `page`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
+   * - `whiteboard`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
+   * - `database`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
+   * - `embed`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
+   * - `folder`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
    * - `blogpost`: descendant is `comment`, `attachment`
    * - `attachment`: descendant is `comment`
    * - `comment`: descendant is `attachment`
@@ -191,7 +205,11 @@ export class ContentChildrenAndDescendants {
    *
    * A piece of content has different types of descendants, depending on its type:
    *
-   * - `page`: descendant is `page`, `comment`, `attachment`
+   * - `page`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
+   * - `whiteboard`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
+   * - `database`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
+   * - `embed`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
+   * - `folder`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
    * - `blogpost`: descendant is `comment`, `attachment`
    * - `attachment`: descendant is `comment`
    * - `comment`: descendant is `attachment`
@@ -228,13 +246,20 @@ export class ContentChildrenAndDescendants {
    *
    * A piece of content has different types of descendants, depending on its type:
    *
-   * - `page`: descendant is `page`, `comment`, `attachment`
+   * - `page`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
+   * - `whiteboard`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
+   * - `database`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
+   * - `embed`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
+   * - `folder`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
    * - `blogpost`: descendant is `comment`, `attachment`
    * - `attachment`: descendant is `comment`
    * - `comment`: descendant is `attachment`
    *
    * Custom content types that are provided by apps can also be returned.
    *
+   * If the expand query parameter is used with the `body.export_view` and/or `body.styled_view` properties, then the
+   * query limit parameter will be restricted to a maximum value of 25.
+   *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and
    * permission to view the content if it is a page.
    */
@@ -249,13 +274,20 @@ export class ContentChildrenAndDescendants {
    *
    * A piece of content has different types of descendants, depending on its type:
    *
-   * - `page`: descendant is `page`, `comment`, `attachment`
+   * - `page`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
+   * - `whiteboard`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
+   * - `database`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
+   * - `embed`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
+   * - `folder`: descendant is `page`, `whiteboard`, `database`, `embed`, `folder`, `comment`, `attachment`
    * - `blogpost`: descendant is `comment`, `attachment`
    * - `attachment`: descendant is `comment`
    * - `comment`: descendant is `attachment`
    *
    * Custom content types that are provided by apps can also be returned.
    *
+   * If the expand query parameter is used with the `body.export_view` and/or `body.styled_view` properties, then the
+   * query limit parameter will be restricted to a maximum value of 25.
+   *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and
    * permission to view the content if it is a page.
    */
@@ -329,6 +361,7 @@ export class ContentChildrenAndDescendants {
    *
    * - `space`: page will be copied to the specified space as a root page on the space
    * - `parent_page`: page will be copied as a child of the specified parent page
+   * - `parent_content`: page will be copied as a child of the specified parent content
    * - `existing_page`: page will be copied and replace the specified page
    *
    * By default, the following objects are expanded: `space`, `history`, `version`.
@@ -344,6 +377,7 @@ export class ContentChildrenAndDescendants {
    *
    * - `space`: page will be copied to the specified space as a root page on the space
    * - `parent_page`: page will be copied as a child of the specified parent page
+   * - `parent_content`: page will be copied as a child of the specified parent content
    * - `existing_page`: page will be copied and replace the specified page
    *
    * By default, the following objects are expanded: `space`, `history`, `version`.

package/src/api/contentComments.ts

@@ -4,6 +4,7 @@ import type { Callback } from '../callback';
 import type { Client } from '../clients';
 import type { RequestConfig } from '../requestConfig';
 
+/** @deprecated Will be removed in next major version. */
 export class ContentComments {
   constructor(private client: Client) {}
 
@@ -12,6 +13,8 @@ export class ContentComments {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and
    * permission to view the content if it is a page.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async getContentComments<T = Models.ContentArray>(
     parameters: Parameters.GetContentComments,
@@ -22,6 +25,8 @@ export class ContentComments {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space, and
    * permission to view the content if it is a page.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async getContentComments<T = Models.ContentArray>(
     parameters: Parameters.GetContentComments,

package/src/api/contentLabels.ts

@@ -1,7 +1,7 @@
 import type * as Models from './models';
 import type * as Parameters from './parameters';
-import type { Callback } from '../callback';
 import type { Client } from '../clients';
+import type { Callback } from '../callback';
 import type { RequestConfig } from '../requestConfig';
 
 export class ContentLabels {
@@ -12,6 +12,8 @@ export class ContentLabels {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space and
    * permission to view the content if it is a page.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async getLabelsForContent<T = Models.LabelArray>(
     parameters: Parameters.GetLabelsForContent,
@@ -22,6 +24,8 @@ export class ContentLabels {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'View' permission for the space and
    * permission to view the content if it is a page.
+   *
+   * @deprecated Will be removed in next major version.
    */
   async getLabelsForContent<T = Models.LabelArray>(
     parameters: Parameters.GetLabelsForContent,
@@ -91,8 +95,9 @@ export class ContentLabels {
   }
 
   /**
-   * Removes a label from a piece of content. This is similar to [Remove label from
-   * content](#api-content-id-label-label-delete) except that the label name is specified via a query parameter.
+   * Removes a label from a piece of content. Labels can't be deleted from archived content. This is similar to [Remove
+   * label from content](#api-content-id-label-label-delete) except that the label name is specified via a query
+   * parameter.
    *
    * Use this method if the label name has "/" characters, as [Remove label from content using query
    * parameter](#api-content-id-label-delete) does not accept "/" characters for the label name.
@@ -104,8 +109,9 @@ export class ContentLabels {
     callback: Callback<T>,
   ): Promise<void>;
   /**
-   * Removes a label from a piece of content. This is similar to [Remove label from
-   * content](#api-content-id-label-label-delete) except that the label name is specified via a query parameter.
+   * Removes a label from a piece of content. Labels can't be deleted from archived content. This is similar to [Remove
+   * label from content](#api-content-id-label-label-delete) except that the label name is specified via a query
+   * parameter.
    *
    * Use this method if the label name has "/" characters, as [Remove label from content using query
    * parameter](#api-content-id-label-delete) does not accept "/" characters for the label name.
@@ -132,8 +138,9 @@ export class ContentLabels {
   }
 
   /**
-   * Removes a label from a piece of content. This is similar to [Remove label from content using query
-   * parameter](#api-content-id-label-delete) except that the label name is specified via a path parameter.
+   * Removes a label from a piece of content. Labels can't be deleted from archived content. This is similar to [Remove
+   * label from content using query parameter](#api-content-id-label-delete) except that the label name is specified via
+   * a path parameter.
    *
    * Use this method if the label name does not have "/" characters, as the path parameter does not accept "/"
    * characters for security reasons. Otherwise, use [Remove label from content using query
@@ -146,8 +153,9 @@ export class ContentLabels {
     callback: Callback<T>,
   ): Promise<void>;
   /**
-   * Removes a label from a piece of content. This is similar to [Remove label from content using query
-   * parameter](#api-content-id-label-delete) except that the label name is specified via a path parameter.
+   * Removes a label from a piece of content. Labels can't be deleted from archived content. This is similar to [Remove
+   * label from content using query parameter](#api-content-id-label-delete) except that the label name is specified via
+   * a path parameter.
    *
    * Use this method if the label name does not have "/" characters, as the path parameter does not accept "/"
    * characters for security reasons. Otherwise, use [Remove label from content using query