@augno/sdk 0.1.9 → 0.7.1

package/resources/operations/locations.d.mts

@@ -1,5 +1,5 @@
 import { APIResource } from "../../core/resource.mjs";
-import * as CustomersAPI from "../sales/customers/customers.mjs";
+import * as BlocksAPI from "../messaging/blocks.mjs";
 import { APIPromise } from "../../core/api-promise.mjs";
 import { RequestOptions } from "../../internal/request-options.mjs";
 /**
@@ -7,20 +7,22 @@ import { RequestOptions } from "../../internal/request-options.mjs";
  */
 export declare class Locations extends APIResource {
     /**
-     * Creates a location for the caller's account.
+     * Returns a paginated list of locations in your account.
+     *
+     * This endpoint requires the permission: `locations:read`.
      *
      * @example
      * ```ts
-     * const location = await client.operations.locations.create({
-     *   name: 'Warehouse A',
-     *   type: 'building',
-     * });
+     * const listLocation =
+     *   await client.operations.locations.list();
      * ```
      */
-    create(params: LocationCreateParams, options?: RequestOptions): APIPromise<CustomersAPI.Location>;
+    list(query?: LocationListParams | null | undefined, options?: RequestOptions): APIPromise<BlocksAPI.ListLocation>;
     /**
      * Returns a location by ID.
      *
+     * This endpoint requires the permission: `locations:read`.
+     *
      * @example
      * ```ts
      * const location = await client.operations.locations.retrieve(
@@ -28,30 +30,42 @@ export declare class Locations extends APIResource {
      * );
      * ```
      */
-    retrieve(id: string, query?: LocationRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<CustomersAPI.Location>;
+    retrieve(id: string, query?: LocationRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<BlocksAPI.Location>;
     /**
-     * Partially updates a location.
+     * Creates a storage location, optionally placing it in the location hierarchy.
+     *
+     * This endpoint requires the permission: `locations:create`.
      *
      * @example
      * ```ts
-     * const location = await client.operations.locations.update(
-     *   'lc_014d187d99b31926f0c74af9d8',
-     * );
+     * const location = await client.operations.locations.create({
+     *   name: 'Warehouse A',
+     *   type: 'building',
+     * });
      * ```
      */
-    update(id: string, params?: LocationUpdateParams | null | undefined, options?: RequestOptions): APIPromise<CustomersAPI.Location>;
+    create(params: LocationCreateParams, options?: RequestOptions): APIPromise<BlocksAPI.Location>;
     /**
-     * Returns a paginated list of locations for the caller's account.
+     * Partially updates a location.
+     *
+     * This endpoint requires the permission: `locations:update`.
      *
      * @example
      * ```ts
-     * const listLocation =
-     *   await client.operations.locations.list();
+     * const location = await client.operations.locations.update(
+     *   'lc_014d187d99b31926f0c74af9d8',
+     *   { name: 'Warehouse B' },
+     * );
      * ```
      */
-    list(query?: LocationListParams | null | undefined, options?: RequestOptions): APIPromise<CustomersAPI.ListLocation>;
+    update(id: string, params?: LocationUpdateParams | null | undefined, options?: RequestOptions): APIPromise<BlocksAPI.Location>;
     /**
-     * Deletes a location. Fails if the location has child locations.
+     * Deletes a location.
+     *
+     * Fails if the location has child locations; remove or reassign the children
+     * first.
+     *
+     * This endpoint requires the permission: `locations:delete`.
      *
      * @example
      * ```ts
@@ -67,19 +81,32 @@ export declare class Locations extends APIResource {
  */
 export interface CreateLocationRequest {
     /**
-     * Display name.
+     * Display name of the location.
+     *
+     * Maximum 255 characters.
      */
     name: string;
     /**
-     * Location type code.
+     * Location type code, identifying this location's level in the storage hierarchy.
+     *
+     * - `building`: a building-level location.
+     * - `section`: a section within a building.
+     * - `aisle`: an aisle within a section.
+     * - `rack`: a rack within an aisle.
+     * - `shelf`: a shelf within a rack.
+     * - `bin`: a bin within a shelf.
      */
-    type: 'building' | 'section' | 'aisle' | 'rack' | 'shelf' | 'bin';
+    type: BlocksAPI.LocationTypeCode;
     /**
-     * IDs of child locations to attach.
+     * IDs of existing locations to attach as children of the new location.
+     *
+     * Listed locations are moved from their current parent, if any.
      */
     child_ids?: Array<string>;
     /**
-     * Parent location ID. Null for top-level locations.
+     * ID of the parent location.
+     *
+     * Omit for top-level locations.
      */
     parent_id?: string;
 }
@@ -88,47 +115,63 @@ export interface CreateLocationRequest {
  */
 export interface UpdateLocationRequest {
     /**
-     * Child location IDs. Replaces all current children when provided. Send null to
-     * clear.
+     * IDs of locations to set as this location's children.
+     *
+     * When provided, replaces the full set of children: current children not listed
+     * are detached, and listed locations are moved from their current parent. Send
+     * `null` to detach all children.
      */
     child_ids?: Array<string> | null;
     /**
-     * Display name.
+     * Display name of the location.
+     *
+     * Maximum 255 characters.
      */
     name?: string;
     /**
-     * Parent location ID. Send null to clear.
+     * ID of the parent location.
+     *
+     * Send `null` to clear the parent and make this a top-level location.
      */
     parent_id?: string | null;
     /**
-     * Location type code.
+     * Location type code, identifying this location's level in the storage hierarchy.
+     *
+     * - `building`: a building-level location.
+     * - `section`: a section within a building.
+     * - `aisle`: an aisle within a section.
+     * - `rack`: a rack within an aisle.
+     * - `shelf`: a shelf within a rack.
+     * - `bin`: a bin within a shelf.
      */
-    type?: 'building' | 'section' | 'aisle' | 'rack' | 'shelf' | 'bin';
+    type?: BlocksAPI.LocationTypeCode;
 }
 export interface LocationDeleteResponse {
 }
-export interface LocationCreateParams {
-    /**
-     * Body param: Display name.
-     */
-    name: string;
+export interface LocationListParams {
     /**
-     * Body param: Location type code.
+     * Opaque cursor token identifying where the page of results starts.
+     *
+     * Use the `cursor` value embedded in a previous response's `next_page_url` or
+     * `previous_page_url` to fetch the adjacent page. Omit to start from the first
+     * page.
      */
-    type: 'building' | 'section' | 'aisle' | 'rack' | 'shelf' | 'bin';
+    cursor?: string;
     /**
-     * Query param: Sub-objects to expand in the response. When omitted, sub-objects
-     * are returned as `null`.
+     * Sub-objects to expand in the response. When omitted, sub-objects are returned as
+     * `null`.
      */
     include?: Array<'parent' | 'children'>;
     /**
-     * Body param: IDs of child locations to attach.
+     * Maximum number of results to return in a single page.
      */
-    child_ids?: Array<string>;
+    limit?: number;
     /**
-     * Body param: Parent location ID. Null for top-level locations.
+     * Free-text search term used to filter results.
+     *
+     * Which fields are matched against the term varies by endpoint.
      */
-    parent_id?: string;
+    q?: string;
 }
 export interface LocationRetrieveParams {
     /**
@@ -137,50 +180,83 @@ export interface LocationRetrieveParams {
      */
     include?: Array<'parent' | 'children'>;
 }
-export interface LocationUpdateParams {
+export interface LocationCreateParams {
     /**
-     * Query param: Sub-objects to expand in the response. When omitted, sub-objects
-     * are returned as `null`.
+     * Body param: Display name of the location.
+     *
+     * Maximum 255 characters.
      */
-    include?: Array<'parent' | 'children'>;
+    name: string;
     /**
-     * Body param: Child location IDs. Replaces all current children when provided.
-     * Send null to clear.
+     * Body param: Location type code, identifying this location's level in the storage
+     * hierarchy.
+     *
+     * - `building`: a building-level location.
+     * - `section`: a section within a building.
+     * - `aisle`: an aisle within a section.
+     * - `rack`: a rack within an aisle.
+     * - `shelf`: a shelf within a rack.
+     * - `bin`: a bin within a shelf.
      */
-    child_ids?: Array<string> | null;
+    type: BlocksAPI.LocationTypeCode;
     /**
-     * Body param: Display name.
+     * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+     * are returned as `null`.
      */
-    name?: string;
+    include?: Array<'parent' | 'children'>;
     /**
-     * Body param: Parent location ID. Send null to clear.
+     * Body param: IDs of existing locations to attach as children of the new location.
+     *
+     * Listed locations are moved from their current parent, if any.
      */
-    parent_id?: string | null;
+    child_ids?: Array<string>;
     /**
-     * Body param: Location type code.
+     * Body param: ID of the parent location.
+     *
+     * Omit for top-level locations.
      */
-    type?: 'building' | 'section' | 'aisle' | 'rack' | 'shelf' | 'bin';
+    parent_id?: string;
 }
-export interface LocationListParams {
+export interface LocationUpdateParams {
     /**
-     * Cursor token used to retrieve the next or previous page of results.
+     * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+     * are returned as `null`.
      */
-    cursor?: string;
+    include?: Array<'parent' | 'children'>;
     /**
-     * Sub-objects to expand in the response. When omitted, sub-objects are returned as
-     * `null`.
+     * Body param: IDs of locations to set as this location's children.
+     *
+     * When provided, replaces the full set of children: current children not listed
+     * are detached, and listed locations are moved from their current parent. Send
+     * `null` to detach all children.
      */
-    include?: Array<'parent' | 'children'>;
+    child_ids?: Array<string> | null;
     /**
-     * Maximum number of results per page (default: 100, max: 1000).
+     * Body param: Display name of the location.
+     *
+     * Maximum 255 characters.
      */
-    limit?: number;
+    name?: string;
     /**
-     * Search query used to filter results.
+     * Body param: ID of the parent location.
+     *
+     * Send `null` to clear the parent and make this a top-level location.
      */
-    q?: string;
+    parent_id?: string | null;
+    /**
+     * Body param: Location type code, identifying this location's level in the storage
+     * hierarchy.
+     *
+     * - `building`: a building-level location.
+     * - `section`: a section within a building.
+     * - `aisle`: an aisle within a section.
+     * - `rack`: a rack within an aisle.
+     * - `shelf`: a shelf within a rack.
+     * - `bin`: a bin within a shelf.
+     */
+    type?: BlocksAPI.LocationTypeCode;
 }
 export declare namespace Locations {
-    export { type CreateLocationRequest as CreateLocationRequest, type UpdateLocationRequest as UpdateLocationRequest, type LocationDeleteResponse as LocationDeleteResponse, type LocationCreateParams as LocationCreateParams, type LocationRetrieveParams as LocationRetrieveParams, type LocationUpdateParams as LocationUpdateParams, type LocationListParams as LocationListParams, };
+    export { type CreateLocationRequest as CreateLocationRequest, type UpdateLocationRequest as UpdateLocationRequest, type LocationDeleteResponse as LocationDeleteResponse, type LocationListParams as LocationListParams, type LocationRetrieveParams as LocationRetrieveParams, type LocationCreateParams as LocationCreateParams, type LocationUpdateParams as LocationUpdateParams, };
 }
 //# sourceMappingURL=locations.d.mts.map

package/resources/operations/locations.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"locations.d.mts","sourceRoot":"","sources":["../../src/resources/operations/locations.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"locations.d.mts","sourceRoot":"","sources":["../../src/resources/operations/locations.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,SAAS;OACd,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB;;GAEG;AACH,qBAAa,SAAU,SAAQ,WAAW;IACxC;;;;;;;;;;OAUG;IACH,IAAI,CACF,KAAK,GAAE,kBAAkB,GAAG,IAAI,GAAG,SAAc,EACjD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,SAAS,CAAC,YAAY,CAAC;IAIrC;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,KAAK,GAAE,sBAAsB,GAAG,IAAI,GAAG,SAAc,EACrD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC;IAIjC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,MAAM,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC;IAK9F;;;;;;;;;;;;OAYG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,oBAAoB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC;IAKjC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,sBAAsB,CAAC;CAGjF;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;;;;OASG;IACH,IAAI,EAAE,SAAS,CAAC,gBAAgB,CAAC;IAEjC;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAEjC;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC,gBAAgB,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;CAAG;AAE1C,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC,CAAC;IAEvC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;;;;;OAUG;IACH,IAAI,EAAE,SAAS,CAAC,gBAAgB,CAAC;IAEjC;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC,CAAC;IAEvC;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC,CAAC;IAEvC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAEjC;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC,gBAAgB,CAAC;CACnC;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}

package/resources/operations/locations.d.ts

@@ -1,5 +1,5 @@
 import { APIResource } from "../../core/resource.js";
-import * as CustomersAPI from "../sales/customers/customers.js";
+import * as BlocksAPI from "../messaging/blocks.js";
 import { APIPromise } from "../../core/api-promise.js";
 import { RequestOptions } from "../../internal/request-options.js";
 /**
@@ -7,20 +7,22 @@ import { RequestOptions } from "../../internal/request-options.js";
  */
 export declare class Locations extends APIResource {
     /**
-     * Creates a location for the caller's account.
+     * Returns a paginated list of locations in your account.
+     *
+     * This endpoint requires the permission: `locations:read`.
      *
      * @example
      * ```ts
-     * const location = await client.operations.locations.create({
-     *   name: 'Warehouse A',
-     *   type: 'building',
-     * });
+     * const listLocation =
+     *   await client.operations.locations.list();
      * ```
      */
-    create(params: LocationCreateParams, options?: RequestOptions): APIPromise<CustomersAPI.Location>;
+    list(query?: LocationListParams | null | undefined, options?: RequestOptions): APIPromise<BlocksAPI.ListLocation>;
     /**
      * Returns a location by ID.
      *
+     * This endpoint requires the permission: `locations:read`.
+     *
      * @example
      * ```ts
      * const location = await client.operations.locations.retrieve(
@@ -28,30 +30,42 @@ export declare class Locations extends APIResource {
      * );
      * ```
      */
-    retrieve(id: string, query?: LocationRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<CustomersAPI.Location>;
+    retrieve(id: string, query?: LocationRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<BlocksAPI.Location>;
     /**
-     * Partially updates a location.
+     * Creates a storage location, optionally placing it in the location hierarchy.
+     *
+     * This endpoint requires the permission: `locations:create`.
      *
      * @example
      * ```ts
-     * const location = await client.operations.locations.update(
-     *   'lc_014d187d99b31926f0c74af9d8',
-     * );
+     * const location = await client.operations.locations.create({
+     *   name: 'Warehouse A',
+     *   type: 'building',
+     * });
      * ```
      */
-    update(id: string, params?: LocationUpdateParams | null | undefined, options?: RequestOptions): APIPromise<CustomersAPI.Location>;
+    create(params: LocationCreateParams, options?: RequestOptions): APIPromise<BlocksAPI.Location>;
     /**
-     * Returns a paginated list of locations for the caller's account.
+     * Partially updates a location.
+     *
+     * This endpoint requires the permission: `locations:update`.
      *
      * @example
      * ```ts
-     * const listLocation =
-     *   await client.operations.locations.list();
+     * const location = await client.operations.locations.update(
+     *   'lc_014d187d99b31926f0c74af9d8',
+     *   { name: 'Warehouse B' },
+     * );
      * ```
      */
-    list(query?: LocationListParams | null | undefined, options?: RequestOptions): APIPromise<CustomersAPI.ListLocation>;
+    update(id: string, params?: LocationUpdateParams | null | undefined, options?: RequestOptions): APIPromise<BlocksAPI.Location>;
     /**
-     * Deletes a location. Fails if the location has child locations.
+     * Deletes a location.
+     *
+     * Fails if the location has child locations; remove or reassign the children
+     * first.
+     *
+     * This endpoint requires the permission: `locations:delete`.
      *
      * @example
      * ```ts
@@ -67,19 +81,32 @@ export declare class Locations extends APIResource {
  */
 export interface CreateLocationRequest {
     /**
-     * Display name.
+     * Display name of the location.
+     *
+     * Maximum 255 characters.
      */
     name: string;
     /**
-     * Location type code.
+     * Location type code, identifying this location's level in the storage hierarchy.
+     *
+     * - `building`: a building-level location.
+     * - `section`: a section within a building.
+     * - `aisle`: an aisle within a section.
+     * - `rack`: a rack within an aisle.
+     * - `shelf`: a shelf within a rack.
+     * - `bin`: a bin within a shelf.
      */
-    type: 'building' | 'section' | 'aisle' | 'rack' | 'shelf' | 'bin';
+    type: BlocksAPI.LocationTypeCode;
     /**
-     * IDs of child locations to attach.
+     * IDs of existing locations to attach as children of the new location.
+     *
+     * Listed locations are moved from their current parent, if any.
      */
     child_ids?: Array<string>;
     /**
-     * Parent location ID. Null for top-level locations.
+     * ID of the parent location.
+     *
+     * Omit for top-level locations.
      */
     parent_id?: string;
 }
@@ -88,47 +115,63 @@ export interface CreateLocationRequest {
  */
 export interface UpdateLocationRequest {
     /**
-     * Child location IDs. Replaces all current children when provided. Send null to
-     * clear.
+     * IDs of locations to set as this location's children.
+     *
+     * When provided, replaces the full set of children: current children not listed
+     * are detached, and listed locations are moved from their current parent. Send
+     * `null` to detach all children.
      */
     child_ids?: Array<string> | null;
     /**
-     * Display name.
+     * Display name of the location.
+     *
+     * Maximum 255 characters.
      */
     name?: string;
     /**
-     * Parent location ID. Send null to clear.
+     * ID of the parent location.
+     *
+     * Send `null` to clear the parent and make this a top-level location.
      */
     parent_id?: string | null;
     /**
-     * Location type code.
+     * Location type code, identifying this location's level in the storage hierarchy.
+     *
+     * - `building`: a building-level location.
+     * - `section`: a section within a building.
+     * - `aisle`: an aisle within a section.
+     * - `rack`: a rack within an aisle.
+     * - `shelf`: a shelf within a rack.
+     * - `bin`: a bin within a shelf.
      */
-    type?: 'building' | 'section' | 'aisle' | 'rack' | 'shelf' | 'bin';
+    type?: BlocksAPI.LocationTypeCode;
 }
 export interface LocationDeleteResponse {
 }
-export interface LocationCreateParams {
-    /**
-     * Body param: Display name.
-     */
-    name: string;
+export interface LocationListParams {
     /**
-     * Body param: Location type code.
+     * Opaque cursor token identifying where the page of results starts.
+     *
+     * Use the `cursor` value embedded in a previous response's `next_page_url` or
+     * `previous_page_url` to fetch the adjacent page. Omit to start from the first
+     * page.
      */
-    type: 'building' | 'section' | 'aisle' | 'rack' | 'shelf' | 'bin';
+    cursor?: string;
     /**
-     * Query param: Sub-objects to expand in the response. When omitted, sub-objects
-     * are returned as `null`.
+     * Sub-objects to expand in the response. When omitted, sub-objects are returned as
+     * `null`.
      */
     include?: Array<'parent' | 'children'>;
     /**
-     * Body param: IDs of child locations to attach.
+     * Maximum number of results to return in a single page.
      */
-    child_ids?: Array<string>;
+    limit?: number;
     /**
-     * Body param: Parent location ID. Null for top-level locations.
+     * Free-text search term used to filter results.
+     *
+     * Which fields are matched against the term varies by endpoint.
      */
-    parent_id?: string;
+    q?: string;
 }
 export interface LocationRetrieveParams {
     /**
@@ -137,50 +180,83 @@ export interface LocationRetrieveParams {
      */
     include?: Array<'parent' | 'children'>;
 }
-export interface LocationUpdateParams {
+export interface LocationCreateParams {
     /**
-     * Query param: Sub-objects to expand in the response. When omitted, sub-objects
-     * are returned as `null`.
+     * Body param: Display name of the location.
+     *
+     * Maximum 255 characters.
      */
-    include?: Array<'parent' | 'children'>;
+    name: string;
     /**
-     * Body param: Child location IDs. Replaces all current children when provided.
-     * Send null to clear.
+     * Body param: Location type code, identifying this location's level in the storage
+     * hierarchy.
+     *
+     * - `building`: a building-level location.
+     * - `section`: a section within a building.
+     * - `aisle`: an aisle within a section.
+     * - `rack`: a rack within an aisle.
+     * - `shelf`: a shelf within a rack.
+     * - `bin`: a bin within a shelf.
      */
-    child_ids?: Array<string> | null;
+    type: BlocksAPI.LocationTypeCode;
     /**
-     * Body param: Display name.
+     * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+     * are returned as `null`.
      */
-    name?: string;
+    include?: Array<'parent' | 'children'>;
     /**
-     * Body param: Parent location ID. Send null to clear.
+     * Body param: IDs of existing locations to attach as children of the new location.
+     *
+     * Listed locations are moved from their current parent, if any.
      */
-    parent_id?: string | null;
+    child_ids?: Array<string>;
     /**
-     * Body param: Location type code.
+     * Body param: ID of the parent location.
+     *
+     * Omit for top-level locations.
      */
-    type?: 'building' | 'section' | 'aisle' | 'rack' | 'shelf' | 'bin';
+    parent_id?: string;
 }
-export interface LocationListParams {
+export interface LocationUpdateParams {
     /**
-     * Cursor token used to retrieve the next or previous page of results.
+     * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+     * are returned as `null`.
      */
-    cursor?: string;
+    include?: Array<'parent' | 'children'>;
     /**
-     * Sub-objects to expand in the response. When omitted, sub-objects are returned as
-     * `null`.
+     * Body param: IDs of locations to set as this location's children.
+     *
+     * When provided, replaces the full set of children: current children not listed
+     * are detached, and listed locations are moved from their current parent. Send
+     * `null` to detach all children.
      */
-    include?: Array<'parent' | 'children'>;
+    child_ids?: Array<string> | null;
     /**
-     * Maximum number of results per page (default: 100, max: 1000).
+     * Body param: Display name of the location.
+     *
+     * Maximum 255 characters.
      */
-    limit?: number;
+    name?: string;
     /**
-     * Search query used to filter results.
+     * Body param: ID of the parent location.
+     *
+     * Send `null` to clear the parent and make this a top-level location.
      */
-    q?: string;
+    parent_id?: string | null;
+    /**
+     * Body param: Location type code, identifying this location's level in the storage
+     * hierarchy.
+     *
+     * - `building`: a building-level location.
+     * - `section`: a section within a building.
+     * - `aisle`: an aisle within a section.
+     * - `rack`: a rack within an aisle.
+     * - `shelf`: a shelf within a rack.
+     * - `bin`: a bin within a shelf.
+     */
+    type?: BlocksAPI.LocationTypeCode;
 }
 export declare namespace Locations {
-    export { type CreateLocationRequest as CreateLocationRequest, type UpdateLocationRequest as UpdateLocationRequest, type LocationDeleteResponse as LocationDeleteResponse, type LocationCreateParams as LocationCreateParams, type LocationRetrieveParams as LocationRetrieveParams, type LocationUpdateParams as LocationUpdateParams, type LocationListParams as LocationListParams, };
+    export { type CreateLocationRequest as CreateLocationRequest, type UpdateLocationRequest as UpdateLocationRequest, type LocationDeleteResponse as LocationDeleteResponse, type LocationListParams as LocationListParams, type LocationRetrieveParams as LocationRetrieveParams, type LocationCreateParams as LocationCreateParams, type LocationUpdateParams as LocationUpdateParams, };
 }
 //# sourceMappingURL=locations.d.ts.map