Appearance
Operations
Operations are the building blocks of Data Flows within Directus.
The Operation Object
id
uuid
Primary key of the operation.
name
string
Name for the operation.
key
string
Key for the operation. Must be unique within a given flow.
type
string
Type of operation. One of log
, mail
, notification
, create
, read
, request
, sleep
, transform
, trigger
, condition
, or any type of custom operation extensions.
options
json
Options depending on the type of the operation.
position_x
integer
Position of the operation on the X axis within the flow workspace.
position_y
integer
Position of the operation on the Y axis within the flow workspace.
date_created
timestamp
Timestamp in ISO8601 when the operation was created.
user_created
many-to-one
The user who created the operation. Many-to-one to users.
resolve
uuid
The operation triggered when the current operation succeeds (or then
logic of a condition operation). Primary key of an operation.
reject
uuid
The operation triggered when the current operation fails (or otherwise
logic of a condition operation). Primary key of an operation.
flow
many-to-one
The flow containing this operation. Many-to-one to flows.
json
{
"id": "585b04cd-2821-4dcc-a563-ae5d29ecace2",
"name": "Log a Message",
"key": "log_message",
"type": "log",
"position_x": 12,
"position_y": 24,
"date_created": "2022-05-11T13:14:52Z",
"user_created": "12e62fd0-29c7-4fd3-b3d3-c7a39933e8af",
"resolve": "bf4099c0-c54c-4736-ab4e-95e2487595e4",
"reject": null,
"flow": "22544db5-93f7-48e2-a028-7ae02c8fe49a"
}
List Operations
List all operations that exist in Directus.
Query Parameters
Supports all global query parameters.
Returns
An array of up to limit operation objects. If no items are available, data will be an empty array.
REST API
GET /operations
SEARCH /operations
GraphQL
POST /graphql/system
graphql
type Query {
operations: [directus_operations]
}
Example
graphql
query {
operations {
id
name
key
}
}
Retrieve an operation
List an existing operation by primary key.
Query Parameters
Supports all global query parameters.
Returns
Returns the requested operation object.
REST API
GET /operations/:id
Example
GET /operations/3c636d1c-4eb2-49cd-8a6d-3ec571ab3390
GraphQL
POST /graphql/system
graphql
type Query {
operations_by_id(id: ID!): directus_operations
}
Example
graphql
query {
operations_by_id(id: 42) {
id
name
key
}
}
Create an Operation
Create a new operation.
Query Parameters
Supports all global query parameters.
Request Body
A partial operation object.
Returns
Returns the operation object for the created operation.
REST API
POST /operations
Example
json
// POST /operations
{
"name": "My Log",
"key": "my_log",
"type": "log"
}
GraphQL
POST /graphql/system
graphql
type Mutation {
create_operations_item(data: create_directus_operations_input!): directus_operations
}
Example
graphql
mutation {
create_operations_item(data: { name: "My Log", key: "my_log", type: "log" }) {
id
name
key
}
}
Create Multiple Operations
Create multiple new operations.
Query Parameters
Supports all global query parameters.
Request Body
An array of partial operation objects.
Returns
Returns the operation object for the created operation.
REST API
POST /operations
Example
json
// POST /operations
[
{
"name": "My Log",
"key": "my_log",
"type": "log"
},
{
"name": "Send Notification",
"key": "send_notification",
"type": "notification"
}
]
GraphQL
POST /graphql/system
graphql
type Mutation {
create_operations_items(data: [create_directus_operations_input!]!): [directus_operations]
}
Example
graphql
mutation {
create_operations_items(
data: [
{
"name": "My Log",
"key": "my_log",
"type": "log"
},
{
"name": "Send Notification",
"key": "send_notification",
"type": "notification"
}
]
) {
id
name
key
}
}
Update an Operation
Update an existing operation.
Query Parameters
Supports all global query parameters.
Request Body
A partial operation object.
Returns
Returns the operation object for the updated operation.
REST API
PATCH /operation/:id
Example
json
// PATCH /operation/7d62f1e9-a83f-407b-84f8-1c184f014501
{
"name": "My Updated Operation"
}
GraphQL
POST /graphql/system
graphql
type Mutation {
update_operations_item(id: ID!, data: update_directus_operations_input): directus_operations
}
Example
graphql
mutation {
update_operations_item(id: "7d62f1e9-a83f-407b-84f8-1c184f014501", data: { name: "My Updated Operation" }) {
id
name
}
}
Update Multiple Operations
Update multiple existing operations.
Query Parameters
Supports all global query parameters.
Request Body
keys
Required
Array of primary keys of the operations you'd like to update.
data
Required
Any of the operation object's properties.
Returns
Returns the operation objects for the updated operations.
REST API
PATCH /operations
Example
json
// PATCH /operations
{
"keys": ["6a25fb7c-26a4-4dcb-a474-d47b6a203a38", "07ac467e-1900-4c62-9637-8dac2ab97f71"],
"data": {
"name": "Updated Operations"
}
}
GraphQL
POST /graphql/system
graphql
type Mutation {
update_operations_items(ids: [ID!]!, data: update_directus_operations_input): [directus_operations]
}
Example
graphql
mutation {
update_operations_items(
ids: ["6a25fb7c-26a4-4dcb-a474-d47b6a203a38", "07ac467e-1900-4c62-9637-8dac2ab97f71"]
data: { name: "Updated Operations" }
) {
id
name
key
}
}
Delete an Operation
Delete an existing operation.
Returns
Empty body.
REST API
DELETE /operations/:id
Example
DELETE /operations/07ac467e-1900-4c62-9637-8dac2ab97f71
GraphQL
POST /graphql/system
graphql
type Mutation {
delete_operations_item(id: ID!): delete_one
}
Example
graphql
mutation {
delete_operations_item(id: "07ac467e-1900-4c62-9637-8dac2ab97f71") {
id
}
}
Delete Multiple Operations
Delete multiple existing operations.
Request Body
An array of operations primary keys
Returns
Empty body.
REST API
DELETE /operations
Example
json
// DELETE /operations
["a791ce73-41a2-4fb7-8f67-c7ba176cc719", "4e57ab0e-f4ec-47b5-9dad-e36f08a25642", "5fe0a6f6-18ad-4bb3-94c6-2e033246c784"]
GraphQL
POST /graphql/system
graphql
type Mutation {
delete_operations_items(ids: [ID!]!): delete_many
}
Example
graphql
mutation {
delete_operations_items(
ids: [
"a791ce73-41a2-4fb7-8f67-c7ba176cc719"
"4e57ab0e-f4ec-47b5-9dad-e36f08a25642"
"5fe0a6f6-18ad-4bb3-94c6-2e033246c784"
]
) {
ids
}
}
Triggering an operation
Trigger an operation based on primary key.
Request Body
Payload for the operation, if needed.
Returns
Result of the operation, if any.
REST API
POST /operations/trigger/:operation_uuid
Example
json
// POST /flows/trigger/202a940b-a00b-47df-b832-369c53f13122
// Payload here