Skip to main content
PATCH
Update event trigger

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id
string
required

The ID of the agent that owns the event trigger.

trigger_id
string
required

The ID of the event trigger to update.

Body

application/json

Fields to update on the event trigger. Only supplied fields change; omitted fields keep their current value. trigger_source is set at creation and cannot be changed — to switch providers, delete the trigger and create a new one.

enabled
boolean

Set to true to resume the trigger; false to pause it.

trigger_event
string

Updated event in "ResourceName:eventType" format. Omit to leave the current event unchanged.

Maximum string length: 255
name
string | null

Updated name. Pass null to clear.

Maximum string length: 255
description
string | null

Updated description. Pass null to clear.

Maximum string length: 1000
run_conditions
string | null

Updated run conditions. Pass null to clear.

Maximum string length: 3000
response_thread
enum<string> | null

Controls how the agent's response conversation is threaded when the trigger fires. create_new_thread_each_time starts a fresh thread for every event; when omitted, responses reuse a single thread.

Available options:
create_new_thread_each_time

Response

Updated event trigger

object
enum<string>
required

The object type, always 'event_trigger'.

Available options:
event_trigger
id
string
required

Unique identifier for the event trigger.

enabled
boolean
required

Whether the trigger is active. When false the agent does not run in response to the event until it is re-enabled.

trigger_source
enum<string>
required

The external provider that emits the event. Currently only Procore is supported.

Available options:
procore
trigger_event
string
required

The event that fires the agent, in "ResourceName:eventType" format (e.g. "Tasks:create", "Project Users:update").

name
string | null
required

User-provided name for the App Event automation.

description
string | null
required

User-provided description of what the App Event automation does.

run_conditions
string | null
required

Optional natural-language conditions that must hold for the agent to run when the event fires. When null, the agent runs on every matching event.

response_thread
enum<string> | null
required

Controls how the agent's response conversation is threaded when the trigger fires. create_new_thread_each_time starts a fresh thread for every event; when omitted, responses reuse a single thread.

Available options:
create_new_thread_each_time
created_at
string<date-time>
required

ISO 8601 timestamp of when the event trigger was created.

updated_at
string<date-time>
required

ISO 8601 timestamp of the last modification to the event trigger.

warnings
object[]
required

Non-fatal issues surfaced while wiring up the trigger (e.g. Procore company/project/credential prerequisite gaps). An empty array means the trigger was configured with no issues. Each entry pairs a stable machine-readable code with a human-readable message.