---
title: "Create an authorization request"
method: POST
path: "/requests/auth"
tags: ["requests - authorization"]
---

# Create an authorization request

`POST /requests/auth`

Create a request asking for access against a dataset. A request can ask the resource admin for permission to access a resource. It may also be an invitation from the resource admin to give others access to a resource.

## Request body

- AuthRequestCreateDto
  - `dataset` DatasetIdentifierRequest, required
    - `id` string, required — ID of dataset
    - `owner` string, required — ID of user or organization that owns the dataset
  - `granteeId` string, required — ID of the user that will be granted access
  - `level` 'DISCOVER' | 'READ' | 'WRITE' | 'ADMIN', required — Level of access the grantee will receive

## Response `200`

default response

- AuthRequestDto
  - `approverParty` PublicParty
    - `type` 'USER' | 'GROUP', required
  - `created` string, date-time
  - `granteeParty` PublicParty
    - `type` 'USER' | 'GROUP', required
  - `level` 'NONE' | 'SAML_GATED' | 'DISCOVER' | 'MEMBER' | 'READ' | 'WRITE' | 'ADMIN' — Level of access the grantee will receive
  - `requesterParty` PublicParty
    - `type` 'USER' | 'GROUP', required
  - `requestid` string, uuid — Unique identifier for the request
  - `resource` PublicResource
    - `owner` string, required — ID of an organization that owns the resource
    - `type` 'ANALYSIS' | 'CATALOG' | 'COLUMN' | 'DATABASE' | 'DATASET' | 'DATASET_INSIGHT' | 'GLOSSARY' | 'GROUP' | 'METADATA_RESOURCE' | 'TABLE', required
  - `updated` string, date-time
  - `visibility` 'PRIVATE' | 'PUBLIC' — Authorization visibility

---

[API](https://skmtc.dev/data/apis/data-world-public-api.md) · [All operations](https://skmtc.dev/data/apis/data-world-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/data/data-world-public-api/revisions/0a0cb1f94dad/schema)