---
title: "Say this computer left one of your Reason Network teams"
method: POST
path: "/v3/network/teams/leave"
tags: ["Agent network"]
---

# Say this computer left one of your Reason Network teams

`POST /v3/network/teams/leave`

## Request

- Base URL: `https://api.reasonmachines.com`
- URL: `https://api.reasonmachines.com/v3/network/teams/leave`
- Auth: HTTP bearer

The Reason CLI calls this after its computer left a Reason Network team. The computer stops being registered on it; when it was the last computer on the team (`last`), nobody can let the person back in, so the team leaves the account's directory and sign-in stops offering it. Another of the account's computers registered on the team keeps it; when the link the directory offered was made by the leaving computer, the latest link one of those computers sent takes its place.

<sub>Auth: any valid API key (no scope)</sub>

## Request body

- object
  - `team_id` string, required: The team's id, as the engine prints it.
  - `link` string, required: The team's link, which proves this computer was on it.
  - `last` boolean, required: The engine's roster listed no other computer on the team just before this one left it.

## Response `200`

{ removed }: true when the team left the account's directory; false when the account has no such team, or it stays (other members, or another of the account's computers registered on it).

## Other responses

- `400`: A missing field, a link without a team ticket, or a team_id that isn't the link's team.
- `401`: Missing, invalid, or expired key.
- `403`: Not the Reason CLI, or (`link_mismatch`) the link isn't the team's or this computer isn't registered on it.
- `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/network/teams/leave/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)