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

# List Permissions

> List per-user roles on an instruction workspace.

Lists persisted per-user roles on a workspace, including the `OWNER` record created with the workspace. `OWNER` is not grantable or revocable through these endpoints.

**Requirements:** both `instructions:read` and `instructions:publish`, plus workspace `OWNER` access.

## Request

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

## Response

<ResponseField name="permissions" type="object[]">
  `{id, principalType: "USER", principalId, role, createdAt, updatedAt}` — `role` is `OWNER`, `EDITOR`, `REVIEWER`, or `VIEWER`.
</ResponseField>