---
title: "Share folder with an entity."
method: POST
path: "/folders/{fid}/share"
tags: ["Folder"]
---

# Share folder with an entity.

`POST /folders/{fid}/share`

* Specify the type of entity to share with using `entries.entryType`: 
    * 0 (User)  
    * 1 (Company) 
    * 2 (Team) 
    * 3 (Document) 
    * 4 (Application) 
* Provide one of the identifiers in the `entries` object in the request body.  
    * You can share with non-Onshape users with the `email` field when `entryType=0`.  
 * Provide the string for the permission set. Do not include the integer in parentheses: 
    * OWNER (100): Object owner. Implies all permissions including those not listed such as permission to transfer ownership. 
    * DELETE (90) 
    * RESHARE (80) 
    * WRITE (70) 
    * READ (60) 
    * LINK (50) 
    * COPY (30): Can copy workspace 
    * EXPORT (20): Can export geometry 
    * COMMENT (10) 
    * ANONYMOUS_ACCESS (5): Special, restricted read access

## Path parameters

- `fid` string, required

## Response `default`

default response

---

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