---
title: "Operator agent: one view of the console"
method: GET
path: "/api/operator/list"
tags: ["Operator agent"]
---

# Operator agent: one view of the console

`GET /api/operator/list`

## Request

- Base URL: `https://tre-app.com`
- URL: `https://tre-app.com/api/operator/list`
- Auth: HTTP bearer

For the operator's agent credential (a personal token flagged by the installation's operator, see cloud/docs/ops-contract.md); every other caller receives 404 NOT_FOUND. `view` is `people`, `accounts` (the workspaces), `requests` or `proposals`; `lens` is one of that view's lenses (400 naming them when it is another; the first is the default); `q` keeps the rows with a text cell that contains it, in any case. At most 200 rows; `total` counts the lens, or the rows kept when `q` is given.

## Query parameters

- `view` 'people' | 'accounts' | 'requests' | 'proposals', required
- `lens` string
- `q` string

## Response `200`

Success

- OpsAgentList
  - `view` 'people' | 'accounts' | 'requests' | 'proposals', required
  - `lens` string, required
  - `rows` object[], required
  - `total` integer, required

## Other responses

- `400`: Invalid request
- `401`: Unauthenticated
- `403`: Forbidden: insufficient role or token scope; scope denials name the held scope and the operation
- `404`: Not found
- `409`: Conflict
- `429`: Rate limited
- `500`: Internal server error
- `503`: Temporarily unavailable

---

[API](https://skmtc.dev/tre-app/apis/tre-rest-api.md) · [All operations](https://skmtc.dev/tre-app/apis/tre-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tre-app/apis/tre-rest-api/revisions/26a7187a05fc?raw)