Agent network

List the agent sessions on the caller's Reason Network

Changed on

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>

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

Query parameters

filterstring nullable

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

allboolean nullable

Also list sessions that are offline.

asstring nullable

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.

Response

The network's sessions.

teamstring nullable required

The network's name.

mestring required

The caller's own address, person/agent, which its messages go out from and replies reach.

unreachableinteger required

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

notestring 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.

Changes