---
title: "Share a Google Drive file with a person or the organization"
method: POST
path: "/v1/capabilities/google-workspace/drive-file-share/{fileId}"
tags: ["Capability Sources"]
---

# Share a Google Drive file with a person or the organization

`POST /v1/capabilities/google-workspace/drive-file-share/{fileId}`

Creates a Drive permission for one file using the calling member's Google Workspace account. To share with one person pass type=user plus emailAddress; to share with the entire organization pass type=domain plus the org's Google Workspace domain (e.g. openworklabs.com). Sharing files not created through OpenWork needs the Full Drive access feature enabled by an admin.

## Path parameters

- `fileId` string, required

## Request body

- GoogleWorkspaceShareDriveFileBody
  - `type` 'user' | 'domain', required — Use type=user to share with one person, or type=domain to share with the entire organization.
  - `emailAddress` string, email — Required when type=user; pass the person's email address, for example raghav@openworklabs.com.
  - `domain` string — Required when type=domain; pass the organization's Google Workspace domain, for example openworklabs.com.
  - `role` 'reader' | 'commenter' | 'writer' — Drive permission role to grant.
  - `sendNotificationEmail` boolean — Whether Google should email the recipient about the new access.

## Response `200`

Google Drive file shared.

- GoogleWorkspaceShareDriveFileResponse
  - `ok` true, required
  - `fileId` string, required
  - `permissionId` string, required
  - `type` string, required
  - `role` string, required

## Other responses

- `400` — The share request was invalid.
- `401` — The caller must be signed in.
- `409` — The calling member has not connected their Google account or is missing permission.
- `502` — Google rejected the request.

---

[API](https://skmtc.net/openworklabs/apis/den-api.md) · [All operations](https://skmtc.net/openworklabs/apis/den-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openworklabs/den-api/versions/55ba7d5c7a7b/schema)