curl
curl https://api.getspine.ai/v1/run/<run_id> \
-H "X-API-KEY: sk_spine_..."
import requests
r = requests.get(
f"https://api.getspine.ai/v1/run/{run_id}",
headers={"X-API-KEY": "sk_spine_..."},
)
print(r.json()["data"]["status"])
const res = await fetch(`https://api.getspine.ai/v1/run/${runId}`, {
headers: { "X-API-KEY": "sk_spine_..." },
});
const { data } = await res.json();
console.log(data.status);
{
"success": true,
"data": {
"run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "running",
"canvas_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"progress": {
"tasks_completed": 123,
"tasks_total": 123,
"elapsed_ms": 123
},
"duration_ms": 123,
"result": {
"final_output": "<string>",
"artifacts": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "docx",
"name": "Q1_Report.docx",
"download_url": "<string>",
"size_bytes": 123
}
]
},
"metadata": {
"template_used": "auto",
"models_used": [
"anthropic/claude-sonnet-4-6"
],
"credits_consumed": 123
},
"errors": [
{
"error": "<string>"
}
]
}
}{
"success": false,
"error": "Invalid template: foo. Valid templates: app, auto, deep_research, excel, landing_page, memo, report, slides"
}{
"success": false,
"error": "X-API-KEY header required"
}{
"success": false,
"error": "Run not found: 550e8400-e29b-41d4-a716-446655440000"
}Get run status and results
Poll the current status of a run. Returns progress while running and
the full result (final output + downloadable artifacts + metadata)
once completed.
curl
curl https://api.getspine.ai/v1/run/<run_id> \
-H "X-API-KEY: sk_spine_..."
import requests
r = requests.get(
f"https://api.getspine.ai/v1/run/{run_id}",
headers={"X-API-KEY": "sk_spine_..."},
)
print(r.json()["data"]["status"])
const res = await fetch(`https://api.getspine.ai/v1/run/${runId}`, {
headers: { "X-API-KEY": "sk_spine_..." },
});
const { data } = await res.json();
console.log(data.status);
{
"success": true,
"data": {
"run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "running",
"canvas_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"progress": {
"tasks_completed": 123,
"tasks_total": 123,
"elapsed_ms": 123
},
"duration_ms": 123,
"result": {
"final_output": "<string>",
"artifacts": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "docx",
"name": "Q1_Report.docx",
"download_url": "<string>",
"size_bytes": 123
}
]
},
"metadata": {
"template_used": "auto",
"models_used": [
"anthropic/claude-sonnet-4-6"
],
"credits_consumed": 123
},
"errors": [
{
"error": "<string>"
}
]
}
}{
"success": false,
"error": "Invalid template: foo. Valid templates: app, auto, deep_research, excel, landing_page, memo, report, slides"
}{
"success": false,
"error": "X-API-KEY header required"
}{
"success": false,
"error": "Run not found: 550e8400-e29b-41d4-a716-446655440000"
}Authorizations
An API key from the Spine developer portal. Keys are prefixed with
sk_spine_ and shown only once at creation. Keep them server-side.
Path Parameters
The run identifier returned by POST /v1/run.