Update run
Update a test run with new attachments. The upload must be initialized and completed before calling this endpoint.
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 any run |
| Station | Limited | Stations can update runs for procedures to which they are currently linked |
Endpoint
/v2/runs/{id}API key for authentication. Use format: Bearer YOUR_API_KEY
In: header
Path Parameters
Unique identifier of the run to update.
uuidArray of upload IDs to attach to the run.
Response Body
from tofupilot.v2 import TofuPilot
# Initialize the TofuPilot client
client = TofuPilot()
# Execute the operation
result = client.runs.update(
id="550e8400-e29b-41d4-a716-446655440000"
)
# Handle response
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 and filter runs GET
Retrieve a paginated list of test runs with optional filtering by unit, procedure, date range, outcome, and other criteria. Supports sorting and includes run metadata.
Delete runs DELETE
Permanently delete one or more test runs by their IDs. This action cannot be undone and will remove all nested elements including phases, measurements, and run attachments from both database and S3 storage.