---
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

---

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