@getbrevo/brevo 5.0.4 → 6.0.1

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");
         });

package/dist/esm/api/resources/companies/client/requests/GetCompaniesRequest.d.mts

@@ -4,15 +4,15 @@ import type * as Brevo from "../../../../index.mjs";
  *     {}
  */
 export interface GetCompaniesRequest {
-    /** Filter by attrbutes. If you have filter for owner on your side please send it as {"attributes.owner":"6299dcf3874a14eacbc65c46"} */
-    filters?: string;
+    /** Filter by attributes. If you have a filter for the owner on your side please send it as filters[attributes.owner] and utilize the account email for the filtering. */
+    "filters[attributes.name]"?: string;
     /** Filter by linked contacts ids */
     linkedContactsIds?: number;
     /** Filter by linked Deals ids */
     linkedDealsIds?: string;
-    /** Filter (urlencoded) the contacts modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. */
+    /** Filter (urlencoded) the companies modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. */
     modifiedSince?: string;
-    /** Filter (urlencoded) the contacts created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. */
+    /** Filter (urlencoded) the companies created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. */
     createdSince?: string;
     /** Index of the first document of the page */
     page?: number;

package/dist/esm/api/resources/companies/client/requests/PatchCompaniesIdRequest.d.mts

@@ -12,7 +12,7 @@ export interface PatchCompaniesIdRequest {
     countryCode?: number;
     /** Warning - Using PATCH on linkedContactIds replaces the list of linked contacts. Omitted IDs will be removed. */
     linkedContactsIds?: number[];
-    /** Warning - Using PATCH on linkedDealsIds replaces the list of linked contacts. Omitted IDs will be removed. */
+    /** Warning - Using PATCH on linkedDealsIds replaces the list of linked deals. Omitted IDs will be removed. */
     linkedDealsIds?: string[];
     /** Name of company */
     name?: string;

package/dist/esm/api/resources/companies/client/requests/PostCompaniesImportRequest.d.mts

@@ -4,7 +4,7 @@ import type * as core from "../../../../../core/index.mjs";
  *     {}
  */
 export interface PostCompaniesImportRequest {
-    /** The CSV file to upload.The file should have the first row as the mapping attribute. Some default attribute names are (a) company_id [brevo mongoID to update deals] (b) associated_contact (c) associated_deal (f) any other attribute with internal name */
+    /** The CSV file to upload.The file should have the first row as the mapping attribute. Some default attribute names are (a) company_id [brevo mongoID to update companies] (b) associated_contact (c) associated_deal (f) any other attribute with internal name */
     file?: core.file.Uploadable | undefined;
     /**
      * The mapping options in JSON format. Here is an example of the JSON structure: ```json {

package/dist/esm/api/resources/companies/client/requests/PostCrmAttributesRequest.d.mts

@@ -13,7 +13,7 @@ export interface PostCrmAttributesRequest {
     description?: string;
     /** The label for the attribute (max 50 characters, cannot be empty) */
     label: string;
-    /** The type of object the attribute belongs to (prefilled with `companies`, mandatory) */
+    /** The type of object the attribute belongs to. Must be either `companies` or `deals`. */
     objectType: PostCrmAttributesRequest.ObjectType;
     /** Options for multi-choice or single-select attributes */
     optionsLabels?: string[];
@@ -30,7 +30,7 @@ export declare namespace PostCrmAttributesRequest {
         readonly MultiChoice: "multi-choice";
     };
     type AttributeType = (typeof AttributeType)[keyof typeof AttributeType];
-    /** The type of object the attribute belongs to (prefilled with `companies`, mandatory) */
+    /** The type of object the attribute belongs to. Must be either `companies` or `deals`. */
     const ObjectType: {
         readonly Companies: "companies";
         readonly Deals: "deals";

package/dist/esm/api/resources/companies/client/requests/PostCrmAttributesRequest.mjs

@@ -11,7 +11,7 @@ export var PostCrmAttributesRequest;
         Boolean: "boolean",
         MultiChoice: "multi-choice",
     };
-    /** The type of object the attribute belongs to (prefilled with `companies`, mandatory) */
+    /** The type of object the attribute belongs to. Must be either `companies` or `deals`. */
     PostCrmAttributesRequest.ObjectType = {
         Companies: "companies",
         Deals: "deals",

package/dist/esm/api/resources/companies/types/GetCrmAttributesCompaniesResponseItem.d.mts

@@ -1,10 +1,26 @@
 /**
- * List of attributes
+ * Company attribute details
  */
 export interface GetCrmAttributesCompaniesResponseItem {
-    attributeOptions?: Record<string, unknown>[] | undefined;
-    attributeTypeName?: string | undefined;
+    /** Internal name of the attribute */
     internalName?: string | undefined;
-    isRequired?: boolean | undefined;
+    /** Type of the attribute */
+    attributeTypeName?: string | undefined;
+    /** Display label of the attribute */
     label?: string | undefined;
+    /** Options for single-select or multi-choice attributes */
+    attributeOptions?: GetCrmAttributesCompaniesResponseItem.AttributeOptions.Item[] | undefined;
+    /** Whether this attribute is required */
+    isRequired?: boolean | undefined;
+    /** Whether this attribute value is read-only */
+    isValueReadonly?: boolean | undefined;
+}
+export declare namespace GetCrmAttributesCompaniesResponseItem {
+    type AttributeOptions = AttributeOptions.Item[];
+    namespace AttributeOptions {
+        interface Item {
+            key?: string | undefined;
+            value?: string | undefined;
+        }
+    }
 }