v1 Reference/Runs
Update run
Update a test run with new attachments. The upload must be initialized and completed before calling this endpoint.
Access
| API Key | Access Level | Description |
|---|---|---|
| User | Full | Users can update any run of their organization |
| Station | Limited | Stations can update runs for procedures to which they are currently linked |
Endpoint
PUT
/v1/runsAuthorizationBearer <token>
API key for authentication. Use format: Bearer YOUR_API_KEY
In: header
idstring
Unique identifier of the run to update.
Format
uuidattachments?array<string>
Array of upload IDs to attach to the run.
Response Body
from tofupilot.v1 import TofuPilotClient
client = TofuPilotClient()
result = client.update_runs(
id="550e8400-e29b-41d4-a716-446655440000"
)
print(result){
"id": "550e8400-e29b-41d4-a716-446655440000"
}{
"code": "NOT_FOUND",
"message": "Operator with email {operated_by} does not exist. Create the user first in the app.; Procedure with ID {id} does not exist. Create the procedure first in the app.",
"issues": []
}{
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal server error",
"issues": []
}How is this guide?
List runs by serial number GET
Retrieve all test runs associated with a specific unit identified by serial number. Returns comprehensive run data including metadata, phases, and measurements.
Create run POST
Create a new test run linking to a procedure and unit. Unit identifiers are matched case-insensitively - existing entities are reused, new ones are created automatically.