Skip to main content
List launch runs

Authorizations

Authorization
string
header
required

BoxRouter API key; never an upstream provider key.

Query Parameters

limit
integer
default:20

Maximum number of runs in this page.

Required range: 1 <= x <= 50
cursor
string

Opaque next_cursor from the previous page of this workspace's list.

Required string length: 1 - 1024

Response

One page of run summaries with workspace-wide copy totals.

One newest-first page of run summaries. The totals cover every run in the authenticated workspace, not only this page. When available is false this deployment does not run copies: the page is empty, the totals are zero, and the other launch-run operations answer 409 capability_unavailable.

available
boolean
required

False when this deployment does not run launch-run copies; true otherwise.

runs
object[]
required
Maximum array length: 50
next_cursor
string | null
required

Opaque cursor for the next page; null on the last page.

Required string length: 1 - 1024
total_copies
integer
required

Copies requested across all of the workspace's runs.

Required range: x >= 0
live_copies
integer
required

Copies across all of the workspace's runs whose sandboxes have not been confirmed absent.

Required range: x >= 0