Skip to main content
POST
/
v1
/
workflows
/
yaml
/
apply
from retab import Retab

client = Retab()

result = client.workflows.specs.apply(yaml_definition)

print(result.workflow_id)
print(result.created)

{
  "workflow_id": "wf_abc123",
  "created": false,
  "block_count": 2,
  "edge_count": 1,
  "diagnostics": {
    "issues": []
  },
  "operations": [
    {
      "action": "noop",
      "target": "workflow",
      "target_id": "wf_abc123",
      "summary": "No changes"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.retab.com/llms.txt

Use this file to discover all available pages before exploring further.

Apply a declarative workflow YAML spec to draft workflow state. apply() writes the canonical draft graph represented by the YAML spec. It does not publish. Call the workflow publish method separately when the draft is ready to become the live version. 
from retab import Retab

client = Retab()

result = client.workflows.specs.apply(yaml_definition)

print(result.workflow_id)
print(result.created)

{
  "workflow_id": "wf_abc123",
  "created": false,
  "block_count": 2,
  "edge_count": 1,
  "diagnostics": {
    "issues": []
  },
  "operations": [
    {
      "action": "noop",
      "target": "workflow",
      "target_id": "wf_abc123",
      "summary": "No changes"
    }
  ]
}

Authorizations

​
Api-Key
string
header
required

Query Parameters

​
access_token
string | null

Body

application/json
​
yaml_definition
string
required

Workflow YAML definition

Response

Successful Response

​
workflow_id
string
required
​
created
boolean
required
​
block_count
integer
required
​
edge_count
integer
required
​
diagnostics
Diagnostics · object
required
​
operations
DeclarativePlanOperation · object[]
required