Update station
Update station name, identifier, and/or image. The station ID is specified in the URL path. To remove an image, pass an empty string for image_id.
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 update stations |
Station | Unauthorized | Stations cannot update station configurations |
Endpoint
/v2/stations/{id}
API key for authentication. Use format: Bearer YOUR_API_KEY
In: header
Path Parameters
Unique identifier of the station to update
uuid
New name for the station
1 <= length <= 60
New identifier for the station
^[a-zA-Z0-9_.:+-]+$
1 <= length <= 60
Upload ID for the station image, or empty string to remove image
Response Body
from tofupilot.v2 import TofuPilot
# Initialize the TofuPilot client
client = TofuPilot()
# Execute the operation
result = client.stations.update(
id="550e8400-e29b-41d4-a716-446655440000"
)
# Handle response
print(result)
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"identifier": "STA-B2C",
"name": "Assembly Station 2"
}
{
"code": "NOT_FOUND",
"message": "Procedure not found: {id}",
"issues": []
}
{
"code": "CONFLICT",
"message": "A version with this tag already exists for the procedure",
"issues": []
}
{
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal server error",
"issues": []
}
How is this guide?
List and filter stations GET
Retrieve a paginated list of stations with search functionality.
Remove station DELETE
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.