v12

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-014994227.2 KB
workflows

Save workflow code

Persists a new revision of the workflow's code. Hash-deduplicates against the current revision (no-op if unchanged). Source is capped at 256KB.

post/workflows/{workflow_id}/code

Path parameters

workflow_idstring uuid required

workflow identifier

workflow identifier

Request body

$schemastring uri

A URL to the JSON Schema for this object.

messagestring

Optional commit-style note.

sourcestring required

Python source the user typed.

Example request

{
  "$schema": "/api/v1/WorkflowSaveCodeRequest.json"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

no_opboolean required

True when the submitted source's sha256 matched the prior current revision; no new row was inserted, no pointer was changed.

revisioninteger required

Per-workflow monotonic revision number.

revision_idstring required

Workflow_revisions.id of the active revision after the save.

Example response

{
  "$schema": "/api/v1/WorkflowSaveCodeResponse.json"
}