Workflows

Save the workflow draft

PUT
/workflows/{workflow_id}/draft

Store the working copy (draft definition) of a workflow without publishing. Returns non-blocking validation issues. Rejects stale expected_revision with 409.

Authorization

bearerApiKey
AuthorizationBearer <token>

Create a scoped API key in the Adlass settings.

In: header

Path Parameters

workflow_id*string

Resource identifier: workflow_id.

Formatuuid

Header Parameters

X-Request-Id?string

Optional correlation identifier.

Lengthlength <= 128
Idempotency-Key*string

A unique key for this intended write. Reuse it only for an identical retry.

Length1 <= length <= 200

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X PUT "https://example.com/workflows/123e4567-e89b-42d3-a456-426614174000/draft" \  -H "Idempotency-Key: 123e4567-e89b-42d3-a456-426614174000" \  -H "Content-Type: application/json" \  -d '{    "expected_revision": 0,    "draft": {}  }'
{  "workflow_id": "123e4567-e89b-42d3-a456-426614174000",  "draft_revision": 0,  "draft_updated_at": "2026-09-04T12:00:00Z",  "issues": []}