---
title: "Remove a Reason Network team nobody is on any more"
method: DELETE
path: "/v3/network/teams"
tags: ["Agent network"]
---

# Remove a Reason Network team nobody is on any more

`DELETE /v3/network/teams`

## Request

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

The earlier form of `POST /v3/network/teams/leave`, with `last` true unless the body says otherwise. Kept for CLIs that send it.

<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: 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/delete.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)