> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Share Dataset

> Shares a dataset and grants access permissions to specified users



## OpenAPI

````yaml /openapi/product/data-sets.yaml post /api/data/v3/datasources/{datasetId}/share
openapi: 3.0.0
info:
  title: Datasets API
  version: v1
  description: >
    The Domo Datasets API provides a set of endpoints for managing, creating,
    and updating datasets within Domo. The API allows developers to execute SQL
    queries on datasets,

    manage access permissions, retrieve metadata, append rows, share datasets,
    and perform various dataset operations.
servers:
  - url: https://{instance}.domo.com
    description: Domo Instance
    variables:
      instance:
        default: example
        description: Your Domo instance name
security:
  - developerToken: []
paths:
  /api/data/v3/datasources/{datasetId}/share:
    post:
      tags:
        - Datasets API
      summary: Share Dataset
      description: Shares a dataset and grants access permissions to specified users
      parameters:
        - name: datasetId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ShareRequest'
            example:
              permissions:
                - id: ownerId1
                  type: USER
                  accessLevel: CO_OWNER
              sendEmail: true
      responses:
        '200':
          description: Dataset shared successfully
      x-codeSamples:
        - lang: HTTP
          source: |
            POST /api/data/v3/datasources/{datasetId}/share HTTP/1.1
            Host: {instance}.domo.com
            X-DOMO-Developer-Token: {token}
            Content-Type: application/json

            {
              "permissions": [
                {
                  "id": "ownerId1",
                  "type": "USER",
                  "accessLevel": "CO_OWNER"
                }
              ],
              "sendEmail": true
            }
components:
  schemas:
    ShareRequest:
      type: object
      required:
        - permissions
        - sendEmail
      properties:
        permissions:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              type:
                type: string
                enum:
                  - USER
                  - GROUP
              accessLevel:
                type: string
                enum:
                  - CO_OWNER
                  - READ
                  - READ_WRITE
        sendEmail:
          type: boolean
  securitySchemes:
    developerToken:
      type: apiKey
      in: header
      name: X-DOMO-Developer-Token
      description: Developer token obtained from Domo

````