---
title: "Share a document"
method: POST
path: "/documents/{id}/share"
tags: ["Document sharing"]
---

# Share a document

`POST /documents/{id}/share`

Shares a document to a user specified by email

## Path parameters

- `id` string, uuid, required

## Request body

- DocumentShareRequest — Document sharing parameters
  - `assigned_data_field_ids` string[] — List of data fields IDs this user can update if their role is set to filler
  - `can_access_private_comments` boolean — Allows accessing private comments if set to **true**. It is always **true** for **manager** role. For other roles, it can be set using this parameter.
  - `can_access_private_history` boolean — Allows accessing private comments if set to **true**.
  - `can_send_for_signature` boolean — Allows sending for signature if set to **true**. It is always **true** for **manager** role and always **false** for **reviewer** role. For other roles, it can be set using this parameter.
  - `email` string, email, required — User's email
  - `message` string, required — Message to the user. If you don't have it, send an empty string.
  - `role` 'manager' | 'editor' | 'filler' | 'reviewer', required — User's role

## Response `204`

Success

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity

---

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