@getbrevo/brevo 5.0.3 → 6.0.1

package/dist/esm/api/resources/balance/client/requests/GetContactBalancesRequest.d.mts

@@ -1,7 +1,9 @@
+import type * as Brevo from "../../../../index.mjs";
 /**
  * @example
  *     {
- *         pid: "pid"
+ *         pid: "pid",
+ *         balanceDefinitionId: "balanceDefinitionId"
  *     }
  */
 export interface GetContactBalancesRequest {
@@ -9,4 +11,14 @@ export interface GetContactBalancesRequest {
     pid: string;
     /** Include balances tied to internal definitions. */
     includeInternal?: boolean;
+    /** Limit the number of records returned */
+    limit?: number;
+    /** Skip a number of records */
+    offset?: number;
+    /** Sort order */
+    sort?: Brevo.GetContactBalancesRequestSort;
+    /** Field to sort by */
+    sortField?: Brevo.GetContactBalancesRequestSortField;
+    /** Balance Definition ID (required) */
+    balanceDefinitionId: string;
 }

package/dist/esm/api/resources/balance/client/requests/GetLoyaltyBalanceProgramsPidActiveBalanceRequest.d.mts

@@ -1,9 +1,10 @@
+import type * as Brevo from "../../../../index.mjs";
 /**
  * @example
  *     {
  *         pid: "pid",
- *         contact_id: 1,
- *         balance_definition_id: "balance_definition_id"
+ *         contactId: 1000000,
+ *         balanceDefinitionId: "balanceDefinitionId"
  *     }
  */
 export interface GetLoyaltyBalanceProgramsPidActiveBalanceRequest {
@@ -14,13 +15,13 @@ export interface GetLoyaltyBalanceProgramsPidActiveBalanceRequest {
     /** Offset */
     offset?: number;
     /** Sort Field */
-    sort_field?: string;
+    sortField?: "createdAt";
     /** Sort Order */
-    sort?: string;
+    sort?: Brevo.GetLoyaltyBalanceProgramsPidActiveBalanceRequestSort;
     /** Contact ID */
-    contact_id: number;
+    contactId: number;
     /** Balance Definition ID */
-    balance_definition_id: string;
+    balanceDefinitionId: string;
     /** Include balances tied to internal definitions. */
     includeInternal?: boolean;
 }

package/dist/esm/api/resources/balance/client/requests/GetLoyaltyBalanceProgramsPidTransactionHistoryRequest.d.mts

@@ -3,7 +3,7 @@ import type * as Brevo from "../../../../index.mjs";
  * @example
  *     {
  *         pid: "pid",
- *         contactId: 1,
+ *         contactId: 1000000,
  *         balanceDefinitionId: "balanceDefinitionId"
  *     }
  */
@@ -16,16 +16,16 @@ export interface GetLoyaltyBalanceProgramsPidTransactionHistoryRequest {
     offset?: number;
     /** Field to sort by */
     sortField?: "createdAt";
-    /** Sort order, either asc or desc */
+    /** Sort order */
     sort?: Brevo.GetLoyaltyBalanceProgramsPidTransactionHistoryRequestSort;
     /** Contact ID */
     contactId: number;
     /** Balance Definition ID */
     balanceDefinitionId: string;
-    /** Filters to apply */
-    filters?: string | string[];
-    /** Transaction status filter. Allowed values: draft, completed, rejected, cancelled, expired */
+    /** Transaction status filter */
     status?: Brevo.GetLoyaltyBalanceProgramsPidTransactionHistoryRequestStatus;
-    /** Transaction type filter. Allowed values: credit, debit */
+    /** Transaction type filter */
     transactionType?: Brevo.GetLoyaltyBalanceProgramsPidTransactionHistoryRequestTransactionType;
+    /** Loyalty Subscription ID filter */
+    loyaltySubscriptionId?: string;
 }

package/dist/esm/api/resources/balance/client/requests/index.d.mts

@@ -1,8 +1,8 @@
-export type { BeginTransactionRequest } from "./BeginTransactionRequest.mjs";
+export { BeginTransactionRequest } from "./BeginTransactionRequest.mjs";
 export type { CancelTransactionRequest } from "./CancelTransactionRequest.mjs";
 export type { CompleteTransactionRequest } from "./CompleteTransactionRequest.mjs";
 export { CreateBalanceLimitRequest } from "./CreateBalanceLimitRequest.mjs";
-export type { CreateBalanceOrderRequest } from "./CreateBalanceOrderRequest.mjs";
+export { CreateBalanceOrderRequest } from "./CreateBalanceOrderRequest.mjs";
 export type { DeleteBalanceDefinitionRequest } from "./DeleteBalanceDefinitionRequest.mjs";
 export type { DeleteBalanceLimitRequest } from "./DeleteBalanceLimitRequest.mjs";
 export type { GetBalanceDefinitionListRequest } from "./GetBalanceDefinitionListRequest.mjs";

package/dist/esm/api/resources/balance/client/requests/index.mjs

@@ -1,4 +1,6 @@
+export { BeginTransactionRequest } from "./BeginTransactionRequest.mjs";
 export { CreateBalanceLimitRequest } from "./CreateBalanceLimitRequest.mjs";
+export { CreateBalanceOrderRequest } from "./CreateBalanceOrderRequest.mjs";
 export { PostLoyaltyBalanceProgramsPidBalanceDefinitionsRequest } from "./PostLoyaltyBalanceProgramsPidBalanceDefinitionsRequest.mjs";
 export { UpdateBalanceDefinitionRequest } from "./UpdateBalanceDefinitionRequest.mjs";
 export { UpdateBalanceLimitRequest } from "./UpdateBalanceLimitRequest.mjs";

package/dist/esm/api/resources/balance/types/GetContactBalancesRequestSort.d.mts

@@ -0,0 +1,5 @@
+export declare const GetContactBalancesRequestSort: {
+    readonly Asc: "asc";
+    readonly Desc: "desc";
+};
+export type GetContactBalancesRequestSort = (typeof GetContactBalancesRequestSort)[keyof typeof GetContactBalancesRequestSort];

package/dist/esm/api/resources/balance/types/GetContactBalancesRequestSort.mjs

@@ -0,0 +1,5 @@
+// This file was auto-generated by Fern from our API Definition.
+export const GetContactBalancesRequestSort = {
+    Asc: "asc",
+    Desc: "desc",
+};

package/dist/esm/api/resources/balance/types/GetContactBalancesRequestSortField.d.mts

@@ -0,0 +1,5 @@
+export declare const GetContactBalancesRequestSortField: {
+    readonly UpdatedAt: "updatedAt";
+    readonly Value: "value";
+};
+export type GetContactBalancesRequestSortField = (typeof GetContactBalancesRequestSortField)[keyof typeof GetContactBalancesRequestSortField];

package/dist/esm/api/resources/balance/types/GetContactBalancesRequestSortField.mjs

@@ -0,0 +1,5 @@
+// This file was auto-generated by Fern from our API Definition.
+export const GetContactBalancesRequestSortField = {
+    UpdatedAt: "updatedAt",
+    Value: "value",
+};

package/dist/esm/api/resources/balance/types/GetLoyaltyBalanceProgramsPidActiveBalanceRequestSort.d.mts

@@ -0,0 +1,5 @@
+export declare const GetLoyaltyBalanceProgramsPidActiveBalanceRequestSort: {
+    readonly Asc: "asc";
+    readonly Desc: "desc";
+};
+export type GetLoyaltyBalanceProgramsPidActiveBalanceRequestSort = (typeof GetLoyaltyBalanceProgramsPidActiveBalanceRequestSort)[keyof typeof GetLoyaltyBalanceProgramsPidActiveBalanceRequestSort];

package/dist/esm/api/resources/balance/types/GetLoyaltyBalanceProgramsPidActiveBalanceRequestSort.mjs

@@ -0,0 +1,5 @@
+// This file was auto-generated by Fern from our API Definition.
+export const GetLoyaltyBalanceProgramsPidActiveBalanceRequestSort = {
+    Asc: "asc",
+    Desc: "desc",
+};

package/dist/esm/api/resources/balance/types/GetLoyaltyBalanceProgramsPidActiveBalanceResponse.d.mts

@@ -0,0 +1,30 @@
+/**
+ * Active balance response for a specific contact and balance definition.
+ */
+export interface GetLoyaltyBalanceProgramsPidActiveBalanceResponse {
+    /** Total number of active balances. */
+    count?: number | undefined;
+    /** Unique identifier of the loyalty program. */
+    loyaltyProgramId?: string | undefined;
+    /** Unique identifier of the contact. */
+    contactId?: number | undefined;
+    /** Unique identifier of the balance definition. */
+    balanceDefinitionId?: string | undefined;
+    /** List of active balances. */
+    activeBalances?: GetLoyaltyBalanceProgramsPidActiveBalanceResponse.ActiveBalances.Item[] | undefined;
+}
+export declare namespace GetLoyaltyBalanceProgramsPidActiveBalanceResponse {
+    type ActiveBalances = ActiveBalances.Item[];
+    namespace ActiveBalances {
+        interface Item {
+            /** Unique identifier of the balance entry. */
+            id?: string | undefined;
+            /** Current balance amount. */
+            amount?: number | undefined;
+            /** Timestamp when the balance was created. */
+            createdAt?: string | undefined;
+            /** Timestamp when the balance expires (if applicable). */
+            expiresAt?: string | undefined;
+        }
+    }
+}

package/dist/esm/api/resources/balance/types/GetLoyaltyBalanceProgramsPidTransactionHistoryResponse.d.mts

@@ -22,6 +22,8 @@ export declare namespace GetLoyaltyBalanceProgramsPidTransactionHistoryResponse
         interface Item {
             /** The transaction amount. */
             amount?: number | undefined;
+            /** The type of the transaction. */
+            transactionType?: Item.TransactionType | undefined;
             /** Expiration date of the balance associated with this transaction. */
             balanceExpirationDate?: string | undefined;
             /** Timestamp when the transaction was canceled, if applicable. */
@@ -41,5 +43,13 @@ export declare namespace GetLoyaltyBalanceProgramsPidTransactionHistoryResponse
             /** Current status of the transaction (e.g., pending, completed, rejected). */
             status?: string | undefined;
         }
+        namespace Item {
+            /** The type of the transaction. */
+            const TransactionType: {
+                readonly Credit: "credit";
+                readonly Debit: "debit";
+            };
+            type TransactionType = (typeof TransactionType)[keyof typeof TransactionType];
+        }
     }
 }

package/dist/esm/api/resources/balance/types/GetLoyaltyBalanceProgramsPidTransactionHistoryResponse.mjs

@@ -1,2 +1,15 @@
 // This file was auto-generated by Fern from our API Definition.
-export {};
+export var GetLoyaltyBalanceProgramsPidTransactionHistoryResponse;
+(function (GetLoyaltyBalanceProgramsPidTransactionHistoryResponse) {
+    let TransactionHistory;
+    (function (TransactionHistory) {
+        let Item;
+        (function (Item) {
+            /** The type of the transaction. */
+            Item.TransactionType = {
+                Credit: "credit",
+                Debit: "debit",
+            };
+        })(Item = TransactionHistory.Item || (TransactionHistory.Item = {}));
+    })(TransactionHistory = GetLoyaltyBalanceProgramsPidTransactionHistoryResponse.TransactionHistory || (GetLoyaltyBalanceProgramsPidTransactionHistoryResponse.TransactionHistory = {}));
+})(GetLoyaltyBalanceProgramsPidTransactionHistoryResponse || (GetLoyaltyBalanceProgramsPidTransactionHistoryResponse = {}));

package/dist/esm/api/resources/balance/types/GetSubscriptionBalancesResponse.d.mts

@@ -1,13 +1,18 @@
 export interface GetSubscriptionBalancesResponse {
+    /** Unique identifier of the loyalty program. */
+    loyaltyProgramId?: string | undefined;
+    /** Unique identifier of the contact. */
+    contactId?: number | undefined;
+    /** Aggregate balance per balance definition. */
     balance?: GetSubscriptionBalancesResponse.Balance.Item[] | undefined;
 }
 export declare namespace GetSubscriptionBalancesResponse {
     type Balance = Balance.Item[];
     namespace Balance {
         interface Item {
-            /** balance definition ID */
+            /** Balance definition ID. */
             balanceDefinitionId?: string | undefined;
-            /** Unique identifier for the balance definition associated with this aggregate balance */
+            /** Aggregate balance value for this definition. */
             value?: number | undefined;
         }
     }

package/dist/esm/api/resources/balance/types/PostLoyaltyBalanceProgramsPidSubscriptionsCidBalancesResponse.d.mts

@@ -1,20 +1,20 @@
 export interface PostLoyaltyBalanceProgramsPidSubscriptionsCidBalancesResponse {
-    /** The current amount available in the balance */
+    /** Unique identifier for the balance. */
+    id?: string | undefined;
+    /** The current amount available in the balance. */
     amount?: number | undefined;
-    /** balance definition ID */
-    balanceDefinitionId?: string | undefined;
-    /** Timestamp of when the balance was last consumed */
-    consumedAt?: string | undefined;
-    /** contact ID */
+    /** Loyalty program ID. */
+    loyaltyProgramId?: string | undefined;
+    /** Organization ID. */
+    organizationId?: number | undefined;
+    /** Contact ID. */
     contactId?: number | undefined;
-    /** Timestamp of when the balance was created */
+    /** Balance definition ID. */
+    balanceDefinitionId?: string | undefined;
+    /** Timestamp of when the balance was created. */
     createdAt?: string | undefined;
-    /** Expiration timestamp of the balance */
+    /** Expiration timestamp of the balance. */
     expiresAt?: string | undefined;
-    /** Unique identifier for the balance */
-    id?: string | undefined;
-    /** loyalty program ID */
-    loyaltyProgramId?: string | undefined;
-    /** organization ID */
-    organizationId?: number | undefined;
+    /** Timestamp of when the balance was last consumed. */
+    consumedAt?: string | undefined;
 }

package/dist/esm/api/resources/balance/types/index.d.mts

@@ -5,7 +5,11 @@ export * from "./GetBalanceDefinitionListRequestVersion.mjs";
 export * from "./GetBalanceDefinitionListResponse.mjs";
 export * from "./GetBalanceDefinitionRequestVersion.mjs";
 export * from "./GetBalanceLimitRequestVersion.mjs";
+export * from "./GetContactBalancesRequestSort.mjs";
+export * from "./GetContactBalancesRequestSortField.mjs";
 export * from "./GetContactBalancesResponse.mjs";
+export * from "./GetLoyaltyBalanceProgramsPidActiveBalanceRequestSort.mjs";
+export * from "./GetLoyaltyBalanceProgramsPidActiveBalanceResponse.mjs";
 export * from "./GetLoyaltyBalanceProgramsPidTransactionHistoryRequestSort.mjs";
 export * from "./GetLoyaltyBalanceProgramsPidTransactionHistoryRequestStatus.mjs";
 export * from "./GetLoyaltyBalanceProgramsPidTransactionHistoryRequestTransactionType.mjs";

package/dist/esm/api/resources/balance/types/index.mjs

@@ -5,7 +5,11 @@ export * from "./GetBalanceDefinitionListRequestVersion.mjs";
 export * from "./GetBalanceDefinitionListResponse.mjs";
 export * from "./GetBalanceDefinitionRequestVersion.mjs";
 export * from "./GetBalanceLimitRequestVersion.mjs";
+export * from "./GetContactBalancesRequestSort.mjs";
+export * from "./GetContactBalancesRequestSortField.mjs";
 export * from "./GetContactBalancesResponse.mjs";
+export * from "./GetLoyaltyBalanceProgramsPidActiveBalanceRequestSort.mjs";
+export * from "./GetLoyaltyBalanceProgramsPidActiveBalanceResponse.mjs";
 export * from "./GetLoyaltyBalanceProgramsPidTransactionHistoryRequestSort.mjs";
 export * from "./GetLoyaltyBalanceProgramsPidTransactionHistoryRequestStatus.mjs";
 export * from "./GetLoyaltyBalanceProgramsPidTransactionHistoryRequestTransactionType.mjs";

package/dist/esm/api/resources/companies/client/Client.d.mts

@@ -11,6 +11,8 @@ export declare class CompaniesClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<CompaniesClient.Options>;
     constructor(options: CompaniesClient.Options);
     /**
+     * Retrieve a paginated list of companies with optional filtering, sorting, and search capabilities. Results are sorted by creation date in descending order by default, and can be filtered by attributes, linked contacts, linked deals, or modification/creation timestamps.
+     *
      * @param {Brevo.GetCompaniesRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -22,6 +24,8 @@ export declare class CompaniesClient {
     getAllCompanies(request?: Brevo.GetCompaniesRequest, requestOptions?: CompaniesClient.RequestOptions): core.HttpResponsePromise<Brevo.GetCompaniesResponse>;
     private __getAllCompanies;
     /**
+     * Create a new CRM company with the specified name, attributes, and optional associations to contacts and deals. The company name is required, and you can optionally provide a country code when a phone number attribute is included.
+     *
      * @param {Brevo.PostCompaniesRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -49,6 +53,8 @@ export declare class CompaniesClient {
     importCompaniesCreationAndUpdation(request: Brevo.PostCompaniesImportRequest, requestOptions?: CompaniesClient.RequestOptions): core.HttpResponsePromise<Brevo.PostCompaniesImportResponse>;
     private __importCompaniesCreationAndUpdation;
     /**
+     * Link or unlink contacts and deals with a specific company in a single request. You can simultaneously link new contacts/deals and unlink existing ones by providing the respective ID arrays in the request body.
+     *
      * @param {Brevo.PatchCompaniesLinkUnlinkIdRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -62,6 +68,8 @@ export declare class CompaniesClient {
     linkAndUnlinkCompanyWithContactAndDeal(request: Brevo.PatchCompaniesLinkUnlinkIdRequest, requestOptions?: CompaniesClient.RequestOptions): core.HttpResponsePromise<void>;
     private __linkAndUnlinkCompanyWithContactAndDeal;
     /**
+     * Retrieve the full details of a single company by its identifier, including its attributes, linked contacts, and linked deals. Returns a 404 error if the company does not exist, or a 403 error if the user lacks permission to view the company.
+     *
      * @param {Brevo.GetCompaniesIdRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -76,6 +84,8 @@ export declare class CompaniesClient {
     getACompany(request: Brevo.GetCompaniesIdRequest, requestOptions?: CompaniesClient.RequestOptions): core.HttpResponsePromise<Brevo.Company>;
     private __getACompany;
     /**
+     * Permanently delete a company by its identifier. The requesting user must be the company owner or have manage permission on companies; otherwise, a 403 Forbidden error is returned.
+     *
      * @param {Brevo.DeleteCompaniesIdRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -90,6 +100,8 @@ export declare class CompaniesClient {
     deleteACompany(request: Brevo.DeleteCompaniesIdRequest, requestOptions?: CompaniesClient.RequestOptions): core.HttpResponsePromise<void>;
     private __deleteACompany;
     /**
+     * Update an existing company''s attributes, name, linked contacts, or linked deals. Note that passing `linkedContactsIds` or `linkedDealsIds` replaces the entire list of associations, so omitted IDs will be removed. The company name cannot be set to an empty string.
+     *
      * @param {Brevo.PatchCompaniesIdRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -104,6 +116,8 @@ export declare class CompaniesClient {
     updateACompany(request: Brevo.PatchCompaniesIdRequest, requestOptions?: CompaniesClient.RequestOptions): core.HttpResponsePromise<Brevo.Company>;
     private __updateACompany;
     /**
+     * Create a new custom attribute for companies or deals. The attribute label must be unique within the object type, cannot exceed 50 characters, and cannot use reserved names. For `single-select` or `multi-choice` attribute types, you must also provide the `optionsLabels` array.
+     *
      * @param {Brevo.PostCrmAttributesRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -119,6 +133,8 @@ export declare class CompaniesClient {
     createACompanyDealAttribute(request: Brevo.PostCrmAttributesRequest, requestOptions?: CompaniesClient.RequestOptions): core.HttpResponsePromise<Brevo.PostCrmAttributesResponse>;
     private __createACompanyDealAttribute;
     /**
+     * Delete an existing custom attribute by its identifier. This permanently removes the attribute definition and cleans up all references to it across companies or deals. System-default and non-editable attributes cannot be deleted.
+     *
      * @param {Brevo.DeleteCrmAttributesIdRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -133,6 +149,8 @@ export declare class CompaniesClient {
     deleteAnAttribute(request: Brevo.DeleteCrmAttributesIdRequest, requestOptions?: CompaniesClient.RequestOptions): core.HttpResponsePromise<void>;
     private __deleteAnAttribute;
     /**
+     * Update an existing custom attribute''s label or options. You can rename the attribute label or modify the available options for `single-select` and `multi-choice` attribute types. System-default attributes cannot be modified except for specific editable fields.
+     *
      * @param {Brevo.PatchCrmAttributesIdRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -147,8 +165,12 @@ export declare class CompaniesClient {
     updateAnAttribute(request: Brevo.PatchCrmAttributesIdRequest, requestOptions?: CompaniesClient.RequestOptions): core.HttpResponsePromise<void>;
     private __updateAnAttribute;
     /**
+     * Retrieve the list of all attributes defined for companies, including both system-default and custom attributes. Each attribute includes its label, internal name, type, required status, and available options for select-type attributes.
+     *
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link Brevo.BadRequestError}
+     *
      * @example
      *     await client.companies.getCompanyAttributes()
      */

package/dist/esm/api/resources/companies/client/Client.mjs

@@ -32,6 +32,8 @@ export class CompaniesClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
+     * Retrieve a paginated list of companies with optional filtering, sorting, and search capabilities. Results are sorted by creation date in descending order by default, and can be filtered by attributes, linked contacts, linked deals, or modification/creation timestamps.
+     *
      * @param {Brevo.GetCompaniesRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -46,9 +48,9 @@ export class CompaniesClient {
     __getAllCompanies() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { filters, linkedContactsIds, linkedDealsIds, modifiedSince, createdSince, page, limit, sort, sortBy } = request;
+            const { "filters[attributes.name]": filtersAttributesName, linkedContactsIds, linkedDealsIds, modifiedSince, createdSince, page, limit, sort, sortBy, } = request;
             const _queryParams = {
-                filters,
+                "filters[attributes.name]": filtersAttributesName,
                 linkedContactsIds,
                 linkedDealsIds,
                 modifiedSince,
@@ -64,7 +66,11 @@ export class CompaniesClient {
                 url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BrevoEnvironment.Default, "companies"),
                 method: "GET",
                 headers: _headers,
-                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                queryString: core.url
+                    .queryBuilder()
+                    .addMany(_queryParams)
+                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
+                    .build(),
                 timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
                 maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -90,6 +96,8 @@ export class CompaniesClient {
         });
     }
     /**
+     * Create a new CRM company with the specified name, attributes, and optional associations to contacts and deals. The company name is required, and you can optionally provide a country code when a phone number attribute is included.
+     *
      * @param {Brevo.PostCompaniesRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -113,7 +121,7 @@ export class CompaniesClient {
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
                 requestType: "json",
                 body: request,
                 timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
@@ -172,7 +180,7 @@ export class CompaniesClient {
                 url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BrevoEnvironment.Default, "companies/import"),
                 method: "POST",
                 headers: _headers,
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
                 requestType: "file",
                 duplex: _maybeEncodedRequest.duplex,
                 body: _maybeEncodedRequest.body,
@@ -201,6 +209,8 @@ export class CompaniesClient {
         });
     }
     /**
+     * Link or unlink contacts and deals with a specific company in a single request. You can simultaneously link new contacts/deals and unlink existing ones by providing the respective ID arrays in the request body.
+     *
      * @param {Brevo.PatchCompaniesLinkUnlinkIdRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -225,7 +235,7 @@ export class CompaniesClient {
                 method: "PATCH",
                 headers: _headers,
                 contentType: "application/json",
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
                 requestType: "json",
                 body: _body,
                 timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
@@ -253,6 +263,8 @@ export class CompaniesClient {
         });
     }
     /**
+     * Retrieve the full details of a single company by its identifier, including its attributes, linked contacts, and linked deals. Returns a 404 error if the company does not exist, or a 403 error if the user lacks permission to view the company.
+     *
      * @param {Brevo.GetCompaniesIdRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -277,7 +289,7 @@ export class CompaniesClient {
                 url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BrevoEnvironment.Default, `companies/${core.url.encodePathParam(id)}`),
                 method: "GET",
                 headers: _headers,
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
                 timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
                 maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -305,6 +317,8 @@ export class CompaniesClient {
         });
     }
     /**
+     * Permanently delete a company by its identifier. The requesting user must be the company owner or have manage permission on companies; otherwise, a 403 Forbidden error is returned.
+     *
      * @param {Brevo.DeleteCompaniesIdRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -329,7 +343,7 @@ export class CompaniesClient {
                 url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BrevoEnvironment.Default, `companies/${core.url.encodePathParam(id)}`),
                 method: "DELETE",
                 headers: _headers,
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
                 timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
                 maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -357,6 +371,8 @@ export class CompaniesClient {
         });
     }
     /**
+     * Update an existing company''s attributes, name, linked contacts, or linked deals. Note that passing `linkedContactsIds` or `linkedDealsIds` replaces the entire list of associations, so omitted IDs will be removed. The company name cannot be set to an empty string.
+     *
      * @param {Brevo.PatchCompaniesIdRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -382,7 +398,7 @@ export class CompaniesClient {
                 method: "PATCH",
                 headers: _headers,
                 contentType: "application/json",
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
                 requestType: "json",
                 body: _body,
                 timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
@@ -412,6 +428,8 @@ export class CompaniesClient {
         });
     }
     /**
+     * Create a new custom attribute for companies or deals. The attribute label must be unique within the object type, cannot exceed 50 characters, and cannot use reserved names. For `single-select` or `multi-choice` attribute types, you must also provide the `optionsLabels` array.
+     *
      * @param {Brevo.PostCrmAttributesRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -437,7 +455,7 @@ export class CompaniesClient {
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
                 requestType: "json",
                 body: request,
                 timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
@@ -465,6 +483,8 @@ export class CompaniesClient {
         });
     }
     /**
+     * Delete an existing custom attribute by its identifier. This permanently removes the attribute definition and cleans up all references to it across companies or deals. System-default and non-editable attributes cannot be deleted.
+     *
      * @param {Brevo.DeleteCrmAttributesIdRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -489,7 +509,7 @@ export class CompaniesClient {
                 url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BrevoEnvironment.Default, `crm/attributes/${core.url.encodePathParam(id)}`),
                 method: "DELETE",
                 headers: _headers,
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
                 timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
                 maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -517,6 +537,8 @@ export class CompaniesClient {
         });
     }
     /**
+     * Update an existing custom attribute''s label or options. You can rename the attribute label or modify the available options for `single-select` and `multi-choice` attribute types. System-default attributes cannot be modified except for specific editable fields.
+     *
      * @param {Brevo.PatchCrmAttributesIdRequest} request
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -542,7 +564,7 @@ export class CompaniesClient {
                 method: "PATCH",
                 headers: _headers,
                 contentType: "application/json",
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
                 requestType: "json",
                 body: _body,
                 timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
@@ -572,8 +594,12 @@ export class CompaniesClient {
         });
     }
     /**
+     * Retrieve the list of all attributes defined for companies, including both system-default and custom attributes. Each attribute includes its label, internal name, type, required status, and available options for select-type attributes.
+     *
      * @param {CompaniesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link Brevo.BadRequestError}
+     *
      * @example
      *     await client.companies.getCompanyAttributes()
      */
@@ -589,7 +615,7 @@ export class CompaniesClient {
                 url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BrevoEnvironment.Default, "crm/attributes/companies"),
                 method: "GET",
                 headers: _headers,
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
                 timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
                 maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -603,11 +629,16 @@ export class CompaniesClient {
                 };
             }
             if (_response.error.reason === "status-code") {
-                throw new errors.BrevoError({
-                    statusCode: _response.error.statusCode,
-                    body: _response.error.body,
-                    rawResponse: _response.rawResponse,
-                });
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Brevo.BadRequestError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BrevoError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
             }
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/crm/attributes/companies");
         });