---
title: "POST /v1/storages"
method: POST
path: "/v1/storages"
tags: ["Storages"]
---

# POST /v1/storages

`POST /v1/storages`

Register a storage device for management.

## Request body

- union
  - object
    - `host` string, required
    - `port` string, required
    - `username` string, required
    - `password` string, required
    - `name` string
    - `description` string
    - `vendor` string, required
    - `model` string, required
    - `rest` RestAccessInfoRegistry
      - `host` string, required
      - `port` string, required
      - `username` string, required
      - `password` string, required
    - `ssh` SSHAccessInfoRegistry
      - `host` string, required
      - `port` string, required
      - `username` string, required
      - `password` string, required
      - `pub_key` string, required
      - `pub_key_type` 'ed25519' | 'ecdsa' | 'rsa', required
    - `cli` CLIAccessInfoRegistry
      - `host` string, required
      - `port` string
      - `username` string, required
      - `password` string, required
    - `smis` SMISAccessInfoRegistry
      - `host` string, required
      - `port` string
      - `username` string, required
      - `password` string, required
      - `namespace` string
    - `extra_attributes` object
  - object
    - `host` string, required
    - `port` string, required
    - `username` string, required
    - `password` string, required
    - `pub_key` string, required
    - `pub_key_type` 'ed25519' | 'ecdsa' | 'rsa', required
    - `name` string
    - `description` string
    - `vendor` string, required
    - `model` string, required
    - `rest` RestAccessInfoRegistry
      - `host` string, required
      - `port` string, required
      - `username` string, required
      - `password` string, required
    - `ssh` SSHAccessInfoRegistry
      - `host` string, required
      - `port` string, required
      - `username` string, required
      - `password` string, required
      - `pub_key` string, required
      - `pub_key_type` 'ed25519' | 'ecdsa' | 'rsa', required
    - `cli` CLIAccessInfoRegistry
      - `host` string, required
      - `port` string
      - `username` string, required
      - `password` string, required
    - `smis` SMISAccessInfoRegistry
      - `host` string, required
      - `port` string
      - `username` string, required
      - `password` string, required
      - `namespace` string
    - `extra_attributes` object
  - object
    - `host` string, required
    - `port` string
    - `username` string, required
    - `password` string, required
    - `name` string
    - `description` string
    - `vendor` string, required
    - `model` string, required
    - `rest` RestAccessInfoRegistry
      - `host` string, required
      - `port` string, required
      - `username` string, required
      - `password` string, required
    - `ssh` SSHAccessInfoRegistry
      - `host` string, required
      - `port` string, required
      - `username` string, required
      - `password` string, required
      - `pub_key` string, required
      - `pub_key_type` 'ed25519' | 'ecdsa' | 'rsa', required
    - `cli` CLIAccessInfoRegistry
      - `host` string, required
      - `port` string
      - `username` string, required
      - `password` string, required
    - `smis` SMISAccessInfoRegistry
      - `host` string, required
      - `port` string
      - `username` string, required
      - `password` string, required
      - `namespace` string
    - `extra_attributes` object
  - object
    - `host` string, required
    - `port` string
    - `username` string, required
    - `password` string, required
    - `namespace` string
    - `name` string
    - `description` string
    - `vendor` string, required
    - `model` string, required
    - `rest` RestAccessInfoRegistry
      - `host` string, required
      - `port` string, required
      - `username` string, required
      - `password` string, required
    - `ssh` SSHAccessInfoRegistry
      - `host` string, required
      - `port` string, required
      - `username` string, required
      - `password` string, required
      - `pub_key` string, required
      - `pub_key_type` 'ed25519' | 'ecdsa' | 'rsa', required
    - `cli` CLIAccessInfoRegistry
      - `host` string, required
      - `port` string
      - `username` string, required
      - `password` string, required
    - `smis` SMISAccessInfoRegistry
      - `host` string, required
      - `port` string
      - `username` string, required
      - `password` string, required
      - `namespace` string
    - `extra_attributes` object

## Response `200`

Accepted, items added to the infrastructure management

- StorageBackendResponse
  - `id` string
  - `name` string
  - `description` string
  - `vendor` string
  - `model` string
  - `status` string
  - `firmware` string
  - `serial_number` string
  - `location` string
  - `created_at` string
  - `updated_at` string
  - `sync_status` 'SYNCED' | 'SYNCING'
  - `total_capacity` integer
  - `used_capacity` integer
  - `free_capacity` integer

## Other responses

- `400` — BadRequest
- `401` — NotAuthorized
- `403` — Forbidden
- `409` — An item already exists
- `500` — An unexpected error occured.

---

[API](https://skmtc.net/sodafoundation/apis/soda-infrastructure-management-api.md) · [All operations](https://skmtc.net/sodafoundation/apis/soda-infrastructure-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sodafoundation/soda-infrastructure-management-api/revisions/b2017613d719/schema)