---
title: "POST /v1beta/{tenantId}/file/acls"
method: POST
path: "/v1beta/{tenantId}/file/acls"
tags: ["File Share Acls"]
---

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

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

## Request

- Base URL: `https://localhost:50040`
- URL: `https://localhost:50040/v1beta/{tenantId}/file/acls`
- Auth: HTTP basic

Creates a file share acl.

## Request body

- FileShareAclCreateSpec
  - `fileshareId` string, required
  - `type` string, required
  - `accessCapability` string[], required
  - `accessTo` string, required
  - `description` string

## Response `202`

Accepted

- FileShareAclRespSpec: File Share Acl API describes the acl of file share resource
  - `id` string
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `fileshareId` string
  - `type` string
  - `accessCapability` string[]
  - `accessTo` string
  - `tenantId` string
  - `userId` string
  - `description` string
  - `status` string
  - `profileId` string
  - `metadata` object

## Other responses

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

## Changes

- **2019-12-09** `6f907ee4cf9b`: 11 breaking, 2 warning, 2 info
  - added the new required request property `accessCapability`
  - added the new required request property `accessTo`
  - added the new required request property `fileshareId`
  - added the new required request property `type`
  - …11 more
- **2019-11-08** `fd0669e1e56f`: 6 info
  - added optional request body
  - added the media type `application/json` for the response with the status `202`
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `401`
  - …2 more
- **2019-06-11** `2aca5485378c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sodafoundation/apis/soda-api/changes/v1beta/:tenantId/file/acls/post.md)

---

[API](https://skmtc.dev/sodafoundation/apis/soda-api.md) - [All operations](https://skmtc.dev/sodafoundation/apis/soda-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sodafoundation/apis/soda-api/revisions/62ce0f6c94b4?raw)