Skip to main content
GET
Get a script run
Key: Read Scope: Company

Authorizations

Authorization
string
header
required

Use your Primo API key in the Authorization header as Bearer <API_KEY>.

Path Parameters

runId
string
required

Response

default - application/json
id
string
required
script
object
required
target
object
required

The target as recorded, with group and device names resolved.

platforms
enum<string>[]
required
Available options:
macos,
windows,
linux
initiator
string | null
required

Who triggered the run — a user name, or the name of the API key that called this endpoint.

statusCounts
object
required

Number of executions in each status.

totalExecutions
number
required

Number of devices the run resolved to.

status
enum<string>
required

Overall state, derived from the executions: running while any is still pending.

Available options:
running,
success,
failed,
cancelled
createdAt
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
contents
string
required

Full source of the script as executed, kept even if the script later changes.