Resource
workflow_trigger
A trigger configuration for automated workflow execution
Configuration
workflowIdWorkflowID!RequiredSet on creationTypeID (prefix wfl) of the workflow this trigger starts when it fires.
References workflow
set once, at creation
versionIdWorkflowVersionIDOptionalSet on creationOptional TypeID (prefix wfv) pinning the trigger to one workflow version. Omit to always run the workflow's current version.
References workflow_version
set once, at creation
nameString!RequiredHuman-readable name for the trigger. Must pass the standard name validation.
configTriggerConfig!RequiredType-tagged configuration determining what makes this trigger fire.
isEnabledBoolean!OptionalWhether the trigger starts out armed. Defaults to true when omitted; a disabled trigger is stored but never fires.
concurrencyPolicyConcurrencyPolicy!OptionalHow firings are handled while an execution from this trigger is still running. A ConcurrencyPolicy name — ALLOW, QUEUE, SKIP or CANCEL (case-sensitive); defaults to ALLOW when omitted. folderWatch triggers must use ALLOW.
Allowed values
ALLOW — Allow multiple concurrent executions
QUEUE — Queue new executions if one is running
SKIP — Skip new executions if one is running
CANCEL — Cancel running execution and start new one
maxConcurrentExecutionsIntOptionalCap on simultaneously running executions from this trigger. Must be at least 1. Omit for unlimited; folderWatch triggers must leave it unset.
Input types
Fields for the structured values used in this resource’s configuration.
TriggerConfigInput
Trigger configuration: a GraphQL oneOf input, so set exactly one member and omit the rest — the member you set is what selects the kind of trigger. There is no discriminator field to set alongside it. Stands in for the not-yet-modelled TriggerConfig GraphQL union.
Set exactly one field to a non-null value.
scheduledScheduledTriggerConfigInputOptionalCRON schedule configuration. Set this member and no other.
eventEventTriggerConfigInputOptionalPlatform-event configuration. Set this member and no other.
deviceMqttDeviceMQTTTriggerConfigInputOptionalDevice MQTT configuration. Set this member and no other.
webhookWebhookTriggerConfigInputOptionalWebhook configuration. Set this member and no other.
edgeAppEventEdgeAppEventTriggerConfigInputOptionalEdge app event configuration. Set this member and no other.
folderWatchFolderWatchTriggerConfigInputOptionalFolder-watch configuration. Set this member and no other.
ScheduledTriggerConfigInput
Scheduled (CRON) trigger configuration. Set as TriggerConfigInput's single member to make this kind of trigger.
cronExpressionString!RequiredCRON expression driving the schedule. Must be non-empty and have 5 or 6 whitespace-separated fields (minute hour day month weekday [year]).
timezoneStringOptionalIANA timezone name the CRON expression is evaluated in (e.g. "Europe/Berlin"). Omit to evaluate in the scheduler's default timezone.
overlapPolicyOverlapPolicy!RequiredWhat to do when the schedule fires while a previous execution is still running. Must be an OverlapPolicy name — ALLOW, SKIP or CANCEL (case-sensitive); any other value is rejected as a validation error.
Allowed values
ALLOW — Allow overlapping CRON executions
SKIP — Skip if previous execution still running
CANCEL — Cancel previous and start new
EventTriggerConfigInput
Event-based trigger configuration. Set as TriggerConfigInput's single member to make this kind of trigger.
topicString!RequiredPlatform event topic to subscribe to. Must be non-empty.
filterStringOptionalOptional JSONLogic expression evaluated against the event payload; the workflow only starts when it evaluates truthy. Omit to fire on every event on the topic.
dataQueryStringOptionalOptional GraphQL query executed when the event fires. The event's resource ID is bound to the $id variable and the result is merged into the workflow input under the 'data' key. Validated against the live schema on save; an unparseable query is rejected.
DeviceMQTTTriggerConfigInput
Device MQTT trigger configuration. Set as TriggerConfigInput's single member to make this kind of trigger.
topicString!RequiredDevice-relative MQTT topic filter (MQTT + and # wildcards allowed). Must be non-empty and must NOT include the tenant/device prefix — a value starting with "t/" is rejected.
deviceIdStringOptionalOptional device TypeID (prefix dev) narrowing the trigger to one device. Omit (or pass empty) to match every device in the tenant.
filterStringOptionalOptional JSONLogic expression evaluated against the MQTT trigger envelope; the workflow only starts when it evaluates truthy.
WebhookTriggerConfigInput
Webhook trigger configuration. Set as TriggerConfigInput's single member to make this kind of trigger.
pathString!RequiredURL path the webhook is exposed on. Must be non-empty and start with "/".
methodString!RequiredHTTP method the webhook accepts. Must be one of GET, POST, PUT, PATCH or DELETE (compared case-insensitively).
authRequiredBoolean!RequiredWhether callers must authenticate. When false the webhook endpoint is reachable without credentials.
EdgeAppEventTriggerConfigInput
edgeApp.event trigger configuration — fires when an edge app replays a bridge.publish event through its outbox. Every supplied scope must match for the trigger to fire. Set as TriggerConfigInput's single member to make this kind of trigger.
controllerIdStringOptionalOptional controller TypeID (prefix ctl) to scope on; the event's controller must match exactly. Omit (or pass empty) to match any controller in the tenant.
edgeAppHandleStringOptionalOptional edge app wire handle to scope on; matched exactly against the emitting edge app. Omit (or pass empty) to match any edge app.
topicStringOptionalOptional bridge.publish topic to scope on; matched exactly (no wildcards). Omit (or pass empty) to match any topic.
FolderWatchTriggerConfigInput
Folder-watch trigger configuration. Set as TriggerConfigInput's single member to make this kind of trigger.
folderIdFolderID!RequiredTypeID (prefix fld) of the folder to watch. Must parse as a folder ID.
prefixString!RequiredFolder-relative prefix watched for new files. The watch is shallow — files in subdirectories below the prefix are never picked up. Must not contain '..' segments.
Read-only values
Show values
idWorkflowTriggerID!Read onlyUnique identifier
computed by the platform
tenantIdTenantID!Read onlyTenant ID
computed by the platform
createdAtString!Read onlyCreation timestamp (ISO8601)
computed by the platform
updatedAtString!Read onlyLast update timestamp (ISO8601)
computed by the platform
Lifecycle
The CLI can create this resource. The platform assigns its id.
When replacement is needed, the existing resource is removed before its replacement is created.