Skip to main content
POST
Submit a strategy version for a run

Authorizations

Authorization
string
header
required

Enter 'Bearer' followed by a space and then your JWT or API Key. Example: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... or Bearer YOUR_API_KEY_HERE

Path Parameters

strategyId
string<uuid>
required

UUID of the strategy.

Body

application/json

Parameters for submitting a strategy run.

as_of_date
string<date>

The as-of date for the run in YYYY-MM-DD format. When omitted or set to today in UTC, the run is live. A past date makes the run historical. Future dates are rejected with a 400.

version_id
string<uuid>

The version to run. Defaults to the version matching the strategy's current draft, creating that version if needed and promoting it to active.

force
boolean
default:false

Re-run even when a completed run already exists for this version and date.

create_factsheet
boolean
default:false

Whether to also request a factsheet for the resulting run.

priority
integer
default:5

Queue priority for scheduling historical runs, from 1 to 10.

Required range: 1 <= x <= 10

Response

The submission was accepted. Returns the submitted version and its run state. Poll GET /strategies/{strategyId}/versions/{versionId} to track progress.

A saved version of a strategy together with its run state. When no as_of_date is supplied, the response summarizes the version overall and populates latest_run_date and runs_count. When an as_of_date is supplied, the response describes the run on that date, echoes as_of_date, and leaves the summary-only fields null.

version_id
string<uuid>
required

Unique identifier for this version.

strategy_id
string<uuid>
required

Identifier of the strategy this version belongs to.

objective
string
required

The normalized objective captured for this version.

exclusions
string[]
required

The exclusion phrases captured for this version.

created_at
string<date-time>
required
is_active
boolean
required

Whether this version is the strategy's active version.

status
integer | null
required

Raw run status code. For example, 1 means pending, 100 means done, and a negative value means failed.

completed
boolean
required
has_factsheet
boolean
required
started_at
string<date-time> | null
completed_at
string<date-time> | null
as_of_date
string<date> | null

The run's as-of date, echoed when an as_of_date was supplied, otherwise null.

latest_run_date
string<date> | null

The version's latest completed run date, or null when an as_of_date was supplied.

runs_count
integer | null

Total number of runs for the version, or null when an as_of_date was supplied.