---
title: "Changes to Create a fileshare."
method: POST
path: "/v1/{tenantId}/file/shares"
---

# Changes to Create a fileshare.

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

> Every recorded change to this operation, newest first.
> 33 revisions in range; 3 not diffed.

## Timeline

Changed in 4 of 33 revisions.

- **2020-08-29** `7299be026d62`: 12 breaking, 12 warning, 7 info
- **2020-08-29** `443f565555ae`: 10 breaking, 5 warning, 15 info
- **2020-06-28** `7bc48776926e`: 1 info
- **2018-10-29** `50fa096a3906`: 1 breaking

## Changes

- **2020-08-29** `7299be026d62`: 12 breaking, 12 warning, 7 info
  - request property `Protocols` was restricted to a list of enum values
  - the request property `BackendId` became required
  - the request property `Metadata` became required
  - the request property `Name` became required
  - the `EncryptedSettings` request property type changed from `string` to `object`
  - the `Metadata` request property type changed from `string` to `object`
  - the `Protocols` request property type changed from `array` to `string`
  - the `Size` request property type changed from `string` to `integer`
  - the `EncryptedSettings` response's property type changed from `string` to `object` for status `200`
  - the `Metadata` response's property type changed from `string` to `object` for status `200`
  - the `Protocols` response's property type changed from `array` to `string` for status `200`
  - the `Size` response's property type changed from `string` to `integer` for status `200`
  - removed the request property `Status`
  - removed the request property `TenantId`
  - added the new `NFS` enum value to the `Protocols` response property for the response status `200`
  - added the new `SMB` enum value to the `Protocols` response property for the response status `200`
  - added the new `available` enum value to the `Status` response property for the response status `200`
  - added the new `creating` enum value to the `Status` response property for the response status `200`
  - added the new `deleted` enum value to the `Status` response property for the response status `200`
  - added the new `deleting` enum value to the `Status` response property for the response status `200`
  - added the new `error` enum value to the `Status` response property for the response status `200`
  - added the new `errorDeleting` enum value to the `Status` response property for the response status `200`
  - added the new `inUse` enum value to the `Status` response property for the response status `200`
  - added the new `updating` enum value to the `Status` response property for the response status `200`
  - added the new optional request property `Description`
  - added the new `NFS` enum value to the request property `Protocols`
  - added the new `SMB` enum value to the request property `Protocols`
  - added the optional property `CreatedAt` to the response with the `200` status
  - added the optional property `Description` to the response with the `200` status
  - added the optional property `Metadata/fields` to the response with the `200` status
  - added the optional property `UpdatedAt` to the response with the `200` status
- **2020-08-29** `443f565555ae`: 10 breaking, 5 warning, 15 info
  - removed the enum value `NFS` of the request property `Protocols`
  - removed the enum value `SMB` of the request property `Protocols`
  - the `EncryptedSettings` request property type changed from `object` to `string`
  - the `Metadata` request property type changed from `object` to `string`
  - the `Protocols` request property type changed from `string` to `array`
  - the `Size` request property type changed from `integer` to `string`
  - the `EncryptedSettings` response's property type changed from `object` to `string` for status `200`
  - the `Metadata` response's property type changed from `object` to `string` for status `200`
  - the `Protocols` response's property type changed from `string` to `array` for status `200`
  - the `Size` response's property type changed from `integer` to `string` for status `200`
  - removed the request property `Description`
  - removed the optional property `CreatedAt` from the response with the `200` status
  - removed the optional property `Description` from the response with the `200` status
  - removed the optional property `Metadata/fields` from the response with the `200` status
  - removed the optional property `UpdatedAt` from the response with the `200` status
  - added the new optional request property `Status`
  - added the new optional request property `TenantId`
  - the request property `BackendId` became optional
  - the request property `Metadata` became optional
  - the request property `Name` became optional
  - removed the `NFS` enum value from the `Protocols` response property for the response status `200`
  - removed the `SMB` enum value from the `Protocols` response property for the response status `200`
  - removed the `available` enum value from the `Status` response property for the response status `200`
  - removed the `creating` enum value from the `Status` response property for the response status `200`
  - removed the `deleted` enum value from the `Status` response property for the response status `200`
  - removed the `deleting` enum value from the `Status` response property for the response status `200`
  - removed the `error` enum value from the `Status` response property for the response status `200`
  - removed the `errorDeleting` enum value from the `Status` response property for the response status `200`
  - removed the `inUse` enum value from the `Status` response property for the response status `200`
  - removed the `updating` enum value from the `Status` response property for the response status `200`
- **2020-06-28** `7bc48776926e`: 1 info
  - endpoint added
- **2018-10-29** `50fa096a3906`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/sodafoundation/apis/soda-multi-cloud-api/docs/v1/:tenantId/file/shares/post.md) - [API](https://skmtc.dev/sodafoundation/apis/soda-multi-cloud-api.md) - [Page](https://skmtc.dev/sodafoundation/apis/soda-multi-cloud-api/changes/v1/:tenantId/file/shares/post)
