---
title: "Operator agent: the strip, the \"Needs you\" queue and the open proposals"
method: GET
path: "/api/operator/overview"
tags: ["Operator agent"]
---

# Operator agent: the strip, the "Needs you" queue and the open proposals

`GET /api/operator/overview`

## Request

- Base URL: `https://tre-app.com`
- URL: `https://tre-app.com/api/operator/overview`
- 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. Which Stripe and which access mode this installation runs, how many proposals wait, every attention line (the app's kind, its level, how many it counts, the ids behind it and the console page that lists them) and the open proposals, newest first. Read this first.

## Response `200`

Success

- OpsAgentOverview
  - `app` 'tre', required
  - `contractVersion` 1, required
  - `strip` object, required
  - `attention` object[], required
    - `kind` string, required
    - `level` 'red' | 'amber', required
    - `count` integer, required
    - `targetIds` string[], required
    - `consoleUrl` string, required
  - `proposals` object[], required
    - `id` string, uuid, required
    - `createdAt` string, date-time, required
    - `proposedBy` string, required
    - `action` 'access_request.invited' | 'access_request.declined' | 'access_request.reopened' | 'token.revoked' | 'grant.revoked' | 'sessions.revoked' | 'workspace.suspended' | 'workspace.suspension_lifted', required
    - `accountId` string, uuid, nullable, required
    - `accountSlug` string, nullable, required
    - `subjectUserId` string, uuid, nullable, required
    - `subjectEmail` string, email, nullable, required
    - `targetId` string, uuid, nullable, required
    - `reasonCode` 'customer_request' | 'data_subject_request' | 'security_incident' | 'acceptable_use' | 'payment_dispute' | 'housekeeping', required
    - `reference` string, nullable, required
    - `rationale` string, required
    - `payload` object, required
    - `expiresAt` string, date-time, required
    - `status` 'open' | 'approved' | 'rejected' | 'expired' | 'superseded', required
    - `stale` boolean, nullable, required
    - `decidedAt` string, date-time, nullable, required
    - `decidedBy` string, nullable, required
    - `decisionNote` string, nullable, 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)