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

---

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