Create Location

Beta

POST/v1/operations/locations

Idempotent with Idempotency-Key header. Learn more

Creates a location for the caller's account.

include[]optional arrayenumValues:parentchildren

Sub-objects to expand in the response. When omitted, sub-objects are returned as null.

namestring

Display name.

typestringenumValues:buildingsectionaisle

Location type code.

parent_idoptional stringnullable

Parent location ID. Null for top-level locations.

child_idsoptional array of stringnullable

IDs of child locations to attach.

idstring

Location ID.

objectstringenumValues:location

Resource type identifier.

namestring

Display name.

typestringenumValues:buildingsectionaisle

Location type code.

parentobjectExpandablenullable

Parent location. Null for top-level locations. Expandable.

idstring

Location ID.

objectstringenumValues:location

Resource type identifier.

namestring

Display name.

typestringenumValues:buildingsectionaisle

Location type code.

parentobjectExpandablenullable

Parent location. Null for top-level locations. Expandable.

Always returned as null in this endpoint.

childrenobjectExpandablenullable

Child locations. Expandable.

Always returned as null in this endpoint.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last-updated timestamp.

childrenobjectExpandablenullable

Child locations. Expandable.

objectstringenumValues:list

Resource type identifier.

page_infoobject

Pagination metadata.

next_page_urlstringnullable

URL to fetch the next page, null if no more pages.

previous_page_urlstringnullable

URL to fetch the previous page, null if on the first page.

has_next_pageboolean

Whether more results exist after this page.

has_prev_pageboolean

Whether results exist before this page.

dataarray of object

Resources in this page.

idstring

Location ID.

objectstringenumValues:location

Resource type identifier.

namestring

Display name.

typestringenumValues:buildingsectionaisle

Location type code.

parentobjectnullable

Parent location. Null for top-level locations. Expandable.

Always returned as null in this endpoint.

childrenobjectnullable

Child locations. Expandable.

Always returned as null in this endpoint.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last-updated timestamp.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last-updated timestamp.

Responses

201

Successful response for Create Location

Create Location

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const location = await client.operations.locations.create({
  name: 'Warehouse A',
  type: 'building',
});

console.log(location.id);

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const location = await client.operations.locations.create({
  name: 'Warehouse A',
  type: 'building',
});

console.log(location.id);

201 example

{
  "id": "lc_014d187d99b31926f0c74af9d8",
  "object": "location",
  "name": "Warehouse A",
  "type": "building",
  "children": {
    "object": "list",
    "page_info": {
      "has_next_page": false,
      "has_prev_page": false
    },
    "data": [
      {
        "id": "lc_0132c4db1e220da9bc596cc4c9",
        "object": "location",
        "name": "Shelf A1",
        "type": "building"
      }
    ]
  },
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

{
  "id": "lc_014d187d99b31926f0c74af9d8",
  "object": "location",
  "name": "Warehouse A",
  "type": "building",
  "children": {
    "object": "list",
    "page_info": {
      "has_next_page": false,
      "has_prev_page": false
    },
    "data": [
      {
        "id": "lc_0132c4db1e220da9bc596cc4c9",
        "object": "location",
        "name": "Shelf A1",
        "type": "building"
      }
    ]
  },
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

Create Location

Query Parameters

Request Body

Returns

Responses