---
title: "Create a permission"
method: POST
path: "/permissions"
tags: ["public_permissions", "public", "Permissions"]
---

# Create a permission

`POST /permissions`

## Request body

- PermissionCreateRequest
  - `permissionType` 'organization_admin' | 'organization_editor' | 'organization_runner' | 'organization_reader' | 'organization_member' | 'workspace_admin' | 'workspace_editor' | 'workspace_runner' | 'workspace_reader', required — Subset of `PermissionType` (removing `instance_admin`), could be used in public-api.
  - `userId` string, uuid, required — Internal Airbyte user ID
  - `workspaceId` string, uuid
  - `organizationId` string, uuid

## Response `200`

Successful operation

- PermissionResponse — Provides details of a single permission.
  - `permissionId` string, uuid, required
  - `permissionType` 'instance_admin' | 'organization_admin' | 'organization_editor' | 'organization_runner' | 'organization_reader' | 'organization_member' | 'workspace_owner' | 'workspace_admin' | 'workspace_runner' | 'workspace_editor' | 'workspace_reader', required — Describes what actions/endpoints the permission entitles to
  - `userId` string, uuid, required — Internal Airbyte user ID
  - `workspaceId` string, uuid
  - `organizationId` string, uuid

## Other responses

- `400` — Invalid data
- `403` — Not allowed

## Changes

> 31 revisions in range; 1 could not be searched.

- **2024-10-23** `fae855ef1b76` — 2 warning, 2 info
  - added the new `organization_runner` enum value to the `permissionType` response property for the response status `200`
  - added the new `workspace_runner` enum value to the `permissionType` response property for the response status `200`
  - added the new `organization_runner` enum value to the request property `permissionType`
  - added the new `workspace_runner` enum value to the request property `permissionType`

[Change history](https://skmtc.dev/airbytehq/apis/airbyte-api/changes/permissions/post.md)

---

[API](https://skmtc.dev/airbytehq/apis/airbyte-api.md) · [All operations](https://skmtc.dev/airbytehq/apis/airbyte-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/airbytehq/airbyte-api/revisions/1ab9ff46c57a/schema)