Skip to main content
curl
curl -X POST https://api.getspine.ai/v1/run \
  -H "X-API-KEY: sk_spine_..." \
  -F "prompt=Summarize this sales data" \
  -F "template=memo" \
  -F "files=@sales-data.csv;type=text/csv"

{
  "success": true,
  "data": {
    "run_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "running",
    "poll_url": "/v1/run/550e8400-e29b-41d4-a716-446655440000",
    "estimated_duration_ms": 900000
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.getspine.ai/llms.txt

Use this file to discover all available pages before exploring further.

Try this in the developer playground

Async runs need an API key and typically take 10–20 minutes (up to 2 hours for complex research). Get $5 of free credits on signup — no subscription, $1 = 1,000 credits. The developer playground handles auth, polling, and artifact downloads for you.
For push notifications on run completion, configure a webhook endpoint in the developer portal instead of using the per-run webhook_url field. See Webhooks for the event schema and signature verification.

Authorizations

​
X-API-KEY
string
header
required

An API key from the Spine developer portal. Keys are prefixed with sk_spine_ and shown only once at creation. Keep them server-side.

Body

multipart/form-data
​
prompt
string
required

What you want the agents to do.

Example:

"Create a Q1 performance report with charts"

​
template
enum<string>

Preset block configuration. Ignored when blocks is provided. Defaults to auto.

Available options:
auto,
deep_research,
report,
slides,
memo,
excel,
app,
landing_page
​
blocks
string

JSON-encoded array of block types to override the template, e.g. ["document-block","table-block","image-block"]. Precedence: blocks > template > auto.

Example:

"[\"document-block\",\"table-block\",\"web-block\"]"

​
agent_instructions
string

Behavioral guidance applied across all agent layers (tone, rigor, audience, citation requirements, etc.).

Example:

"Write for a C-suite executive audience. Cite all sources."

​
webhook_url
string<uri>

Reserved for future webhook delivery — not yet honored.

​
files
file[]

Optional file attachments. Images (PNG, JPEG, GIF, WEBP, SVG) become image-blocks; documents (PDF, DOCX, XLSX, CSV, TXT, MD, YAML, JSON, ZIP) become indexed file-blocks.

Response

Run accepted. Poll poll_url for status and results.

​
success
boolean
required
​
data
object
required