> ## 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**](https://praison.ai/docs/sdk/reference/praisonaiagents/modules/protocols.md) module.

AI Agent

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

> [card] [all()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/OperatorScope-all.md)
>
> Return every scope (granted by default when no policy is configured).

## Source

> [card] [View on GitHub](https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/gateway/protocols.py#L246)
>
> `praisonaiagents/gateway/protocols.py` at line 246


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.