Attach file to run

Create an attachment linked to a run and get a temporary pre-signed URL. Upload the file to the URL with a PUT request to complete the attachment.

Access

API Key	Access Level	Description
User	Full	Users can create runs
Station	Limited	Stations cannot create runs

Endpoint

POST/v2/runs/{id}/attachments

Authorization

AuthorizationBearer <token>

API key for authentication. Use format: Bearer YOUR_API_KEY

In: header

Path Parameters

idstring

Unique identifier of the run to attach the file to.

Request Body

namestring

File name including extension (e.g. "report.pdf"). Used to determine content type and display name.

Length1 <= length <= 255

Response Body

from tofupilot.v2 import TofuPilot

# Initialize the TofuPilot client
client = TofuPilot()

# Execute the operation
result = client.runs.create(
    id="string",
    name="test_report.pdf"
)

# Handle response
print(result)

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "upload_url": "https://storage.example.com/org/file.pdf?X-Amz-Signature=abc123"
}

{
  "message": "Unauthorized",
  "code": "UNAUTHORIZED",
  "issues": []
}

{
  "message": "Not found",
  "code": "NOT_FOUND",
  "issues": []
}

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

How is this guide?