---
title: "Share Folder"
method: POST
path: "/folders/{folder_id}/share"
tags: ["folders"]
---

# Share Folder

`POST /folders/{folder_id}/share`

Share a folder with proper permission checks.

Only folder owners can share folders.

## Path parameters

- `folder_id` string, required

## Request body

- ShareOptions
  - `read_only` boolean
  - `shared_with` string[]
  - `shared_with_school` boolean

## Response `200`

Successful Response

- ShareResponse
  - `status` string, required
  - `message` string, required
  - `sharing` ShareOptions, required
    - `read_only` boolean
    - `shared_with` string[]
    - `shared_with_school` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) · [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/excellence-ai/excellence-learning/revisions/8d495ed916c6/schema)