Sign in
Workflow Versions

Create Workflow Version

Validates and stores an immutable workflow package in content-addressed storage. Repeating the same canonical content returns the same identifier. Requires an authenticated user or a worker token with the agent:run_tools capability. Ordinary worker tokens cannot register versions. Registration creates no run and starts no execution.

post/api/v1/workflow-versions

Request body

entrypointstring required

Canonical portable path inside one workflow version. Paths are UTF-8, relative, at most 240 bytes and 16 components, and cannot contain empty, dot, parent, backslash, control, tilde-root, or drive-letter segments. Map keys receive stricter byte and structural validation in the domain model than OpenAPI can express.

filesobject required

Workflow-local text files keyed by canonical path. Keys receive stricter domain validation than OpenAPI can express; each value is limited to 512 KiB of UTF-8 bytes.

workflow_dependenciesobject required

Exact stored workflow-version IDs keyed by resolved child-workflow path. Keys receive stricter domain validation than OpenAPI can express.

Example request

{
  "entrypoint": "graphs/main.fabro"
}

Response

Workflow version stored or already present

workflow_version_idstring required

SHA-256 identity of validated canonical workflow-version bytes. Hex input is case-insensitive; Fabro emits the canonical lowercase form.

Example response

{
  "workflow_version_id": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
}

Changes