Skip to content
On this page

Flows

Flows enable custom, event-driven data processing and task automation within Directus.

The Flow Object

id uuid
Primary key of the flow.

name string
Name for the flow.

icon string
Icon displayed in the Admin App for the flow.

color string
Color of the icon displayed in the Admin App for the flow.

note text
Short description displayed in the Admin App.

status string
Current status of the flow. One of active, inactive. Defaults to active when not specified.

trigger string
Type of trigger for the flow. One of hook, webhook, operation, schedule, manual.

options json
Options of the selected trigger for the flow.

accountability string
The permission used during the flow. One of $public, $trigger, $full, or UUID of a role.

date_created timestamp
Timestamp in ISO8601 when the flow was created.

user_created many-to-one
The user who created the flow. Many-to-one to users.

operation string
UUID of the operation connected to the trigger in the flow.

json
{
	"id": "2fab3b9d-0543-4b87-8a30-3c5ee66fedf1",
	"name": "My Flow",
	"icon": "bolt",
	"color": "#112233",
	"note": "Note for my flow",
	"status": "active",
	"trigger": "manual",
	"accountability": "$trigger",
	"date_created": "2022-05-11T13:14:52Z",
	"user_created": "12e62fd0-29c7-4fd3-b3d3-c7a39933e8af",
	"operation": "92e82998-e421-412f-a513-13701e83e4ce"
}
{
	"id": "2fab3b9d-0543-4b87-8a30-3c5ee66fedf1",
	"name": "My Flow",
	"icon": "bolt",
	"color": "#112233",
	"note": "Note for my flow",
	"status": "active",
	"trigger": "manual",
	"accountability": "$trigger",
	"date_created": "2022-05-11T13:14:52Z",
	"user_created": "12e62fd0-29c7-4fd3-b3d3-c7a39933e8af",
	"operation": "92e82998-e421-412f-a513-13701e83e4ce"
}

List Flows

List all flows that exist in Directus.

Request

API

Learn more about SEARCH ->

Query Parameters

Supports all global query parameters.

Response

An array of up to limit flow objects. If no items are available, data will be an empty array.

Example

API

Retrieve a flow

List an existing flow by primary key.

Request

API

Query Parameters

Supports all global query parameters.

Response

Returns the requested flow object.

Example

API

Create a Flow

Create a new flow.

Request

API

Query Parameters

Supports all global query parameters.

Request Body

A partial flow object.

Response

Returns the flow object for the created flow.

Example

API

Create Multiple Flows

Create multiple new flows.

Request

API

Query Parameters

Supports all global query parameters.

Request Body

An array of partial flow objects.

Response

Returns the flow object for the created flow.

Example

API

Update a Flow

Update an existing flow.

Request

API

Query Parameters

Supports all global query parameters.

Request Body

A partial flow object.

Response

Returns the flow object for the updated flow.

Example

API

Update Multiple Flows

Update multiple existing flows.

Request

API

Query Parameters

Supports all global query parameters.

Request Body

keys Required
Array of primary keys of the flows you'd like to update.

data Required
Any of the flow object's properties.

Response

Returns the flow objects for the updated flows.

Example

API

Delete a Flow

Delete an existing flow.

Request

API

Response

Empty body.

Example

API

Delete Multiple Flows

Delete multiple existing flows.

Request

API

Request Body

An array of flows primary keys

Response

Empty body.

Example

API

Flow with GET webhook trigger

Start a flow with GET webhook trigger.

Request

API

Response

Result of the flow, if any.

Example

API

Flow with POST webhook trigger

Start a flow with POST webhook trigger.

Request

API

Request Body

Payload for the POST request.

Response

Result of the flow, if any.

Example

API