---
title: "POST /v1beta/{tenantId}/file/shares"
method: POST
path: "/v1beta/{tenantId}/file/shares"
tags: ["File Shares"]
---

# POST /v1beta/{tenantId}/file/shares

`POST /v1beta/{tenantId}/file/shares`

Creates a file share.

## Request body

- FileShareCreateSpec
  - `name` string, required
  - `description` string
  - `size` integer, required
  - `availabilityZone` string
  - `profileId` string

## Response `202`

Accepted

- FileShareRespSpec — FileShare is a file system created by nfs southbound driver, it can be mounted on to physical machine or virtual machine instance.
  - `id` string
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `tenantId` string
  - `userId` string
  - `name` string
  - `description` string
  - `size` integer
  - `availabilityZone` string
  - `status` string
  - `profileId` string
  - `protocols` string[]
  - `exportLocations` string[]
  - `metadata` object

## Other responses

- `400` — BadRequest
- `401` — NotAuthorized
- `403` — Forbidden
- `500` — An unexpected error occured.

---

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