> ## Documentation Index
> Fetch the complete documentation index at: https://opentrain.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Revoke Permission

> Remove a user's role from an instruction workspace.

Removes a user's role from a workspace. The persisted `OWNER` role cannot be revoked.

**Requirements:** `instructions:publish` + workspace `OWNER` + a verified (claimed) account.

## Request

<ParamField path="workspaceId" type="string" required>
  The workspace id.
</ParamField>

<ParamField path="principalId" type="string" required>
  The user whose role is removed.
</ParamField>

## Response

<ResponseField name="revoked" type="boolean">
  `true` when a role was removed.
</ResponseField>

<ResponseField name="principalId" type="string">
  Echo of the revoked principal.
</ResponseField>