SWIRLS_
ReferenceSDKClient

playbooks

SDK reference for playbooks —

run

Create a PlaybookRun for a test deployment. The CLI drives case execution and updates the run via playbooks.updateRun.

POST

Usage:

const result = await swirls.client.playbooks.run({
  projectId: '...',
  deploymentId: '...',
  playbookName: '...',
})

Input:

ParameterTypeRequiredDescription
projectIdstringYes
deploymentIdstringYes
playbookNamestringYes
mode"synthetic"No
casesobject[]No

Output:

FieldTypeDescription
idstring
projectIdstring
deploymentIdstring
playbookNamestring
sourcestring
modestring
verdict"passed" | "scored" | "failed" | "skipped" | null
startedAtunknown
finishedAtunknown | null
summaryobject | null
casesobject[]
artifactUristring | null
createdAtunknown
orgIdstring
userIdstring

getRun

Get a PlaybookRun by id

GET

Usage:

const result = await swirls.client.playbooks.getRun({
  id: '...',
})

Input:

ParameterTypeRequiredDescription
idstringYes

Output:

FieldTypeDescription
idstring
projectIdstring
deploymentIdstring
playbookNamestring
sourcestring
modestring
verdict"passed" | "scored" | "failed" | "skipped" | null
startedAtunknown
finishedAtunknown | null
summaryobject | null
casesobject[]
artifactUristring | null
createdAtunknown
orgIdstring
userIdstring

listRuns

List PlaybookRuns for a project, newest first

GET

Usage:

const result = await swirls.client.playbooks.listRuns({
  projectId: '...',
})

Input:

ParameterTypeRequiredDescription
projectIdstringYes
paginationobjectNo

Output:

FieldTypeDescription
paginationobject
resultsobject[]
totalCountnumber

updateRun

Update PlaybookRun verdict, summary, cases, and completion metadata (used by the test runner)

POST

Usage:

const result = await swirls.client.playbooks.updateRun({
  id: '...',
})

Input:

ParameterTypeRequiredDescription
idstringYes
verdict"passed" | "scored" | "failed" | "skipped"No
summaryobjectNo
casesobject[]No
finishedAtunknownNo
artifactUristring | nullNo

Output:

FieldTypeDescription
idstring
projectIdstring
deploymentIdstring
playbookNamestring
sourcestring
modestring
verdict"passed" | "scored" | "failed" | "skipped" | null
startedAtunknown
finishedAtunknown | null
summaryobject | null
casesobject[]
artifactUristring | null
createdAtunknown
orgIdstring
userIdstring

On this page