POST /storage
Create a new storage item. If storage_number is omitted, one is generated from the configured number format.
storage_number
Request body: JSON. All fields are optional.
uuid
string
Custom UUID (otherwise generated)
Display number (auto-generated if omitted)
type
e.g. HDD, SSD, USB
make
Manufacturer
model_name
Model name
model_number
Model number
serial_number
Serial number
capacity
number
Capacity (numeric value)
capacity_unit
One of: KB, MB, GB, TB
KB
MB
GB
TB
notes
Free-text notes
location_id
Location ID
is_general_storage
boolean
General (unassigned) storage
encryption_key
Encryption key reference
custom_fields
array
Optional custom field values; see Custom fields.
Example
Response: 201 Created — body is the created storage object (same shape as in the list/get response).
Errors: 400 for invalid body (see errors in response); 500 for server errors.
errors
Last updated 4 months ago
POST /storage Content-Type: application/json { "type": "HDD", "make": "Vendor", "model_name": "Model X", "capacity": 1000, "capacity_unit": "GB", "location_id": 1 }