TofuPilotTofuPilot
v2 Reference (Preview)/Stations

Get station

Retrieve detailed information about a specific station including linked procedures and connection status.

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 KeyAccess LevelDescription
UserFullUsers can get station details
StationFullStations can get their own station details

Endpoint

GET/v2/stations/{id}
AuthorizationBearer <token>

API key for authentication. Use format: Bearer YOUR_API_KEY

In: header

Path Parameters

idstring

Unique identifier of the station to retrieve

Formatuuid

Response Body

from tofupilot.v2 import TofuPilot

# Initialize the TofuPilot client
client = TofuPilot()

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

# Handle response
print(result)
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "identifier": "STA-A1B",
  "name": "Assembly Station 1",
  "image": "https://example.com/station-image.jpg",
  "api_key": "550e8400-e29b-41d4-a716-446655440001",
  "procedures": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "identifier": "PROC-001",
      "name": "Assembly Test",
      "runs_count": 42
    }
  ],
  "connection_status": "connected"
}
{
  "code": "NOT_FOUND",
  "message": "Procedure not found: {id}",
  "issues": []
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

How is this guide?