Skip to main content
Get an Actions placement and its cost and cleanup evidence

Authorizations

Authorization
string
header
required

BoxRouter API key; never an upstream provider key.

Path Parameters

placement_id
string
required

Workspace-owned BoxRouter placement ID.

Required string length: 1 - 128
Pattern: ^[^\u0000]*$

Response

Latest recorded placement state, actual assignment, billing and cleanup evidence.

id
string
required
Required string length: 1 - 128
Pattern: ^[^\u0000]*$
run_id
string
required
Required string length: 1 - 128
Pattern: ^[^\u0000]*$
job_id
string
required
Required string length: 1 - 128
Pattern: ^[^\u0000]*$
requested_job_id
string | null
required
Required string length: 1 - 128
Pattern: ^[^\u0000]*$
assigned_job_id
string | null
required
Required string length: 1 - 128
Pattern: ^[^\u0000]*$
provider
string | null
required
Required string length: 1 - 64
Pattern: ^[a-z][a-z0-9-]*$
sandbox_id
string | null
required
Required string length: 1 - 128
Pattern: ^[^\u0000]*$
state
enum<string>
required
Available options:
queued,
preparing,
starting,
running,
stopping,
ended,
attention_required
result
enum<string> | null
required
Available options:
success,
workload_failure,
cancelled,
timed_out,
infrastructure_failure,
skipped,
neutral,
unknown,
null
cleanup_state
enum<string>
required
Available options:
pending,
confirmed,
unknown
started_at
string<date-time> | null
required
ended_at
string<date-time> | null
required
billing
object
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
route_id
string | null

The route whose provider actually created this placement's sandbox. Explicit null means no actual allocation is bound yet (creation is unconfirmed); it is never an admission-selected placeholder. Bound placements carry the nonempty route ID unchanged.

Required string length: 1 - 128
Pattern: ^[^\u0000]*$

Optional same-origin Sandboxes page path.

Required string length: 1 - 2048
Pattern: ^/(?!/)[^\u0000]*$
region
string | null
Required string length: 1 - 128
size
object | null
supply
enum<string> | null
Available options:
byok,
managed,
null
sources
object
creation
object

Bounded public diagnostics of one creation: the effective fallback permission, why dispatching stopped, the ordered dispatched attempts (the successful one included) and, separately, the routes skipped before dispatch. All fields are optional and absent when unknown. Each list holds at most 64 entries and is always an ordered prefix of the full list. When entries were omitted, the matching *_truncated flag is true and the *_total count gives the full length, so omitted candidates are never read as not dispatched. The confirmed binding is reported separately on the sandbox or placement. Prior-refusal lists elsewhere keep their meaning.

lifetime_seconds
integer | null
Required range: x >= 1