---
title: "List the Reason Network networks the caller's connection can join"
method: GET
path: "/v3/organizations/{orgId}/agent-network/networks"
tags: ["Agent network"]
---

# List the Reason Network networks the caller's connection can join

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

## Request

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

For a hosted assistant's connection (an OAuth grant on the Reason MCP): the networks the person's consent screen offers it in this workspace, the one their computers are on first: the workspace's own network where a computer of theirs has been (`id` `workspace`), and their Reason Network teams that aren't stale. Each says whether it is the connection's `current` one, which of the person's own computers are online on it now, and who has a computer online on it, with how many. Another workspace's network is never listed: a connection belongs to one workspace, and reaching another takes connecting again there (`note` names one a computer of theirs is online on). `join_network` moves the connection. Answers 409 `agent_network_networks_unavailable` for an API key or any other sign-in.

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

## Query parameters

- `as` string, nullable

## Response `200`

The networks.

- AgentNetworkNetworks
  - `current` string, required: This connection's network: its `id`.
  - `networks` object[], required: The user's networks this connection can join, the one their computers are on first.
    - `id` string, required: What `join_network` takes: "workspace" for this workspace's own network, otherwise the team's id.
    - `name` string, required
    - `current` true: This connection's network now.
    - `your_computers` string[], required: The user's own computers online on it now, the most recently seen first; calls on it go through one of them.
    - `people` object[], required: Everyone with a computer online on it now, the user too: the name their addresses start with, and how many computers.
      - `person` string, required
      - `computers` integer, required
  - `note` string, nullable, required

## Other responses

- `401`: Missing, invalid, or expired key.
- `403`: The key lacks the required scope or role.
- `409`: The caller isn't a connector's sign-in (`agent_network_networks_unavailable`).
- `429`: Too many requests. Retry after the number of seconds in the `Retry-After` response header.

## Changes

- **2026-10-26** `bef3f286922a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ara/apis/reason-api/changes/v3/organizations/:orgId/agent-network/networks/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)