tofupilot attachments

Last updated on June 26, 2026

The attachments command exposes the two-step upload primitives used internally by runs create-attachment and units create-attachment. Use these directly when you script raw multipart uploads.

initialize

The initialize subcommand initializes an upload. The required flag is --name. Pass --json to capture the upload ID and presigned URL in the output; human mode prints a success line without them.

init upload
tofupilot attachments initialize --name report.pdf --json

finalize

The finalize subcommand finalizes an upload after the bytes have been pushed to the presigned URL, and the required flag is --id.

finalize upload
tofupilot attachments finalize --id upload_abc

How is this guide?

On this page