Clone a run's playbook to a new version

POST

/projects/:projectId/playbook-runs/:runId/clone-to-new-version

POST

/projects/:projectId/playbook-runs/:runId/clone-to-new-version

1 curl -X POST https:/https://api/projects/projectId/playbook-runs/runId/clone-to-new-version \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{}'

1 {
2   "id": "playbook_9f8b7c6d-1234-4a56-8e9f-0a1b2c3d4e5f",
3   "name": "Incident Response v2 (Draft)",
4   "version": "2.0.0-draft",
5   "status": "draft",
6   "createdAt": "2024-06-10T09:15:00Z",
7   "updatedAt": "2024-06-10T09:15:00Z",
8   "description": "Cloned draft version of the original Incident Response playbook to address snapshot drift.",
9   "steps": [
10     {
11       "id": "step_01",
12       "title": "Initial Assessment",
13       "description": "Evaluate the incident and gather initial information."
14     },
15     {
16       "id": "step_02",
17       "title": "Containment",
18       "description": "Isolate affected systems to prevent further damage."
19     }
20   ],
21   "metadata": {
22     "clonedFromRunId": "run_4a5b6c7d-89ef-0123-4567-89abcdef0123",
23     "clonedBy": "admin_user_42",
24     "cloneTimestamp": "2024-06-10T09:15:00Z"
25   }
26 }

Admin recovery from snapshot drift: clones the run’s source playbook into a new draft version.

Authentication

AuthorizationBearer

WorkOS session JWT or an organization API key, sent as Authorization: Bearer <token>.

Path parameters

projectIdstringRequired

runIdstringRequired

Response

The cloned draft playbook.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error