Documentation by ClonePartner

Start typing to search.

API Reference

Update a trigger

View Markdown
PUT /api/triggers/{id}

Partial update. one_off datetime rules are validated against the trigger's effective type (the stored type when type is omitted). Changing a one_off trigger's cron_expression resets last_triggered_at so the new datetime fires even after a server restart.

Operation IDupdateTrigger

Authentication

  • BearerAuth·http bearer·API key token (envoy_<hex>). Create keys from Settings → API Keys — see Using the API.

Path parameters

idintegerrequired

Resource ID

Request body

This request body is required.

Content typeapplication/json

requestobject
5 properties
task_keystring
typestring
Allowed values
cron, one_off
cron_expressionstring
argumentsobject

Additional properties are allowed.

enabledboolean

Success response body

200Trigger updated

Trigger updated

Content typeapplication/json

responseobject
10 properties
idinteger
job_idinteger
task_keystring | null
Nullable
yes
typestring

cron repeats on a cron expression; one_off fires once at the datetime in cron_expression then auto-disables.

Allowed values
cron, one_off
cron_expressionstring | null

5-field cron expression for type=cron; ISO-8601 datetime (UTC) for type=one_off.

Nullable
yes
argumentsstring | null

JSON-encoded arguments

Nullable
yes
enabledinteger
Allowed values
0, 1
last_triggered_atstring | null · date-time
Nullable
yes
created_atstring · date-time
updated_atstring · date-time

Error responses

404Resource not found

Resource not found

Content typeapplication/json

responseobject
2 properties
errorstring
Example
NOT_FOUND
messagestring
Example
Resource not found
Example response
{
  "error": "NOT_FOUND",
  "message": "Resource not found"
}