Skip to content

Create Definition

POST
/api/v1/workflows/definitions

Create a new workflow definition.

Persists a workflow definition for the authenticated tenant. Requires the AUTOMATION_TEMPLATES feature gate.

Authorizations

Request Body required

Request body for creating a workflow definition.

Attributes: name: Display name for the workflow. description: Human-readable description. definition: Full WorkflowDefinition as a dict. layout: Optional visual builder layout metadata (node positions). category: Workflow category for filtering. icon: Icon identifier for UI display.

object
category
string
default: operations
definition
required
object
key
additional properties
any
description
string
""
icon
string
default: workflow
layout
Any of:
object
key
additional properties
any
name
required
string

Responses

201

Successful Response

object
key
additional properties
any

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string