Workflow Versions

Create Workflow Version

Changed on

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

  • The document declares no server URL.
  • Auth
    • HTTP bearer
    • or API key in cookie __fabro_session

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

  • efc644ab09d4Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • 64a24779d395Revision changes
    • warning

      changed the pattern of the request property / from ^[0-9a-f]{64}$ to ^[0-9A-Fa-f]{64}$

    • info

      the response's property pattern was changed from ^[0-9a-f]{64}$ to ^[0-9A-Fa-f]{64}$ for the status