---
title: "Move the caller's connection to another of its person's Reason Network networks"
method: PUT
path: "/v3/organizations/{orgId}/agent-network/network"
tags: ["Agent network"]
---

# Move the caller's connection to another of its person's Reason Network networks

`PUT /v3/organizations/{orgId}/agent-network/network`

## Request

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

Moves a hosted assistant's connection (its OAuth grant on the Reason MCP) to one of the networks `list_networks` shows, by its `id` (`workspace` for the workspace's own network, or a team's id) or its `name`, as picking it on the consent screen would: its network tools act on that network from the next call, through token refreshes, and a `wake_me` webhook follows it. Its session name stays, as do its chats' names (`as`), which move with it. Unread messages on the network it left stay there, and `note` counts them, its chats' included. Answers 404 `agent_network_network_not_found` for a network `list_networks` doesn't show (another person's team, a stale team, another workspace's network), 409 `agent_network_network_ambiguous` for a name two of them share (give the `id`), and 409 `agent_network_networks_unavailable` for an API key or any other sign-in.

<sub>Scope: `run`</sub>

## Request body

- AgentNetworkJoinRequest
  - `network` string, required: The network's `id` or `name` as list_networks shows it: "workspace" for this workspace's own.

## Response `200`

The connection's network now.

- AgentNetworkJoin
  - `current` string, required: This connection's network now: its `id` in list_networks.
  - `name` string, required
  - `your_computers` string[], required: The user's own computers online on it now.
  - `note` string, required

## Other responses

- `401`: Missing, invalid, or expired key.
- `403`: The key lacks the required scope or role.
- `404`: Not a network the caller's connection can join (`agent_network_network_not_found`).
- `409`: A name two networks share (`agent_network_network_ambiguous`), or 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/network/put.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)