---
title: "Delete Station"
method: DELETE
path: "/v1/teams/{team_id}/stations/{station}"
tags: ["stations"]
---

# Delete Station

`DELETE /v1/teams/{team_id}/stations/{station}`

## Request

- Base URL: `https://api.stormy.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stormy.ai/v1/teams/{team_id}/stations/{station}`
- Auth: none declared

Delete a place: the folder, everything filed in it, and its screens.

WHAT A PERSON MEANS BY DELETING A PLACE is that the place is gone — not that
its notes survive in a folder nothing opens and its screens reappear at the
top of the rail. So this is one commit over the whole set, and the menu says
so before the click.

`-f` ON THE `git rm`, DELIBERATELY. A folder holds hundreds of files and the
agent may have touched one since its last commit; without it a single dirty
note refuses the whole act and the owner reports delete as broken — which is
the exact bug the page delete was already fixed for (2026-08-19). What is
lost is a change git never had; everything committed is in the history.

OURS IS NOT THE SHOP'S TO UNLINK. A place we ship lives in this repo, so it
leaves by being overridden: the shop's own `_meta.md` marked `hidden: true`,
which is this place gone from this shop's rail and our template untouched
for everyone else.

WHAT DOES NOT GO: lines said in the desk (`channel_messages`) are rows in
the database, not files, and they are addressed by name — a place made again
under the same name finds them waiting. That is deliberate: this endpoint
deletes a shop's OWN writing, and a delete that also erased what customers
said would be a different and much larger promise.

## Path parameters

- `team_id` string, uuid, required
- `station` string, required

## Headers

- `authorization` string, nullable
- `x-darwin-token` string, nullable

## Response `200`

Successful Response

- ChannelWrite: What the tree looks like now, and the commit that made it so.
  - `name` string, required
  - `rail` integer, nullable
  - `hidden` boolean, nullable
  - `commit` string
  - `removed` string[]
  - `pushed` boolean
  - `push_reason` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stormy/apis/stormy-control-plane.md) · [All operations](https://skmtc.dev/stormy/apis/stormy-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/stormy/apis/stormy-control-plane/revisions/4d811ab18158?raw)