---
title: "Post Storage Unit"
method: POST
path: "/storage_units"
---

# Post Storage Unit

`POST /storage_units`

Creates a storage unit in the Isometric system.

## Headers

- `x-client-secret` string, required — A secret token identifying the client connecting to the API

## Request body

- CreateStorageUnitRequest
  - `storage_location_id` string, required
  - `name` string, required — The name of the storage unit. Must be at most 100 characters long.
  - `latitude` number, required — A WGS84 latitude in decimal degrees, between -90 and 90.
  - `longitude` number, required — A WGS84 longitude in decimal degrees, between -180 and 180.
  - `description` union
    - string
    - Undefined — An explicit representation of an undefined value in the Isometric REST API. Used, for example, to distinguish between explicit null inputs that clear a property, and not provided inputs which leave the property as is.
      - `__typename` 'Undefined' — Contains the name of the model (formally, OpenAPI Schema Object). Used to determine the type of data, for example when two different types are unioned.
  - `supplier_reference_id` union
    - string — A string that must be unique for all resources created by a specific supplier. It can be used by a client to identify the correct objects in their system.
    - Undefined — An explicit representation of an undefined value in the Isometric REST API. Used, for example, to distinguish between explicit null inputs that clear a property, and not provided inputs which leave the property as is.
      - `__typename` 'Undefined' — Contains the name of the model (formally, OpenAPI Schema Object). Used to determine the type of data, for example when two different types are unioned.

## Response `200`

Successful Response

- StorageUnit
  - `id` string, required
  - `name` string, required — The name of the storage unit
  - `description` string, nullable — Optional description of the storage unit
  - `latitude` number, nullable — A WGS84 latitude in decimal degrees, between -90 and 90.
  - `longitude` number, nullable — A WGS84 longitude in decimal degrees, between -180 and 180.
  - `supplier_reference_id` string, nullable — A string that must be unique for all resources created by a specific supplier. It can be used by a client to identify the correct objects in their system.
  - `storage_location_id` string, required — The ID of the storage location this storage unit belongs to
  - `supplier_id` string, required — The ID of the supplier this storage location belongs to

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/isometric/apis/isometric-certify-data-ingestion-api.md) · [All operations](https://skmtc.net/isometric/apis/isometric-certify-data-ingestion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/isometric/isometric-certify-data-ingestion-api/versions/9819e9c8ccf0/schema)