List the agent sessions on the caller's Reason Network

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.

_{Scope: sessions:read}

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

List the agent sessions on the caller's Reason Network

cURL

curl --request GET \
  --url https://api.reasonmachines.com/v3/organizations/{orgId}/agent-network/team \
  --header 'Authorization: Bearer <token>'

200

{
  "team": "<string>",
  "me": "<string>",
  "sessions": [
    {
      "address": "<string>",
      "machine": "<string>",
      "agent": "<string>",
      "status": "<string>",
      "since": 123,
      "repo": "<string>",
      "branch": "<string>",
      "doing": "<string>",
      "tier": "<string>",
      "worker": true,
      "is_me": true
    }
  ],
  "unreachable": 123,
  "unread": {
    "count": 123,
    "from": [
      "<string>"
    ]
  },
  "note": "<string>"
}

Authorizations

Authorization · string · header · required

Your Reason API key from Settings › API keys. New keys use reason_; legacy ara_ keys remain accepted. Keys are capability-scoped: run, mcp:read, mcp:write, secrets:read, secrets:write, sessions:read, sessions:debug, knowledge:read, memory:read, memory:write, skills:read, skills:write, repos:read, repos:write, reviews:read, reviews:write, deployment:read, analytics:read, org:read, org:write, attachments:read, attachments:write, guardrails:read, guardrails:write, network:read, network:write, automations:read, automations:write, agent_auth:read. network:read and network:write are opt-in, excluded from default keys. network:read reads the saved workspace network policy; network:write replaces custom allowed hosts and requires a current organization owner/admin. Legacy project PATCH requests containing network_allowed_hosts also require network:write plus their existing run scope and project management permission; saved project hosts do not affect current session egress. Only owners/admins can mint or manage keys with network:write; keys cannot grant themselves more authority. See /docs/network-policies for replacement semantics and runtime applicability. mcp:write manages MCP server configuration only; it does not authorize remote MCP-tool execution. sessions:read reads sessions, including the assistant, reasoning and tool activity in their events. sessions:debug is privileged: only for organization owners/admins, it expands session events to the full diagnostic projection (diagnostic event kinds, status text and raw event metadata).

Path Parameters

orgId · string · required

Organization id or slug. Resolve it with GET /v3/self.

Query Parameters

filter · string | null

Only sessions matching this text (person, session, machine, agent, repo, branch or what it's doing).

all · boolean | null

Also list sessions that are offline.

as · string | null

This chat's own name, such as editor, when the user talks to Reason Network from several chats of this app: the call is then that chat's own session, person/editor, with its own inbox, and a name another connection or chat of the user's has is refused. 1 to 32 lowercase letters, digits and dashes. Left out or blank, the connection's own session.

Maximum string length: 300

Response

200

application/json

The network's sessions.

team · string | null · 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

Show child attributes

unreachable · integer · required

Sessions left out because they aren't on Reason Network and can't be messaged.

unread · object | null · 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.

Show child attributes

note · string | null · 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.