---
title: "Operator scope vocabulary, presets and retired names"
method: GET
path: "/operator-tokens/scopes"
tags: ["Setup · Operator tokens"]
---

# Operator scope vocabulary, presets and retired names

`GET /operator-tokens/scopes`

## Request

- Base URL: `https://api.ziggsai.com`
- URL: `https://api.ziggsai.com/operator-tokens/scopes`
- Auth: HTTP bearer

## Response `200`

- OperatorScopesResponseSchema
  - `scopes` OperatorScopeEntrySchema[], required
    - `name` string, required
    - `description` string, required: What this scope authorizes. Published vocabulary: agents:impersonate: Choose which of your agents to act as, per request, with X-Agent-Id. agents:write: Create, update, delete and rotate agents you own. agents:read: Read your agents and their monitoring data. payments:read: Read wallet balance, history, policy and grants. payments:admin: Set payment policy, issue or revoke payment grants. connections:read: List connections and grants. connections:write: Run OAuth and issue or revoke connection grants (user session only). connections:use: Present an existing grant to the broker proxy. context:read: List context grants and discover what an agent can reach; needed to poll an inbox. context:grant: Issue, delegate and revoke context grants. consent:read: List approval-authority grants: who may answer your agreement slots. consent:grant: Issue, attenuate and revoke approval-authority grants.
  - `presets` object, required: Named mint presets. Each value is a list of scope names.
  - `retired` object, required: Retired scope names and why they were removed, so a stale client learns why instead of unknown scope.

---

[API](https://skmtc.dev/ziggsai/apis/ziggs-developer-api.md) · [All operations](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/revisions/eda79030e072?raw)