Runs and evidence | TaloTrace Documentation

`start_run`

Start a run and return at once with a run id, a cursor and a link to watch it.

Annotations: can change or delete data.

Argument	Type	Required	What it is
`app_id`	`string`	yes
`target`	`WebRunTarget \| MobileRunTarget \| LiveMobileRunTarget`	yes
`selection`	`ScenarioSelection \| SuiteSelection \| GoalSelection \| IssueSelection`	yes
`max_credits`	`number \| string \| null`	no
`request_id`	`string`	yes
`preview`	`boolean`	no
`source_run_id`	`string \| null`	no
`source_issue_id`	`string \| null`	no
`project_id`	`string`	yes	The project the call is about.

Follow a run by cursor; wait_seconds holds the call open for news.

Annotations: changes data, never deletes.

Argument	Type	Required	What it is
`run_id`	`string`	yes
`cursor`	`string \| null`	no
`limit`	`integer`	no
`wait_seconds`	`integer`	no
`project_id`	`string`	yes	The project the call is about.

Cancel a run.

Annotations: can change or delete data.

Argument	Type	Required	What it is
`run_id`	`string`	yes
`project_id`	`string`	yes	The project the call is about.

Read one page of a run’s steps, requests, console lines or snapshots.

Annotations: reads only.

Argument	Type	Required	What it is
`run_id`	`string`	yes
`ref`	`string \| null`	no
`filter`	`EvidenceFilter`	no
`cursor`	`string \| null`	no
`limit`	`integer`	no
`project_id`	`string`	yes	The project the call is about.

Show what a rerun changed against an earlier run.

Annotations: reads only.

Argument	Type	Required	What it is
`baseline_run_id`	`string`	yes
`candidate_run_id`	`string`	yes
`cursor`	`string \| null`	no
`project_id`	`string`	yes	The project the call is about.