Skip to content

Trigger operators

Public

The Trigger family contains 7 operators. Event sources that start a run.

Starts a run from a chat message.

Version 1.0.0 · Semantics trigger · Idempotent

FieldTypeRequiredDefaultDescription
system_promptstringno

No input ports.

PortTypeRequiredDescription
historyarraynoHistory
messagestringnoMessage

Starts a run on an external connector event.

Version 1.0.0 · Semantics trigger · Idempotent · Visibility advanced

FieldTypeRequiredDefaultDescription
connector_idstringyes
event_typestringyes

No input ports.

PortTypeRequiredDescription
eventanynoEvent

Starts a run from a submitted form.

Version 1.0.0 · Semantics trigger · Idempotent

FieldTypeRequiredDefaultDescription
fieldsobject[]no

No input ports.

PortTypeRequiredDescription
form_dataanynoForm Data

Starts a run when a user clicks Run.

Version 1.0.0 · Semantics trigger · Idempotent

No configuration.

No input ports.

PortTypeRequiredDescription
triggerobjectnoTrigger

Starts a run on a cron or interval schedule.

Version 1.0.0 · Semantics trigger · Idempotent

FieldTypeRequiredDefaultDescription
cronstringnoCron expression (e.g. ’*/5 * * * *’).
overlap_policy”skip” | “buffer_one” | “allow_all”no"skip"
timezonestringno"UTC"

No input ports.

PortTypeRequiredDescription
triggerobjectnoTrigger

Starts a run when an HTTP webhook is received.

Version 1.0.0 · Semantics trigger · Idempotent

FieldTypeRequiredDefaultDescription
method”POST” | “PUT”no"POST"
secretstringnoHMAC secret for signature validation.

No input ports.

PortTypeRequiredDescription
headersobjectnoHeaders
payloadanynoPayload

Starts a run when called by another workflow.

Version 1.0.0 · Semantics trigger · Idempotent · Visibility advanced

FieldTypeRequiredDefaultDescription
input_schemaobjectnoJSON Schema defining expected input.

No input ports.

PortTypeRequiredDescription
inputanynoInput

Every operator above is rendered from its JSON schema in /opt/glyph/schemas/operators/:

  • schemas/operators/trigger.chat.json
  • schemas/operators/trigger.connector.json
  • schemas/operators/trigger.form.json
  • schemas/operators/trigger.manual.json
  • schemas/operators/trigger.schedule.json
  • schemas/operators/trigger.webhook.json
  • schemas/operators/trigger.workflow.json