File uploads

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.

Agent instructions Webhooks

Get Started

Concepts

Use with agents

Endpoints

Resources

Python SDK

TypeScript SDK

Runs

Canvas

Supported file types

Example

Notes

​Supported file types

​Example

​Notes

Supported file types

Example

Notes