Skip to main content
POST
Fire a trigger now

Authorizations

Authorization
string
header
required

API key with the vk_ prefix. Create one from the dashboard.

Path Parameters

trigger_id
string
required

Trigger ID

Body

application/json
payload
any

Rendered into the prompt like a webhook body.

Response

The queued execution

object
string
required
id
string
required
trigger_id
string
required
kind
string
required

What fired it: cron | webhook | manual

status
string
required

pending | running | succeeded | failed | cancelled

created_at
string<date-time>
required
delivery_id
string | null

The provider's delivery id (webhook-id, X-GitHub-Delivery, X-Gitlab-Event-UUID); a second delivery with the same id is ignored.

session_id
string | null
failure_reason
string | null
payload_excerpt
string | null

The first 4 KiB of the webhook body.

result_excerpt
string | null

The first 2 KiB of the run's last agent message.

output_error
string | null

Set when the Slack output (or the session teardown) failed.

started_at
string<date-time> | null
finished_at
string<date-time> | null