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:
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | |
deploymentId | string | Yes | |
playbookName | string | Yes | |
mode | "synthetic" | No | |
cases | object[] | No |
Output:
| Field | Type | Description |
|---|---|---|
id | string | |
projectId | string | |
deploymentId | string | |
playbookName | string | |
source | string | |
mode | string | |
verdict | "passed" | "scored" | "failed" | "skipped" | null | |
startedAt | unknown | |
finishedAt | unknown | null | |
summary | object | null | |
cases | object[] | |
artifactUri | string | null | |
createdAt | unknown | |
orgId | string | |
userId | string |
getRun
Get a PlaybookRun by id
GET
Usage:
const result = await swirls.client.playbooks.getRun({
id: '...',
})Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes |
Output:
| Field | Type | Description |
|---|---|---|
id | string | |
projectId | string | |
deploymentId | string | |
playbookName | string | |
source | string | |
mode | string | |
verdict | "passed" | "scored" | "failed" | "skipped" | null | |
startedAt | unknown | |
finishedAt | unknown | null | |
summary | object | null | |
cases | object[] | |
artifactUri | string | null | |
createdAt | unknown | |
orgId | string | |
userId | string |
listRuns
List PlaybookRuns for a project, newest first
GET
Usage:
const result = await swirls.client.playbooks.listRuns({
projectId: '...',
})Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | |
pagination | object | No |
Output:
| Field | Type | Description |
|---|---|---|
pagination | object | |
results | object[] | |
totalCount | number |
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:
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
verdict | "passed" | "scored" | "failed" | "skipped" | No | |
summary | object | No | |
cases | object[] | No | |
finishedAt | unknown | No | |
artifactUri | string | null | No |
Output:
| Field | Type | Description |
|---|---|---|
id | string | |
projectId | string | |
deploymentId | string | |
playbookName | string | |
source | string | |
mode | string | |
verdict | "passed" | "scored" | "failed" | "skipped" | null | |
startedAt | unknown | |
finishedAt | unknown | null | |
summary | object | null | |
cases | object[] | |
artifactUri | string | null | |
createdAt | unknown | |
orgId | string | |
userId | string |