---
title: "POST /resource/{resourceId}/share"
method: POST
path: "/resource/{resourceId}/share"
tags: ["CreateShare"]
---

# POST /resource/{resourceId}/share

`POST /resource/{resourceId}/share`

Create a share for a file or container

## Path parameters

- `resourceId` string, required

## Query parameters

- `option` string

## Headers

- `cookie` string

## Request body

- ShareCreationRequestEntry[]
  - `guestEMail` string
  - `name` string
  - `permission` SharePermission
    - `readable` boolean
    - `writable` boolean
    - `deletable` boolean
    - `notificationEnabled` boolean
  - `pin` string
  - `hasPin` boolean
  - `expirationMillis` integer
  - `unmountable` boolean

## Response `207`

MULTI STATUS, One entry per guest

## Other responses

- `404` — NOT FOUND

---

[API](https://skmtc.net/iterate-ch/apis/restfs.md) · [All operations](https://skmtc.net/iterate-ch/apis/restfs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iterate-ch/restfs/revisions/517e17452ca3/schema)