---
title: "Grant permissions on a dataset (Deprecated)"
method: POST
path: "/v2/datasets/{datasetId}/grants"
tags: ["Datasets"]
---

# Grant permissions on a dataset (Deprecated)

`POST /v2/datasets/{datasetId}/grants`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/datasets/{datasetId}/grants`
- Auth: HTTP bearer

Grant permissions to a specific dataset for users or teams.

  **Deprecation notice**: [Datasets](/docs/datasets) are deprecated. As of June 2, 2026, you can no longer create datasets or edit existing datasets. As of September 15, 2026, you can no longer use datasets as a data source. Migrate your datasets to data models and update any documents that use datasets as a data source to use a different source. See [Migrate a dataset to a data model](/docs/migrate-a-dataset-to-a-data-model).

  ### Usage notes
  - Retrieve the **datasetId** by calling the [/v2/datasets](https://help.sigmacomputing.com/reference/list-datasets) endpoint.
  - Grant permissions to one user or team at a time using the relevant IDs:

    - Retrieve the **memberId** by calling the [/v2/members](https://help.sigmacomputing.com/reference/list-members) endpoint.
    - Retrieve the **teamId** by calling the [/v2/teams](https://help.sigmacomputing.com/reference/list-teams) endpoint.

## Path parameters

- `datasetId` string, required

## Request body

- object
  - `grants` V2DatasetsDatasetIdGrantsPostRequestBodyContentApplicationJsonSchemaGrantsItems[], required
    - `grantee` union, required
      - V2DatasetsDatasetIdGrantsPostRequestBodyContentApplicationJsonSchemaGrantsItemsGrantee0: The UUID of the member receiving the grant
        - `memberId` string, required
      - V2DatasetsDatasetIdGrantsPostRequestBodyContentApplicationJsonSchemaGrantsItemsGrantee1: The UUID of the team receiving the grant
        - `teamId` string, required
    - `permission` 'view' | 'edit', required
    - `tagId` string

## Response `200`

The response body.

- DatasetsCreateDatasetGrantResponse200

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)