confluence.js 2.0.0 → 2.1.0

package/dist/esm/types/api/userProperties.d.ts

@@ -0,0 +1,102 @@
+import type * as Models from "./models/index.js";
+import type * as Parameters from "./parameters/index.js";
+import type { Client } from "../clients/index.js";
+import type { Callback } from "../callback.js";
+export declare class UserProperties {
+    private client;
+    constructor(client: Client);
+    /**
+     * Returns the properties for a user as list of property keys. For more information about user properties, see
+     * [Confluence entity properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/).
+     * `Note`, these properties stored against a user are on a Confluence site level and not space/content level.
+     *
+     * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
+     * ('Can use' global permission).
+     */
+    getUserProperties<T = Models.UserPropertyKeyArray>(parameters: Parameters.GetUserProperties, callback: Callback<T>): Promise<void>;
+    /**
+     * Returns the properties for a user as list of property keys. For more information about user properties, see
+     * [Confluence entity properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/).
+     * `Note`, these properties stored against a user are on a Confluence site level and not space/content level.
+     *
+     * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
+     * ('Can use' global permission).
+     */
+    getUserProperties<T = Models.UserPropertyKeyArray>(parameters: Parameters.GetUserProperties, callback?: never): Promise<T>;
+    /**
+     * Returns the property corresponding to `key` for a user. For more information about user properties, see [Confluence
+     * entity properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). `Note`, these
+     * properties stored against a user are on a Confluence site level and not space/content level.
+     *
+     * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
+     * ('Can use' global permission).
+     */
+    getUserProperty<T = Models.UserProperty>(parameters: Parameters.GetUserProperty, callback: Callback<T>): Promise<void>;
+    /**
+     * Returns the property corresponding to `key` for a user. For more information about user properties, see [Confluence
+     * entity properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). `Note`, these
+     * properties stored against a user are on a Confluence site level and not space/content level.
+     *
+     * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
+     * ('Can use' global permission).
+     */
+    getUserProperty<T = Models.UserProperty>(parameters: Parameters.GetUserProperty, callback?: never): Promise<T>;
+    /**
+     * Creates a property for a user. For more information about user properties, see [Confluence entity properties]
+     * (https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). `Note`, these properties stored
+     * against a user are on a Confluence site level and not space/content level.
+     *
+     * `Note:` the number of properties which could be created per app in a tenant for each user might be restricted by
+     * fixed system limits. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access
+     * the Confluence site ('Can use' global permission).
+     */
+    createUserProperty<T = unknown>(parameters: Parameters.CreateUserProperty, callback: Callback<T>): Promise<void>;
+    /**
+     * Creates a property for a user. For more information about user properties, see [Confluence entity properties]
+     * (https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). `Note`, these properties stored
+     * against a user are on a Confluence site level and not space/content level.
+     *
+     * `Note:` the number of properties which could be created per app in a tenant for each user might be restricted by
+     * fixed system limits. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access
+     * the Confluence site ('Can use' global permission).
+     */
+    createUserProperty<T = unknown>(parameters: Parameters.CreateUserProperty, callback?: never): Promise<T>;
+    /**
+     * Updates a property for the given user. Note, you cannot update the key of a user property, only the value. For more
+     * information about user properties, see [Confluence entity
+     * properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). `Note`, these
+     * properties stored against a user are on a Confluence site level and not space/content level.
+     *
+     * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
+     * ('Can use' global permission).
+     */
+    updateUserProperty<T = void>(parameters: Parameters.UpdateUserProperty, callback: Callback<T>): Promise<void>;
+    /**
+     * Updates a property for the given user. Note, you cannot update the key of a user property, only the value. For more
+     * information about user properties, see [Confluence entity
+     * properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). `Note`, these
+     * properties stored against a user are on a Confluence site level and not space/content level.
+     *
+     * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
+     * ('Can use' global permission).
+     */
+    updateUserProperty<T = void>(parameters: Parameters.UpdateUserProperty, callback?: never): Promise<T>;
+    /**
+     * Deletes a property for the given user. For more information about user properties, see [Confluence entity
+     * properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). `Note`, these
+     * properties stored against a user are on a Confluence site level and not space/content level.
+     *
+     * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
+     * ('Can use' global permission).
+     */
+    deleteUserProperty<T = void>(parameters: Parameters.DeleteUserProperty, callback: Callback<T>): Promise<void>;
+    /**
+     * Deletes a property for the given user. For more information about user properties, see [Confluence entity
+     * properties](https://developer.atlassian.com/cloud/confluence/confluence-entity-properties/). `Note`, these
+     * properties stored against a user are on a Confluence site level and not space/content level.
+     *
+     * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
+     * ('Can use' global permission).
+     */
+    deleteUserProperty<T = void>(parameters: Parameters.DeleteUserProperty, callback?: never): Promise<T>;
+}

package/dist/esm/types/api/users.d.ts

@@ -1,7 +1,7 @@
 import type * as Models from "./models/index.js";
 import type * as Parameters from "./parameters/index.js";
-import type { Callback } from "../callback.js";
 import type { Client } from "../clients/index.js";
+import type { Callback } from "../callback.js";
 export declare class Users {
     private client;
     constructor(client: Client);
@@ -72,39 +72,46 @@ export declare class Users {
      */
     getGroupMembershipsForUser<T = Models.GroupArrayWithLinks>(parameters: Parameters.GetGroupMembershipsForUser, callback?: never): Promise<T>;
     /**
-     * Returns user details for the ids provided in request.
+     * Returns user details for the ids provided in the request. Currently this API returns a maximum of 100 results. If
+     * more than 100 account ids are passed in, then the first 100 will be returned.
      *
      * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
      * ('Can use' global permission).
      */
     getBulkUserLookup<T = Models.BulkUserLookupArray>(parameters: Parameters.GetBulkUserLookup, callback: Callback<T>): Promise<void>;
     /**
-     * Returns user details for the ids provided in request.
+     * Returns user details for the ids provided in the request. Currently this API returns a maximum of 100 results. If
+     * more than 100 account ids are passed in, then the first 100 will be returned.
      *
      * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
      * ('Can use' global permission).
      */
     getBulkUserLookup<T = Models.BulkUserLookupArray>(parameters: Parameters.GetBulkUserLookup, callback?: never): Promise<T>;
     /**
-     * Returns a user's email address. This API is only available to apps approved by Atlassian, according to these
+     * Returns a user's email address regardless of the user’s profile visibility settings. For Connect apps, this API is
+     * only available to apps approved by Atlassian, according to these
      * [guidelines](https://community.developer.atlassian.com/t/guidelines-for-requesting-access-to-email-address/27603).
+     * For Forge apps, this API only supports access via asApp() requests.
      *
      * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
      * ('Can use' global permission).
      */
     getPrivacyUnsafeUserEmail<T = Models.AccountIdEmailRecord>(parameters: Parameters.GetPrivacyUnsafeUserEmail, callback: Callback<T>): Promise<void>;
     /**
-     * Returns a user's email address. This API is only available to apps approved by Atlassian, according to these
+     * Returns a user's email address regardless of the user’s profile visibility settings. For Connect apps, this API is
+     * only available to apps approved by Atlassian, according to these
      * [guidelines](https://community.developer.atlassian.com/t/guidelines-for-requesting-access-to-email-address/27603).
+     * For Forge apps, this API only supports access via asApp() requests.
      *
      * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to access the Confluence site
      * ('Can use' global permission).
      */
     getPrivacyUnsafeUserEmail<T = Models.AccountIdEmailRecord>(parameters: Parameters.GetPrivacyUnsafeUserEmail, callback?: never): Promise<T>;
     /**
-     * Returns user email addresses for a set of accountIds. This API is only available to apps approved by Atlassian,
-     * according to these
+     * Returns a user's email address regardless of the user’s profile visibility settings. For Connect apps, this API is
+     * only available to apps approved by Atlassian, according to these
      * [guidelines](https://community.developer.atlassian.com/t/guidelines-for-requesting-access-to-email-address/27603).
+     * For Forge apps, this API only supports access via asApp() requests.
      *
      * Any accounts which are not available will not be included in the result.
      *
@@ -113,9 +120,10 @@ export declare class Users {
      */
     getPrivacyUnsafeUserEmailBulk<T = Models.AccountIdEmailRecordArray>(parameters: Parameters.GetPrivacyUnsafeUserEmailBulk, callback: Callback<T>): Promise<void>;
     /**
-     * Returns user email addresses for a set of accountIds. This API is only available to apps approved by Atlassian,
-     * according to these
+     * Returns a user's email address regardless of the user’s profile visibility settings. For Connect apps, this API is
+     * only available to apps approved by Atlassian, according to these
      * [guidelines](https://community.developer.atlassian.com/t/guidelines-for-requesting-access-to-email-address/27603).
+     * For Forge apps, this API only supports access via asApp() requests.
      *
      * Any accounts which are not available will not be included in the result.
      *
@@ -129,6 +137,8 @@ export declare class Users {
      *
      * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission
      * if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission).
+     *
+     * @deprecated Will be removed in next major version.
      */
     getBulkUserMigration<T = Models.MigratedUserArray>(parameters: Parameters.GetBulkUserMigration, callback: Callback<T>): Promise<void>;
     /**
@@ -137,6 +147,8 @@ export declare class Users {
      *
      * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission
      * if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission).
+     *
+     * @deprecated Will be removed in next major version.
      */
     getBulkUserMigration<T = Models.MigratedUserArray>(parameters: Parameters.GetBulkUserMigration, callback?: never): Promise<T>;
 }

package/dist/esm/types/clients/confluenceClient.d.ts

@@ -1,6 +1,6 @@
 import { BaseClient } from "./baseClient.js";
 import type { Config } from "../config.js";
-import { Analytics, Audit, Content, ContentAttachments, ContentBody, ContentChildrenAndDescendants, ContentComments, ContentLabels, ContentMacroBody, ContentPermissions, ContentProperties, ContentRestrictions, ContentStates, ContentVersions, ContentWatches, DynamicModules, Experimental, Group, InlineTasks, LabelInfo, LongRunningTask, Relation, Search, Settings, Space, SpacePermissions, SpaceProperties, SpaceSettings, Template, Themes, Users } from "../api/index.js";
+import { Analytics, Audit, Content, ContentAttachments, ContentBody, ContentChildrenAndDescendants, ContentComments, ContentLabels, ContentMacroBody, ContentPermissions, ContentProperties, ContentRestrictions, ContentStates, ContentVersions, ContentWatches, DynamicModules, Experimental, Group, InlineTasks, LabelInfo, LongRunningTask, Relation, Search, Settings, Space, SpacePermissions, SpaceProperties, SpaceSettings, Template, Themes, Users, UserProperties } from "../api/index.js";
 export declare class ConfluenceClient extends BaseClient {
     constructor(config: Config);
     analytics: Analytics;
@@ -9,10 +9,12 @@ export declare class ConfluenceClient extends BaseClient {
     contentAttachments: ContentAttachments;
     contentBody: ContentBody;
     contentChildrenAndDescendants: ContentChildrenAndDescendants;
+    /** @deprecated Will be removed in next major version. */
     contentComments: ContentComments;
     contentLabels: ContentLabels;
     contentMacroBody: ContentMacroBody;
     contentPermissions: ContentPermissions;
+    /** @deprecated Will be removed in next major version. */
     contentProperties: ContentProperties;
     contentRestrictions: ContentRestrictions;
     contentStates: ContentStates;
@@ -21,6 +23,7 @@ export declare class ConfluenceClient extends BaseClient {
     dynamicModules: DynamicModules;
     experimental: Experimental;
     group: Group;
+    /** @deprecated Will be removed in next major version. */
     inlineTasks: InlineTasks;
     labelInfo: LabelInfo;
     longRunningTask: LongRunningTask;
@@ -29,9 +32,11 @@ export declare class ConfluenceClient extends BaseClient {
     settings: Settings;
     space: Space;
     spacePermissions: SpacePermissions;
+    /** @deprecated Will be removed in next major version. */
     spaceProperties: SpaceProperties;
     spaceSettings: SpaceSettings;
     template: Template;
     themes: Themes;
     users: Users;
+    userProperties: UserProperties;
 }

package/eslint.config.ts

@@ -2,8 +2,7 @@ import js from '@eslint/js';
 import globals from 'globals';
 import tseslint from 'typescript-eslint';
 import { defineConfig } from 'eslint/config';
-import stylisticJs from '@stylistic/eslint-plugin-js';
-import stylisticTs from '@stylistic/eslint-plugin-ts';
+import stylistic from '@stylistic/eslint-plugin';
 
 export default defineConfig([
   { files: ['**/*.{js,mjs,cjs,ts}'], plugins: { js }, extends: ['js/recommended'] },
@@ -17,13 +16,12 @@ export default defineConfig([
       },
     },
     plugins: {
-      '@stylistic/js': stylisticJs,
-      '@stylistic/ts': stylisticTs,
+      '@stylistic': stylistic,
     },
     rules: {
-      '@stylistic/js/no-trailing-spaces': 'error',
-      '@stylistic/ts/indent': ['error', 2],
-      '@stylistic/ts/lines-between-class-members': [
+      '@stylistic/comma-dangle': ['error', 'always-multiline'],
+      '@stylistic/indent': ['error', 2],
+      '@stylistic/lines-between-class-members': [
         'error',
         'always',
         {
@@ -31,7 +29,9 @@ export default defineConfig([
           exceptAfterSingleLine: true,
         },
       ],
-      '@stylistic/ts/padding-line-between-statements': [
+      '@stylistic/no-trailing-spaces': 'error',
+      '@stylistic/object-curly-spacing': ['error', 'always'],
+      '@stylistic/padding-line-between-statements': [
         'error',
         // Return statements
         { blankLine: 'always', prev: '*', next: 'return' },
@@ -39,8 +39,8 @@ export default defineConfig([
         { blankLine: 'always', prev: 'import', next: '*' },
         { blankLine: 'any', prev: 'import', next: 'import' },
       ],
-      '@stylistic/ts/quotes': ['error', 'single'],
-      '@stylistic/ts/semi': ['error', 'always'],
+      '@stylistic/quotes': ['error', 'single'],
+      '@stylistic/semi': ['error', 'always'],
       '@typescript-eslint/consistent-type-imports': [
         'error',
         {
@@ -49,14 +49,9 @@ export default defineConfig([
         },
       ],
       '@typescript-eslint/no-empty-object-type': 'off',
-      '@typescript-eslint/no-redundant-type-constituents': 'off', // todo fix it
-      '@typescript-eslint/no-unnecessary-condition': 'error', // todo fix it
-      '@typescript-eslint/no-unsafe-argument': 'off', // todo fix it
-      '@typescript-eslint/no-unsafe-assignment': 'off', // todo fix it
-      '@typescript-eslint/no-unsafe-call': 'off', // todo fix it
+      '@typescript-eslint/no-unnecessary-condition': 'error',
       '@typescript-eslint/no-unsafe-member-access': 'off',
       '@typescript-eslint/prefer-optional-chain': 'error',
-      '@stylistic/ts/object-curly-spacing': ["error", "always"]
     },
   },
 ]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "confluence.js",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "confluence.js is a powerful Node.JS/Browser module that allows you to interact with the Confluence API very easily",
   "author": "Vladislav Tupikin <vladislav.tupikin@icloud.com>",
   "license": "MIT",
@@ -16,13 +16,13 @@
   "exports": {
     ".": {
       "types": "./dist/esm/types/index.d.ts",
-      "import": "./dist/esm/index.mjs",
-      "require": "./dist/cjs/index.cjs"
+      "require": "./dist/cjs/index.cjs",
+      "import": "./dist/esm/index.mjs"
     },
     "./*": {
       "types": "./dist/esm/types/*.d.ts",
-      "import": "./dist/esm/*.mjs",
-      "require": "./dist/cjs/*.cjs"
+      "require": "./dist/cjs/*.cjs",
+      "import": "./dist/esm/*.mjs"
     },
     "./package.json": "./package.json"
   },
@@ -44,37 +44,36 @@
     "node": ">=20"
   },
   "dependencies": {
-    "atlassian-jwt": "^2.0.3",
-    "axios": "^1.9.0",
-    "form-data": "^4.0.2",
+    "@atlassian/atlassian-jwt": "^2.2.0",
+    "axios": "^1.10.0",
+    "form-data": "^4.0.3",
     "oauth": "^0.10.2",
-    "zod": "^3.24.4"
+    "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@eslint/js": "^9.26.0",
+    "@eslint/js": "^9.31.0",
     "@rollup/plugin-alias": "^5.1.1",
-    "@rollup/plugin-commonjs": "^28.0.3",
+    "@rollup/plugin-commonjs": "^28.0.6",
     "@rollup/plugin-node-resolve": "^16.0.1",
-    "@rollup/plugin-typescript": "^12.1.2",
-    "@stylistic/eslint-plugin-js": "^4.2.0",
-    "@stylistic/eslint-plugin-ts": "^4.2.0",
-    "@types/express": "^4.17.21",
-    "@types/node": "^20.17.46",
+    "@rollup/plugin-typescript": "^12.1.4",
+    "@stylistic/eslint-plugin": "^5.2.0",
+    "@types/express": "^4.17.23",
+    "@types/node": "^20.19.8",
     "@types/oauth": "^0.9.6",
-    "dotenv": "^16.5.0",
-    "eslint": "^9.26.0",
-    "globals": "^16.1.0",
+    "dotenv": "^17.2.0",
+    "eslint": "^9.31.0",
+    "globals": "^16.3.0",
     "jiti": "^2.4.2",
-    "prettier": "^3.5.3",
-    "prettier-plugin-jsdoc": "^1.3.2",
-    "rollup": "^4.40.2",
-    "rollup-plugin-esnext-to-nodenext": "^1.0.0",
-    "rollup-plugin-node-externals": "^8.0.0",
+    "prettier": "^3.6.2",
+    "prettier-plugin-jsdoc": "^1.3.3",
+    "rollup": "^4.45.1",
+    "rollup-plugin-esnext-to-nodenext": "^1.0.1",
+    "rollup-plugin-node-externals": "^8.0.1",
     "tslib": "^2.8.1",
-    "typedoc": "^0.28.4",
+    "typedoc": "^0.28.7",
     "typescript": "^5.8.3",
-    "typescript-eslint": "^8.32.1",
-    "vitest": "^3.1.3"
+    "typescript-eslint": "^8.37.0",
+    "vitest": "^3.2.4"
   },
   "scripts": {
     "build": "rollup -c rollup.config.ts --configPlugin typescript",
@@ -85,6 +84,8 @@
     "lint:fix": "pnpm run lint --fix",
     "test:unit": "vitest run tests/unit --minWorkers=1 --maxWorkers=8 --sequence.concurrent",
     "test:integration": "vitest run tests/integration --bail=1 --no-file-parallelism --max-concurrency 1 -c vitest.config.mts --hookTimeout 100000 --testTimeout 100000",
-    "code:formatting": "npm run prettier && npm run lint:fix"
+    "replace:wiki-rest": "grep -rl '/wiki/rest' src/api | xargs sed -i '' 's|/wiki/rest||g'",
+    "replace:all": "pnpm run replace:wiki-rest",
+    "code:formatting": "pnpm run replace:all && pnpm run prettier && pnpm run lint:fix"
   }
 }

package/src/api/analytics.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 Analytics {

package/src/api/audit.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 Audit {
@@ -155,7 +155,7 @@ export class Audit {
   }
 
   /**
-   * Sets the retention period for records in the audit log. The retention period can be set to a maximum of 20 years.
+   * Sets the retention period for records in the audit log. The retention period can be set to a maximum of 1 year.
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global
    * permission.
@@ -165,7 +165,7 @@ export class Audit {
     callback: Callback<T>,
   ): Promise<void>;
   /**
-   * Sets the retention period for records in the audit log. The retention period can be set to a maximum of 20 years.
+   * Sets the retention period for records in the audit log. The retention period can be set to a maximum of 1 year.
    *
    * **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global
    * permission.

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,
       },
     };