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

# Operator Scope • AI Agent SDK

> OperatorScope: Operator authorisation scopes for multi-operator Gateway access control.

# OperatorScope

> Defined in the [**protocols**](../modules/protocols) module.

<Badge color="blue">AI Agent</Badge>

Operator authorisation scopes for multi-operator Gateway access control.

These describe *what an authenticated operator is allowed to do*, layered on
top of (and orthogonal to) authentication. The vocabulary lives in the core
SDK so that protocol clients and the wrapper Gateway share the same names;
enforcement happens in the wrapper where requests are dispatched.

Scopes:
READ:      View dashboard / receive session transcripts and status.
WRITE:     Send messages as the agent.
APPROVALS: Resolve tool-execution approvals (security-sensitive).
PAIRING:   Approve / revoke device pairing.
ADMIN:     Channel control (pause / resume / reconnect) and management.

## Methods

<CardGroup cols={2}>
  <Card title="all()" icon="function" href="../functions/OperatorScope-all">
    Return every scope (granted by default when no policy is configured).
  </Card>
</CardGroup>

## Source

<Card title="View on GitHub" icon="github" href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/gateway/protocols.py#L237">
  `praisonaiagents/gateway/protocols.py` at line 237
</Card>