---
title: "Share a file or folder with one person by email"
method: POST
path: "/v1/workspaces/{workspaceId}/share-person"
tags: ["External sharing"]
---

# Share a file or folder with one person by email

`POST /v1/workspaces/{workspaceId}/share-person`

Teams/Enterprise. Admin only. Invites an external user if needed and mints an `external_user` grant. Returns 409 if the email is already an internal member.

## Request body

- object
  - `email` string, email, required
  - `resource_type` 'file' | 'folder', required
  - `resource_id` string, required
  - `capability` 'view' | 'comment'

## Response `200`

Grant created (idempotent re-share)

## Other responses

- `403` — Access denied
- `409` — Email is already an internal workspace member

---

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