confluence.js 1.3.1 → 1.5.0

package/src/api/contentAttachments.ts

@@ -1,7 +1,8 @@
+import * as FormData from 'form-data';
 import * as Models from './models';
 import * as Parameters from './parameters';
-import { Client } from '../clients';
 import { Callback } from '../callback';
+import { Client } from '../clients';
 import { RequestConfig } from '../requestConfig';
 
 export class ContentAttachments {
@@ -15,7 +16,7 @@ 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.
    */
-  async getAttachments<T = Models.ContentArray>(
+  async getAttachments<T = Models.ContentArray<Models.Attachment>>(
     parameters: Parameters.GetAttachments,
     callback: Callback<T>
   ): Promise<void>;
@@ -27,8 +28,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.
    */
-  async getAttachments<T = Models.ContentArray>(parameters: Parameters.GetAttachments, callback?: never): Promise<T>;
-  async getAttachments<T = Models.ContentArray>(
+  async getAttachments<T = Models.ContentArray<Models.Attachment>>(parameters: Parameters.GetAttachments, callback?: never): Promise<T>;
+  async getAttachments<T = Models.ContentArray<Models.Attachment>>(
     parameters: Parameters.GetAttachments,
     callback?: Callback<T>,
   ): Promise<void | T> {
@@ -49,91 +50,55 @@ export class ContentAttachments {
 
   /**
    * Adds an attachment to a piece of content. This method only adds a new attachment. If you want to update an existing
-   * attachment, use [Create or update attachments](#api-content-id-child-attachment-put).
-   *
-   * Note, you must set a `X-Atlassian-Token: nocheck` header on the request for this method, otherwise it will be
-   * blocked. This protects against XSRF attacks, which is necessary as this method accepts multipart/form-data.
-   *
-   * The media type 'multipart/form-data' is defined in [RFC 7578](https://www.ietf.org/rfc/rfc7578.txt). Most client
-   * libraries have classes that make it easier to implement multipart posts, like the
-   * [MultipartEntityBuilder](https://hc.apache.org/httpcomponents-client-5.1.x/current/httpclient5/apidocs/) Java class
-   * provided by Apache HTTP Components.
-   *
-   * Note, according to [RFC 7578](https://tools.ietf.org/html/rfc7578#section-4.5), in the case where the form data is
-   * text, the charset parameter for the "text/plain" Content-Type may be used to indicate the character encoding used
-   * in that part. In the case of this API endpoint, the `comment` body parameter should be sent with `type=text/plain`
-   * and `charset=utf-8` values. This will force the charset to be UTF-8.
-   *
-   * Example: This curl command attaches a file ('example.txt') to a container (id='123') with a comment and `minorEdits`=true.
-   *
-   * ```bash
-   * curl -D- \
-   *   -u admin:admin \
-   *   -X POST \
-   *   -H 'X-Atlassian-Token: nocheck' \
-   *   -F 'file=@"example.txt"' \
-   *   -F 'minorEdit="true"' \
-   *   -F 'comment="Example attachment comment"; type=text/plain; charset=utf-8' \
-   *   http://myhost/rest/api/content/123/child/attachment
-   * ```
+   * attachment, use [Create or update attachments](https://developer.atlassian.com/cloud/confluence/rest/api-group-content---attachments/#api-wiki-rest-api-content-id-child-attachment-put).
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content.
    */
-  async createAttachments<T = Models.ContentArray>(
+  async createAttachments<T = Models.ContentArray<Models.CreatedAttachment>>(
     parameters: Parameters.CreateAttachments,
     callback: Callback<T>
   ): Promise<void>;
   /**
    * Adds an attachment to a piece of content. This method only adds a new attachment. If you want to update an existing
-   * attachment, use [Create or update attachments](#api-content-id-child-attachment-put).
-   *
-   * Note, you must set a `X-Atlassian-Token: nocheck` header on the request for this method, otherwise it will be
-   * blocked. This protects against XSRF attacks, which is necessary as this method accepts multipart/form-data.
-   *
-   * The media type 'multipart/form-data' is defined in [RFC 7578](https://www.ietf.org/rfc/rfc7578.txt). Most client
-   * libraries have classes that make it easier to implement multipart posts, like the
-   * [MultipartEntityBuilder](https://hc.apache.org/httpcomponents-client-5.1.x/current/httpclient5/apidocs/) Java class
-   * provided by Apache HTTP Components.
-   *
-   * Note, according to [RFC 7578](https://tools.ietf.org/html/rfc7578#section-4.5), in the case where the form data is
-   * text, the charset parameter for the "text/plain" Content-Type may be used to indicate the character encoding used
-   * in that part. In the case of this API endpoint, the `comment` body parameter should be sent with `type=text/plain`
-   * and `charset=utf-8` values. This will force the charset to be UTF-8.
-   *
-   * Example: This curl command attaches a file ('example.txt') to a container (id='123') with a comment and `minorEdits`=true.
-   *
-   * ```bash
-   * curl -D- \
-   *   -u admin:admin \
-   *   -X POST \
-   *   -H 'X-Atlassian-Token: nocheck' \
-   *   -F 'file=@"example.txt"' \
-   *   -F 'minorEdit="true"' \
-   *   -F 'comment="Example attachment comment"; type=text/plain; charset=utf-8' \
-   *   http://myhost/rest/api/content/123/child/attachment
-   * ```
+   * attachment, use [Create or update attachments](https://developer.atlassian.com/cloud/confluence/rest/api-group-content---attachments/#api-wiki-rest-api-content-id-child-attachment-put).
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content.
    */
-  async createAttachments<T = Models.ContentArray>(
+  async createAttachments<T = Models.ContentArray<Models.CreatedAttachment>>(
     parameters: Parameters.CreateAttachments,
     callback?: never
   ): Promise<T>;
-  async createAttachments<T = Models.ContentArray>(
+  async createAttachments<T = Models.ContentArray<Models.CreatedAttachment>>(
     parameters: Parameters.CreateAttachments,
     callback?: Callback<T>,
   ): Promise<void | T> {
+    const formData = new FormData();
+    const attachments = Array.isArray(parameters.attachments) ? parameters.attachments : [parameters.attachments];
+
+    attachments.forEach(attachment => {
+      formData.append('minorEdit', attachment.minorEdit.toString(), 'minorEdit');
+      formData.append('file', attachment.file, {
+        filename: attachment.filename,
+        contentType: attachment.contentType,
+      });
+
+      if (attachment.comment) {
+        formData.append('comment', attachment.comment, 'comment');
+      }
+    });
+
     const config: RequestConfig = {
       url: `/api/content/${parameters.id}/child/attachment`,
       method: 'POST',
+      headers: {
+        'X-Atlassian-Token': 'no-check',
+        'Content-Type': 'multipart/form-data',
+        ...formData.getHeaders?.(),
+      },
       params: {
         status: parameters.status,
       },
-      data: {
-        ...parameters,
-        id: undefined,
-        status: undefined,
-      },
+      data: formData,
     };
 
     return this.client.sendRequest(config, callback);
@@ -143,36 +108,9 @@ export class ContentAttachments {
    * Adds an attachment to a piece of content. If the attachment already exists for the content, then the attachment is
    * updated (i.e. a new version of the attachment is created).
    *
-   * Note, you must set a `X-Atlassian-Token: nocheck` header on the request for this method, otherwise it will be
-   * blocked. This protects against XSRF attacks, which is necessary as this method accepts multipart/form-data.
-   *
-   * The media type 'multipart/form-data' is defined in [RFC 7578](https://www.ietf.org/rfc/rfc7578.txt). Most client
-   * libraries have classes that make it easier to implement multipart posts, like the
-   * [MultipartEntityBuilder](https://hc.apache.org/httpcomponents-client-5.1.x/current/httpclient5/apidocs/) Java class
-   * provided by Apache HTTP Components.
-   *
-   * Note, according to [RFC 7578](https://tools.ietf.org/html/rfc7578#section-4.5), in the case where the form data is
-   * text, the charset parameter for the "text/plain" Content-Type may be used to indicate the character encoding used
-   * in that part. In the case of this API endpoint, the `comment` body parameter should be sent with `type=text/plain`
-   * and `charset=utf-8` values. This will force the charset to be UTF-8.
-   *
-   * Example: This curl command attaches a file ('example.txt') to a piece of content (id='123') with a comment and
-   * `minorEdits`=true. If the 'example.txt' file already exists, it will update it with a new version of the attachment.
-   *
-   * ```bash
-   * curl -D- \
-   *   -u admin:admin \
-   *   -X PUT \
-   *   -H 'X-Atlassian-Token: nocheck' \
-   *   -F 'file=@"example.txt"' \
-   *   -F 'minorEdit="true"' \
-   *   -F 'comment="Example attachment comment"; type=text/plain; charset=utf-8' \
-   *   http://myhost/rest/api/content/123/child/attachment
-   * ```
-   *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content.
    */
-  async createOrUpdateAttachments<T = Models.ContentArray>(
+  async createOrUpdateAttachments<T = Models.ContentArray<Models.CreatedAttachment>>(
     parameters: Parameters.CreateOrUpdateAttachments,
     callback: Callback<T>
   ): Promise<void>;
@@ -180,54 +118,43 @@ export class ContentAttachments {
    * Adds an attachment to a piece of content. If the attachment already exists for the content, then the attachment is
    * updated (i.e. a new version of the attachment is created).
    *
-   * Note, you must set a `X-Atlassian-Token: nocheck` header on the request for this method, otherwise it will be
-   * blocked. This protects against XSRF attacks, which is necessary as this method accepts multipart/form-data.
-   *
-   * The media type 'multipart/form-data' is defined in [RFC 7578](https://www.ietf.org/rfc/rfc7578.txt). Most client
-   * libraries have classes that make it easier to implement multipart posts, like the
-   * [MultipartEntityBuilder](https://hc.apache.org/httpcomponents-client-5.1.x/current/httpclient5/apidocs/) Java class
-   * provided by Apache HTTP Components.
-   *
-   * Note, according to [RFC 7578](https://tools.ietf.org/html/rfc7578#section-4.5), in the case where the form data is
-   * text, the charset parameter for the "text/plain" Content-Type may be used to indicate the character encoding used
-   * in that part. In the case of this API endpoint, the `comment` body parameter should be sent with `type=text/plain`
-   * and `charset=utf-8` values. This will force the charset to be UTF-8.
-   *
-   * Example: This curl command attaches a file ('example.txt') to a piece of content (id='123') with a comment and
-   * `minorEdits`=true. If the 'example.txt' file already exists, it will update it with a new version of the attachment.
-   *
-   * ```bash
-   * curl -D- \
-   *   -u admin:admin \
-   *   -X PUT \
-   *   -H 'X-Atlassian-Token: nocheck' \
-   *   -F 'file=@"example.txt"' \
-   *   -F 'minorEdit="true"' \
-   *   -F 'comment="Example attachment comment"; type=text/plain; charset=utf-8' \
-   *   http://myhost/rest/api/content/123/child/attachment
-   * ```
-   *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content.
    */
-  async createOrUpdateAttachments<T = Models.ContentArray>(
+  async createOrUpdateAttachments<T = Models.ContentArray<Models.CreatedAttachment>>(
     parameters: Parameters.CreateOrUpdateAttachments,
     callback?: never
   ): Promise<T>;
-  async createOrUpdateAttachments<T = Models.ContentArray>(
+  async createOrUpdateAttachments<T = Models.ContentArray<Models.CreatedAttachment>>(
     parameters: Parameters.CreateOrUpdateAttachments,
     callback?: Callback<T>,
   ): Promise<void | T> {
+    const formData = new FormData();
+    const attachments = Array.isArray(parameters.attachments) ? parameters.attachments : [parameters.attachments];
+
+    attachments.forEach(attachment => {
+      formData.append('minorEdit', attachment.minorEdit.toString(), 'minorEdit');
+      formData.append('file', attachment.file, {
+        filename: attachment.filename,
+        contentType: attachment.contentType,
+      });
+
+      if (attachment.comment) {
+        formData.append('comment', attachment.comment, 'comment');
+      }
+    });
+
     const config: RequestConfig = {
       url: `/api/content/${parameters.id}/child/attachment`,
       method: 'PUT',
+      headers: {
+        'X-Atlassian-Token': 'no-check',
+        'Content-Type': 'multipart/form-data',
+        ...formData.getHeaders?.(),
+      },
       params: {
         status: parameters.status,
       },
-      data: {
-        ...parameters,
-        id: undefined,
-        status: undefined,
-      },
+      data: formData,
     };
 
     return this.client.sendRequest(config, callback);
@@ -239,7 +166,7 @@ export class ContentAttachments {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content.
    */
-  async updateAttachmentProperties<T = Models.Content>(
+  async updateAttachmentProperties<T = Models.CreatedAttachment>(
     parameters: Parameters.UpdateAttachmentProperties,
     callback: Callback<T>
   ): Promise<void>;
@@ -249,18 +176,18 @@ export class ContentAttachments {
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content.
    */
-  async updateAttachmentProperties<T = Models.Content>(
+  async updateAttachmentProperties<T = Models.CreatedAttachment>(
     parameters: Parameters.UpdateAttachmentProperties,
     callback?: never
   ): Promise<T>;
-  async updateAttachmentProperties<T = Models.Content>(
+  async updateAttachmentProperties<T = Models.CreatedAttachment>(
     parameters: Parameters.UpdateAttachmentProperties,
     callback?: Callback<T>,
   ): Promise<void | T> {
     const config: RequestConfig = {
       url: `/api/content/${parameters.id}/child/attachment/${parameters.attachmentId}`,
       method: 'PUT',
-      data: parameters.body,
+      data: parameters.update ?? parameters.body,
     };
 
     return this.client.sendRequest(config, callback);
@@ -269,106 +196,67 @@ export class ContentAttachments {
   /**
    * Updates the binary data of an attachment, given the attachment ID, and optionally the comment and the minor edit field.
    *
-   * This method is essentially the same as [Create or update attachments](#api-content-id-child-attachment-put), except
+   * This method is essentially the same as [Create or update attachments](https://developer.atlassian.com/cloud/confluence/rest/api-group-content---attachments/#api-wiki-rest-api-content-id-child-attachment-put), except
    * that it matches the attachment ID rather than the name.
    *
-   * Note, you must set a `X-Atlassian-Token: nocheck` header on the request for this method, otherwise it will be
-   * blocked. This protects against XSRF attacks, which is necessary as this method accepts multipart/form-data.
-   *
-   * The media type 'multipart/form-data' is defined in [RFC 7578](https://www.ietf.org/rfc/rfc7578.txt). Most client
-   * libraries have classes that make it easier to implement multipart posts, like the
-   * [MultipartEntityBuilder](https://hc.apache.org/httpcomponents-client-5.1.x/current/httpclient5/apidocs/) Java class
-   * provided by Apache HTTP Components.
-   *
-   * Note, according to [RFC 7578](https://tools.ietf.org/html/rfc7578#section-4.5), in the case where the form data is
-   * text, the charset parameter for the "text/plain" Content-Type may be used to indicate the character encoding used
-   * in that part. In the case of this API endpoint, the `comment` body parameter should be sent with `type=text/plain`
-   * and `charset=utf-8` values. This will force the charset to be UTF-8.
-   *
-   * Example: This curl command updates an attachment (id='att456') that is attached to a piece of content (id='123')
-   * with a comment and `minorEdits`=true.
-   *
-   * ```bash
-   * curl -D- \
-   *   -u admin:admin \
-   *   -X POST \
-   *   -H 'X-Atlassian-Token: nocheck' \
-   *   -F 'file=@"example.txt"' \
-   *   -F 'minorEdit="true"' \
-   *   -F 'comment="Example attachment comment"; type=text/plain; charset=utf-8' \
-   *   http://myhost/rest/api/content/123/child/attachment/att456/data
-   * ```
-   *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content.
    */
-  async updateAttachmentData<T = Models.Content>(
+  async updateAttachmentData<T = Models.CreatedAttachment>(
     parameters: Parameters.UpdateAttachmentData,
     callback: Callback<T>
   ): Promise<void>;
   /**
    * Updates the binary data of an attachment, given the attachment ID, and optionally the comment and the minor edit field.
    *
-   * This method is essentially the same as [Create or update attachments](#api-content-id-child-attachment-put), except
+   * This method is essentially the same as [Create or update attachments](https://developer.atlassian.com/cloud/confluence/rest/api-group-content---attachments/#api-wiki-rest-api-content-id-child-attachment-put), except
    * that it matches the attachment ID rather than the name.
    *
-   * Note, you must set a `X-Atlassian-Token: nocheck` header on the request for this method, otherwise it will be
-   * blocked. This protects against XSRF attacks, which is necessary as this method accepts multipart/form-data.
-   *
-   * The media type 'multipart/form-data' is defined in [RFC 7578](https://www.ietf.org/rfc/rfc7578.txt). Most client
-   * libraries have classes that make it easier to implement multipart posts, like the
-   * [MultipartEntityBuilder](https://hc.apache.org/httpcomponents-client-5.1.x/current/httpclient5/apidocs/) Java class
-   * provided by Apache HTTP Components.
-   *
-   * Note, according to [RFC 7578](https://tools.ietf.org/html/rfc7578#section-4.5), in the case where the form data is
-   * text, the charset parameter for the "text/plain" Content-Type may be used to indicate the character encoding used
-   * in that part. In the case of this API endpoint, the `comment` body parameter should be sent with `type=text/plain`
-   * and `charset=utf-8` values. This will force the charset to be UTF-8.
-   *
-   * Example: This curl command updates an attachment (id='att456') that is attached to a piece of content (id='123')
-   * with a comment and `minorEdits`=true.
-   *
-   * ```bash
-   * curl -D- \
-   *   -u admin:admin \
-   *   -X POST \
-   *   -H 'X-Atlassian-Token: nocheck' \
-   *   -F 'file=@"example.txt"' \
-   *   -F 'minorEdit="true"' \
-   *   -F 'comment="Example attachment comment"; type=text/plain; charset=utf-8' \
-   *   http://myhost/rest/api/content/123/child/attachment/att456/data
-   * ```
-   *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to update the content.
    */
-  async updateAttachmentData<T = Models.Content>(
+  async updateAttachmentData<T = Models.CreatedAttachment>(
     parameters: Parameters.UpdateAttachmentData,
     callback?: never
   ): Promise<T>;
-  async updateAttachmentData<T = Models.Content>(
+  async updateAttachmentData<T = Models.CreatedAttachment>(
     parameters: Parameters.UpdateAttachmentData,
     callback?: Callback<T>,
   ): Promise<void | T> {
+    const { attachment } = parameters;
+
+    const formData = new FormData();
+
+    formData.append('minorEdit', attachment.minorEdit.toString(), 'minorEdit');
+    formData.append('file', attachment.file, {
+      filename: attachment.filename,
+      contentType: attachment.contentType,
+    });
+
+    if (attachment.comment) {
+      formData.append('comment', attachment.comment, 'comment');
+    }
+
     const config: RequestConfig = {
       url: `/api/content/${parameters.id}/child/attachment/${parameters.attachmentId}/data`,
       method: 'POST',
-      data: {
-        ...parameters,
-        id: undefined,
-        attachmentId: undefined,
+      headers: {
+        'X-Atlassian-Token': 'no-check',
+        'Content-Type': 'multipart/form-data',
+        ...formData.getHeaders?.(),
       },
+      data: formData,
     };
 
     return this.client.sendRequest(config, callback);
   }
 
   /** Redirects the client to a URL that serves an attachment's binary data. */
-  async downloadAttachment<T = ArrayBuffer>(
+  async downloadAttachment<T = Buffer>(
     parameters: Parameters.DownloadAttachment,
     callback: Callback<T>
   ): Promise<void>;
   /** Redirects the client to a URL that serves an attachment's binary data. */
-  async downloadAttachment<T = ArrayBuffer>(parameters: Parameters.DownloadAttachment, callback?: never): Promise<T>;
-  async downloadAttachment<T = ArrayBuffer>(
+  async downloadAttachment<T = Buffer>(parameters: Parameters.DownloadAttachment, callback?: never): Promise<T>;
+  async downloadAttachment<T = Buffer>(
     parameters: Parameters.DownloadAttachment,
     callback?: Callback<T>,
   ): Promise<void | T> {

package/src/api/contentBody.ts

@@ -1,7 +1,7 @@
 import * as Models from './models';
 import * as Parameters from './parameters';
-import { Client } from '../clients';
 import { Callback } from '../callback';
+import { Client } from '../clients';
 import { RequestConfig } from '../requestConfig';
 
 export class ContentBody {

package/src/api/contentChildrenAndDescendants.ts

@@ -1,7 +1,7 @@
 import * as Models from './models';
 import * as Parameters from './parameters';
-import { Client } from '../clients';
 import { Callback } from '../callback';
+import { Client } from '../clients';
 import { RequestConfig } from '../requestConfig';
 
 export class ContentChildrenAndDescendants {
@@ -302,7 +302,10 @@ export class ContentChildrenAndDescendants {
    * of renaming page titles during the copy; for example, search and replace can be used in conjunction to rewrite the
    * copied page titles.
    */
-  async copyPageHierarchy<T = unknown>(parameters: Parameters.CopyPageHierarchy, callback: Callback<T>): Promise<void>;
+  async copyPageHierarchy<T = Models.LongTask>(
+    parameters: Parameters.CopyPageHierarchy,
+    callback: Callback<T>
+  ): Promise<void>;
   /**
    * Copy page hierarchy allows the copying of an entire hierarchy of pages and their associated properties, permissions
    * and attachments. The id path parameter refers to the content id of the page to copy, and the new parent of this
@@ -310,8 +313,8 @@ export class ContentChildrenAndDescendants {
    * of renaming page titles during the copy; for example, search and replace can be used in conjunction to rewrite the
    * copied page titles.
    */
-  async copyPageHierarchy<T = unknown>(parameters: Parameters.CopyPageHierarchy, callback?: never): Promise<T>;
-  async copyPageHierarchy<T = unknown>(
+  async copyPageHierarchy<T = Models.LongTask>(parameters: Parameters.CopyPageHierarchy, callback?: never): Promise<T>;
+  async copyPageHierarchy<T = Models.LongTask>(
     parameters: Parameters.CopyPageHierarchy,
     callback?: Callback<T>,
   ): Promise<void | T> {
@@ -324,6 +327,7 @@ export class ContentChildrenAndDescendants {
         copyProperties: parameters.copyProperties,
         copyLabels: parameters.copyLabels,
         copyCustomContents: parameters.copyCustomContents,
+        copyDescendants: parameters.copyDescendants,
         destinationPageId: parameters.destinationPageId,
         titleOptions: parameters.titleOptions,
       },

package/src/api/contentComments.ts

@@ -1,7 +1,7 @@
 import * as Models from './models';
 import * as Parameters from './parameters';
-import { Client } from '../clients';
 import { Callback } from '../callback';
+import { Client } from '../clients';
 import { RequestConfig } from '../requestConfig';
 
 export class ContentComments {

package/src/api/contentContentState.ts

@@ -0,0 +1,157 @@
+import * as Models from './models';
+import * as Parameters from './parameters';
+import { Callback } from '../callback';
+import { Client } from '../clients';
+import { RequestConfig } from '../requestConfig';
+
+export class ContentContentState {
+  constructor(private client: Client) {}
+
+  /**
+   * Gets the current page status of the draft or published version of content. To specify the draft version, set the
+   * parameter status to PUBLISHED, otherwise DRAFT.
+   */
+  async getContentState<T = Models.ContentStateContainer>(
+    parameters: Parameters.GetContentState,
+    callback: Callback<T>
+  ): Promise<void>;
+  /**
+   * Gets the current page status of the draft or published version of content. To specify the draft version, set the
+   * parameter status to PUBLISHED, otherwise DRAFT.
+   */
+  async getContentState<T = Models.ContentStateContainer>(
+    parameters: Parameters.GetContentState,
+    callback?: never
+  ): Promise<T>;
+  async getContentState<T = Models.ContentStateContainer>(
+    parameters: Parameters.GetContentState,
+    callback?: Callback<T>,
+  ): Promise<void | T> {
+    const config: RequestConfig = {
+      url: `/api/content/${parameters.contentId}/state`,
+      method: 'GET',
+      params: {
+        designation: parameters.designation,
+      },
+    };
+
+    return this.client.sendRequest(config, callback);
+  }
+
+  /**
+   * Sets the content state of the content specified and creates a new version (publishes the content without changing
+   * the body) of the content with the new status. The desired type of status must be allowed. There are space suggested
+   * statuses and custom statuses. To specify the desired new status, one can use the id of the status or the name and
+   * color of the status. If contentStateId is defined, then name and color are ignored. If contentStateId is not
+   * defined, name and color will be used if provided. Firstly, we will determine if a status of this name and color
+   * exists, and if it does, that this status is used. If it does not exist, and custom statuses are allowed, a custom
+   * status with this name and color will be created. Color can be specified in traditional english colors (teal,
+   * magenta, lavender, etc.) or as a hex string ex: #0ff0Fd.
+   */
+  async setContentState<T = Models.ContentStateContainer>(
+    parameters: Parameters.SetContentState,
+    callback: Callback<T>
+  ): Promise<void>;
+  /**
+   * Sets the content state of the content specified and creates a new version (publishes the content without changing
+   * the body) of the content with the new status. The desired type of status must be allowed. There are space suggested
+   * statuses and custom statuses. To specify the desired new status, one can use the id of the status or the name and
+   * color of the status. If contentStateId is defined, then name and color are ignored. If contentStateId is not
+   * defined, name and color will be used if provided. Firstly, we will determine if a status of this name and color
+   * exists, and if it does, that this status is used. If it does not exist, and custom statuses are allowed, a custom
+   * status with this name and color will be created. Color can be specified in traditional english colors (teal,
+   * magenta, lavender, etc.) or as a hex string ex: #0ff0Fd.
+   */
+  async setContentState<T = Models.ContentStateContainer>(
+    parameters: Parameters.SetContentState,
+    callback?: never
+  ): Promise<T>;
+  async setContentState<T = Models.ContentStateContainer>(
+    parameters: Parameters.SetContentState,
+    callback?: Callback<T>,
+  ): Promise<void | T> {
+    const config: RequestConfig = {
+      url: `/api/content/${parameters.contentId}/state`,
+      method: 'PUT',
+      params: {
+        contentStateId: parameters.contentStateId,
+        name: parameters.name,
+        color: parameters.color,
+      },
+    };
+
+    return this.client.sendRequest(config, callback);
+  }
+
+  /**
+   * Removes the content state of the content specified and creates a new version (publishes the content without
+   * changing the body) of the content with the new status.
+   */
+  async removeContentState<T = Models.ContentStateContainer>(
+    parameters: Parameters.RemoveContentState,
+    callback: Callback<T>
+  ): Promise<void>;
+  /**
+   * Removes the content state of the content specified and creates a new version (publishes the content without
+   * changing the body) of the content with the new status.
+   */
+  async removeContentState<T = Models.ContentStateContainer>(
+    parameters: Parameters.RemoveContentState,
+    callback?: never
+  ): Promise<T>;
+  async removeContentState<T = Models.ContentStateContainer>(
+    parameters: Parameters.RemoveContentState,
+    callback?: Callback<T>,
+  ): Promise<void | T> {
+    const config: RequestConfig = {
+      url: `/api/content/${parameters.contentId}/state`,
+      method: 'DELETE',
+    };
+
+    return this.client.sendRequest(config, callback);
+  }
+
+  /** Gets a Global Timestamp of the last time the content state was updated */
+  async getContentStateLastUpdated<T = unknown>(
+    parameters: Parameters.GetContentStateLastUpdated,
+    callback: Callback<T>
+  ): Promise<void>;
+  /** Gets a Global Timestamp of the last time the content state was updated */
+  async getContentStateLastUpdated<T = unknown>(
+    parameters: Parameters.GetContentStateLastUpdated,
+    callback?: never
+  ): Promise<T>;
+  async getContentStateLastUpdated<T = unknown>(
+    parameters: Parameters.GetContentStateLastUpdated,
+    callback?: Callback<T>,
+  ): Promise<void | T> {
+    const config: RequestConfig = {
+      url: `/api/content/${parameters.contentId}/state/last-updated`,
+      method: 'GET',
+    };
+
+    return this.client.sendRequest(config, callback);
+  }
+
+  /** Gets content states that are available for the content to be set as. */
+  async getAvailableContentStates<T = Models.AvailableContentStates>(
+    parameters: Parameters.GetAvailableContentStates,
+    callback: Callback<T>
+  ): Promise<void>;
+  /** Gets content states that are available for the content to be set as. */
+  async getAvailableContentStates<T = Models.AvailableContentStates>(
+    parameters: Parameters.GetAvailableContentStates,
+    callback?: never
+  ): Promise<T>;
+  async getAvailableContentStates<T = Models.AvailableContentStates>(
+    parameters: Parameters.GetAvailableContentStates,
+    callback?: Callback<T>,
+  ): Promise<void | T> {
+    const config: RequestConfig = {
+      url: `/api/content/${parameters.contentId}/state/available-states`,
+      method: 'GET',
+    };
+
+    return this.client.sendRequest(config, callback);
+  }
+}

package/src/api/contentLabels.ts

@@ -1,7 +1,7 @@
 import * as Models from './models';
 import * as Parameters from './parameters';
-import { Client } from '../clients';
 import { Callback } from '../callback';
+import { Client } from '../clients';
 import { RequestConfig } from '../requestConfig';
 
 export class ContentLabels {

package/src/api/contentMacroBody.ts

@@ -1,7 +1,7 @@
 import * as Models from './models';
 import * as Parameters from './parameters';
-import { Client } from '../clients';
 import { Callback } from '../callback';
+import { Client } from '../clients';
 import { RequestConfig } from '../requestConfig';
 
 export class ContentMacroBody {