Remove station

Remove a station with smart deletion behavior. If no runs exist, permanently deletes the station and all nested elements. If runs exist, archives the station (soft delete) and unlinks all procedure relationships but preserves historical data.

API v2 Preview

The TofuPilot API v2.0 is currently in public preview and is subject to change as we stabilize until release (planned for Aug 2025).

Access

API Key	Access Level	Description
User	Full	Users can remove stations
Station	Unauthorized	Stations cannot remove other stations

Endpoint

DELETE/v2/stations/{id}

Authorization

AuthorizationBearer <token>

API key for authentication. Use format: Bearer YOUR_API_KEY

In: header

Path Parameters

idstring

Unique identifier of the station to remove

Formatuuid

Response Body

from tofupilot.v2 import TofuPilot

# Initialize the TofuPilot client
client = TofuPilot()

# Execute the operation
result = client.stations.delete(
    id="550e8400-e29b-41d4-a716-446655440000"
)

# Handle response
print(result)

{
  "id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "code": "BAD_REQUEST",
  "message": "Procedure name is required",
  "issues": []
}

{
  "code": "NOT_FOUND",
  "message": "Procedure not found: {id}",
  "issues": []
}

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

How is this guide?