---
title: "Share documents"
method: POST
path: "/hubs/{HubHashId}/projects/{ProjectId}/share"
tags: ["Shares"]
---

# Share documents

`POST /hubs/{HubHashId}/projects/{ProjectId}/share`

Share one or more documents to external users using their email. Send email with a link that external users can access to view and download the shared content.

## Path parameters

- `HubHashId` string, required
- `ProjectId` integer, required

## Request body

- FeaturesSharesShareDocumentsShareDocumentsCommandShareDocumentsCommandBody
  - `emails` string[], nullable
  - `remark` string, nullable
  - `documents` FeaturesSharesShareDocumentsShareDocumentsCommandSharedDocument[], nullable
    - `id` string, nullable
    - `revisionId` string, nullable
  - `name` string, nullable
  - `sharePurpose` 1 | 2

## Other responses

- `307` — According to the hub id, the request is at the wrong datacenter. Please retry with the URL in the "Location" header.
- `400` — The request is malformed, has invalid parameters values or one or more requested documents are unsafe and cannot be processed.
- `401` — The request is not authenticated.
- `403` — You don't have access to the project or access level to share these documents.
- `404` — The project or the document revision does not exist.

---

[API](https://skmtc.dev/bimtrackapp/apis/newforma-konekt-document-control-api.md) · [All operations](https://skmtc.dev/bimtrackapp/apis/newforma-konekt-document-control-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bimtrackapp/newforma-konekt-document-control-api/revisions/4671d430ce39/schema)