---
title: "List the agent sessions on the caller's Reason Network"
method: GET
path: "/v3/organizations/{orgId}/agent-network/team"
tags: ["Agent network"]
---

# List the agent sessions on the caller's Reason Network

`GET /v3/organizations/{orgId}/agent-network/team`

## Request

- Base URL: `https://api.reasonmachines.com`
- URL: `https://api.reasonmachines.com/v3/organizations/{orgId}/agent-network/team`
- Auth: HTTP bearer

Reason Network's `list_team`: the live agent sessions on the caller's Reason Network (the workspace's network, or the one a connector grant joined) across its computers (Claude Code, Codex, Cursor, workers and others), read through a member's computer that is online with Reason running, with the caller's own address under `me` and its unread messages under `unread`. Sessions that can't receive (not on Reason Network) are left out and counted in `unreachable`, as the engine shows them to agents. Answers 409 `agent_network_offline` when no member computer is online, and 409 `agent_network_no_answer` when one is but didn't read the network in time or said why it couldn't (trying again is safe). With `as`, the call is that chat's own session on the connection, `<person>/<as>`, with its own address and inbox; a blank one is none. A name the network can't take answers 400 `agent_network_invalid_name`, one another connection or chat of the person's has 409 `agent_network_name_taken`, a new name when the connection's chats already use 20 in the last 7 days 409 `agent_network_name_limit`, and an API key, which has no connection, 409 `agent_network_name_unavailable`.

<sub>Scope: `sessions:read`</sub>

## Query parameters

- `filter` string, nullable
- `all` boolean, nullable
- `as` string, nullable

## Response `200`

The network's sessions.

- AgentNetworkTeam
  - `team` string, nullable, required: The network's name.
  - `me` string, required: The caller's own address, person/agent, which its messages go out from and replies reach.
  - `sessions` object[], required
    - `address` string, required: Where `send_message` sends: person/session.
    - `machine` string, required
    - `agent` string, required: The agent kind, such as claude-code, codex, cursor or a personal agent's name.
    - `status` string, required: busy, idle, live or offline.
    - `since` number, nullable, required: When the status began, in milliseconds since the epoch.
    - `repo` string, nullable, required
    - `branch` string, nullable, required
    - `doing` string, nullable, required: What the session is working on, in its own words.
    - `tier` string, nullable, required: How soon it sees a message: push (right away, even when idle), turn (at its next step), pull (when it checks). Null from a computer whose Reason CLI doesn't say.
    - `worker` true: A headless agent a member put on the network to take work.
    - `is_me` true: The caller's own session.
  - `unreachable` integer, required: Sessions left out because they aren't on Reason Network and can't be messaged.
  - `unread` object, nullable, required: Messages to the caller's agent it hasn't read, and who sent them, as `check_inbox` returns them; null when there are none.
    - `count` integer, required
    - `from` string[], required
  - `note` string, nullable, required: What the caller should know: no computer to send from, a listing that couldn't do what was asked, a computer of the user's that needs a Reason CLI update, or that messages to it don't start its routine yet.

## Other responses

- `400`: `as` isn't a name the network takes (`agent_network_invalid_name`).
- `401`: Missing, invalid, or expired key.
- `403`: The key lacks the required scope or role.
- `409`: No member computer is online to read the network (`agent_network_offline`), or one is but didn't read it in time or said why it couldn't (`agent_network_no_answer`); or `as` can't be had (`agent_network_name_taken`, `agent_network_name_limit`, `agent_network_name_unavailable`).
- `429`: Too many requests. Retry after the number of seconds in the `Retry-After` response header.

## Changes

- **2026-10-26** `bef3f286922a`: 2 info
  - added the new optional `query` request parameter `as`
  - added the non-success response with the status `400`
- **2026-10-19** `cc2520777155`: 1 info
  - removed the non-success response with the status `404`
- **2026-10-17** `7c6a69d93f0f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ara/apis/reason-api/changes/v3/organizations/:orgId/agent-network/team/get.md)

---

[API](https://skmtc.dev/ara/apis/reason-api.md) - [All operations](https://skmtc.dev/ara/apis/reason-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ara/apis/reason-api/revisions/e97c8704807c?raw)