# Read workspace usage per member

Per member over a 7d, 30d or 90d `window`: the desktop installs they launch (platform, version, installed and last seen), the AI apps they connected and each app's MCP calls, their Neo turns, rounds and tokens with their most-used tools, and their MCP calls by client and tool with failures — plus the workspace's line (seats, how many have the desktop, a connected app, use Neo, use MCP). Admin only. Neo's dollar cost is not here. `mcpWindow` says how much of the window the runs table still holds.

Access class: `workspace:admin`.

## Endpoint

`GET /v1/workspace/usage/members`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| cursor | query | string | No |
| feature | query | string | No |
| limit | query | integer | No |
| member | query | integer | No |
| window | query | string | No |

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "mcpWindow": {
      "retention": "string",
      "since": "string",
      "sink": "string",
      "truncated": true,
      "until": "string"
    },
    "measuredAt": "2026-01-01T00:00:00Z",
    "members": [
      {
        "accountId": "",
        "connectedApps": [
          "string"
        ],
        "displayName": "string",
        "email": "string",
        "installs": [
          "string"
        ],
        "mcp": {
          "byClient": [
            "string"
          ],
          "byTool": [
            "string"
          ],
          "calls": 1.5,
          "failures": 1.5,
          "lastCallAt": "2026-01-01T00:00:00Z"
        },
        "neo": {
          "cachedTokens": 1.5,
          "inputTokens": 1.5,
          "lastTurnAt": "2026-01-01T00:00:00Z",
          "outputTokens": 1.5,
          "rounds": 1.5,
          "topTools": [
            "string"
          ],
          "turns": 1.5
        },
        "role": "string",
        "userId": 1.5
      }
    ],
    "name": "string",
    "since": "2026-01-01T00:00:00Z",
    "tenantId": 1.5,
    "totals": {
      "connectedApps": [
        "string"
      ],
      "installs": 1.5,
      "mcp": {
        "byClient": [
          "string"
        ],
        "byTool": [
          "string"
        ],
        "calls": 1.5,
        "failures": 1.5,
        "lastCallAt": "2026-01-01T00:00:00Z"
      },
      "neo": {
        "cachedTokens": 1.5,
        "inputTokens": 1.5,
        "lastTurnAt": "2026-01-01T00:00:00Z",
        "outputTokens": 1.5,
        "rounds": 1.5,
        "topTools": [
          "string"
        ],
        "turns": 1.5
      },
      "seats": 1.5,
      "usingMcp": 1.5,
      "usingNeo": 1.5,
      "withConnectedApp": 1.5,
      "withDesktop": 1.5
    },
    "until": "2026-01-01T00:00:00Z",
    "window": "string"
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```
