Skip to main content
Attach files to a run request using the files field on POST /v1/run. Files ride along as multipart/form-data and become blocks on the resulting canvas.

​
Supported file types

Images (create an image-block): PNG, JPEG, GIF, WEBP, SVG. Documents (create a file-block, indexed for agent access): PDF, DOCX, XLSX, CSV, TXT, MD, YAML, JSON, ZIP.

​
Example

curl -X POST https://api.getspine.ai/v1/run \
  -H "X-API-KEY: sk_spine_..." \
  -F "prompt=Summarize this sales data and create a chart" \
  -F "template=report" \
  -F "files=@sales-data.csv;type=text/csv" \
  -F "files=@revenue-chart.png;type=image/png"

​
Notes

  • Multiple files can be attached in a single request — just repeat -F "files=@...".
  • Image files show up as image-blocks on the canvas and are available to downstream agents by visual reference.
  • Document files are indexed at ingest time so every agent in the run can query them.
  • Maximum file size and total attachment limits apply per plan — see Pricing.