---
title: "Claim the next agent network call this computer carries"
method: POST
path: "/v3/organizations/{orgId}/agent-network/relay/claim"
tags: ["Agent network"]
---

# Claim the next agent network call this computer carries

`POST /v3/organizations/{orgId}/agent-network/relay/claim`

## Request

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

A member's Reason CLI on the network long-polls here for the next Reason Network call (`list_team`, `send_message`, `networkWho`, `networkAsk`) routed to it: the workspace's, when its engine is on the workspace's network, and its own user's calls from connector grants on the engine team whose `team_id` it reports, from any workspace. A claim that reports the hosted sessions the computer registered (`hosted`) is answered with those it carries now (`hosted`): its own user's hosted assistants' sessions on that network, each carried by one of their computers on it. Only the Reason CLI may: any other sign-in gets 403 `agent_network_cli_only`.

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

## Request body

- object
  - `machine` string, required
  - `person` string, required
  - `team` string, required
  - `team_id` string
  - `workspace` boolean
  - `version` string
  - `wait_seconds` integer
  - `message_counts` object[]
    - `day` string, required
    - `sent` integer, required
    - `received` integer, required
  - `endpoint` string
  - `hosted` object[]
    - `name` string, required
    - `address` string

## Response `200`

`{ job, hosted }`: the claimed call, or null when none came within the wait; with `hosted` reported, the hosted sessions this computer carries.

## Other responses

- `401`: Missing, invalid, or expired key.
- `403`: The key lacks the required scope or role.
- `429`: Too many requests. Retry after the number of seconds in the `Retry-After` response header.

## Changes

- **2026-10-26** `bef3f286922a`: 5 info
  - added the new optional request property `endpoint`
  - added the new optional request property `hosted`
  - added the new optional request property `message_counts`
  - added the new optional request property `team_id`
  - …1 more
- **2026-10-16** `71ef2e9d8d33`: 1 info
  - endpoint added

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