---
title: "Update a permission"
method: PATCH
path: "/permissions/{permissionId}"
tags: ["public_permissions", "public", "Permissions"]
---

# Update a permission

`PATCH /permissions/{permissionId}`

## Request body

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

## Response `200`

Successful updated

- 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
- `404` — Not found
- `422` — Data issue

## 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/:permissionId/patch.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)