Create Trigger Api V1 Workstreams Blueprints Blueprint Id Triggers Post
post
/api/v1/workstreams/blueprints/{blueprint_id}/triggersdeprecatedCreate trigger for blueprint (deprecated)
Deprecated alias for `POST /workplans/{blueprint_id}/triggers`.
**Deprecated:** renamed to `/api/v1/workstreams/workplans/{blueprint_id}/triggers`. This `/blueprints/...` path still works but will be removed in a future release. Update integrations to use `workplans`.
Path parameters
blueprint_idrequiredpath | — |
Request bodyapplication/json
| Field | Type | Description |
|---|---|---|
namerequired | string | Trigger name |
typerequired | "time_based" | "event_based" | "manual" | Types of workflow triggers.time_basedevent_basedmanual |
config | object | Trigger configurationshow nestedEmpty object. |
is_active | boolean | Whether trigger is active |
Responses
201Successful Response
| Field | Type | Description |
|---|---|---|
idrequired | string (uuid) | Trigger UUID |
blueprint_idrequired | string (uuid) | Parent workplan UUID |
namerequired | string | Trigger name |
typerequired | "time_based" | "event_based" | "manual" | Types of workflow triggers.time_basedevent_basedmanual |
config | object | Trigger configurationshow nestedEmpty object. |
is_activerequired | boolean | Whether trigger is active |
last_fired_at | string (date-time) | null | Last trigger timestamp |
next_fire_at | string (date-time) | null | Next scheduled trigger |
created_atrequired | string (date-time) | Creation timestamp |
updated_atrequired | string (date-time) | Last update timestamp |
422Validation Error
| Field | Type | Description |
|---|---|---|
detail | ValidationError[] | —item shape |
curl https://api.dev.arch.ie/api/v1/workstreams/blueprints/<blueprint_id>/triggers \
-X POST \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{
"config": {
"cron": "0 9 1 * *",
"timezone": "America/New_York"
},
"is_active": true,
"name": "Monthly Run",
"type": "time_based"
}'