---
title: "Mount volume"
method: POST
path: "/namespaces/{namespace}/volumes/{name}/mount"
tags: ["Volume"]
---

# Mount volume

`POST /namespaces/{namespace}/volumes/{name}/mount`

Updates the mount reference for the volume.

## Path parameters

- `name` string, required
- `namespace` string, required

## Request body

- string

## Response `200`

Success

- Volume — A storage volume.
  - `ID` string — Volume unique ID.
  - `Name` string, required — Volume name.
  - `Description` string — Volume description.
  - `Size` integer, required — Size in GB.
  - `Pool` string — Name of capacity pool to provision the volume in, or the name of the current pool.
  - `Labels` object — User-defined key/value metadata.
  - `Master` Deployment — Volume master or replica deployment details.
    - `ID` string
    - `Controller` string
    - `Inode` integer
    - `Status` string
    - `Health` string
    - `CreatedAt` string, datetime
  - `Replicas` Deployment[] — Volume deployment information for the replica volumes.
    - `ID` string
    - `Controller` string
    - `Inode` integer
    - `Status` string
    - `Health` string
    - `CreatedAt` string, datetime
  - `Status` string — Short status, one of: pending, evaluating, deploying, active, unavailable, failed, updating, deleting.
  - `StatusMessage` string — Status message explaining current status.
  - `Health` string — Volume health, one of: healthy, degraded or dead.
  - `Inode` integer — Block device inode.
  - `Deleted` boolean — Flag indicating if the volume has been deleted and is waiting for scrubbing.
  - `Mounted` boolean — Flag indicating if the volume is mounted and in use.
  - `MountedBy` string — Reference to the node that has the volume mounted.
  - `Mountpoint` string — Mountpoint where the volume was mounted.
  - `MountedAt` string, dateTime — When the volume was mounted.
  - `CreatedBy` string — User that created the volume.
  - `CreatedAt` string, dateTime — When the volume was created.

## Other responses

- `401` — Unauthorized
- `407` — Volume already mounted
- `500` — Server error

---

[API](https://skmtc.dev/kubeup/apis/storageos-api.md) · [All operations](https://skmtc.dev/kubeup/apis/storageos-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kubeup/storageos-api/revisions/c1808b25d8d6/schema)