---
title: "Share Exam"
method: POST
path: "/teacher-exams/{exam_id}/share"
tags: ["Teacher Exams Sharing"]
---

# Share Exam

`POST /teacher-exams/{exam_id}/share`

Share a teacher exam with proper permission checks.

Users can share if:
- They own the exam directly, OR
- They have write access through folder inheritance

## Path parameters

- `exam_id` string, required

## Request body

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

## Response `200`

Successful Response

- ShareExamResponse
  - `status` string, required
  - `message` string, required
  - `sharing` ShareExamRequest, required
    - `shared_with_school` boolean
    - `shared_with` string[]
    - `read_only` 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.dev/excellence-ai/apis/excellence-learning/revisions/b73d9bd491c3?raw)