Create a per-task push-notification config
PreviewManage execution sessions and rooms, and their files, tasks, storage, databases and managed sandboxes.
/v1/sessions/{session_id}/tasks/{task_id}/push-configsSee authentication for credentials and permissions.
Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Session ID
Task ID
Request Bodyrequired
Section titled “Request Bodyrequired”Request body for creating a per-task push config.
object
Events that trigger delivery. Defaults to ["terminal"].
Optional HMAC-SHA256 signing secret (never returned once set).
Example
whsec_example_signing_secret_placeholderURL to POST task events to.
Example
https://hooks.example.com/everruns/tasksResponses
200Created push config
Created push config
Public view of a per-task push config. The stored secret is NEVER returned —
only has_secret signals whether one is configured.
object
When the config was created (RFC 3339).
Events that trigger delivery (terminal, awaiting_input, message).
Whether a signing secret is configured (the secret itself is never returned).
Public identifier (tpc_<32-hex-chars>).
When the config was last updated (RFC 3339).
Target URL that receives POST deliveries.
Example
{ "created_at": "2026-07-11T00:00:00Z", "has_secret": true, "id": "tpc_9f8c2b1a4e7d4c3b8a1f2e3d4c5b6a7f", "updated_at": "2026-07-11T00:00:00Z", "url": "https://hooks.example.com/everruns/tasks"}400Invalid request (bad URL or event_filter)
Invalid request (bad URL or event_filter)
404Session or task not found
Session or task not found