Publishing Workflows

A workflow is created with POST /workflows. Once created, it is stored in the platform database and can be run at any time.

POST /workflows
Authorization: Bearer <token>
Content-Type: application/json

{
  "name": "My Search Workflow",
  "description": "Fetches entries and runs a vector search",
  "type": "streaming",
  "isPublic": false,
  "nodes": [ ... ],
  "edges": [ ... ]
}

The response returns the created workflow, including its id and slug:

{
  "success": true,
  "data": {
    "id": 42,
    "slug": "my-search-workflow",
    "name": "My Search Workflow",
    "type": "streaming",
    ...
  }
}

Workflow Types

The type field determines which execution queue the workflow uses.

Type	Runnable	Description
`streaming`	Yes	Standard workflow — runs on the streaming worker queue
`preset`	Yes	A platform-managed preset workflow. Requires admin rights to create
`processing`	Not yet	Reserved for future use
`training`	Not yet	Reserved for future use

note

Only streaming and preset workflows can currently be executed. Attempting to run a processing or training workflow will enqueue it to a queue with no active workers.

Workflow Types​

Workflow Types