---
title: "Create or update grants to the workbook"
method: POST
path: "/management/v2/reports/embed/share-workbook"
tags: ["Embedded Reports"]
---

# Create or update grants to the workbook

`POST /management/v2/reports/embed/share-workbook`

## Request

- Base URL: `https://your-subdomain.deputy.deputy.com/api`
- URL: `https://your-subdomain.deputy.deputy.com/api/management/v2/reports/embed/share-workbook`
- Auth: API key in header `OAuth`

Create or update grants to the workbook.

## Request body

- EmbeddedReportsShareWorkbookRequest
  - `data` ModelShareWorkbookRequestData
    - `workbookId` string
    - `userGrantRequestData` ModelUserGrantRequestData[]
      - `userUuid` string
      - `workbookPermission` string
    - `teamWorkbookPermission` string
    - `isCustomWorkbook` boolean

## Response `200`

A successful response.

- EmbeddedReportsShareWorkbookResponse
  - `success` boolean

---

[API](https://skmtc.dev/deputy/apis/deputy-v2-api.md) - [All operations](https://skmtc.dev/deputy/apis/deputy-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/deputy/apis/deputy-v2-api/revisions/78f0278f4608?raw)