Skip to main content
WEBHOOK
ai_task_run.needs_input
{
  "id": "whev_abc123",
  "type": "ai_task_run.needs_input",
  "created_at": "2025-01-15T10:30:00Z",
  "api_version": "v1",
  "data": {
    "id": "atrun_abc123",
    "task_id": "aitask_abc123",
    "task_name": "Weekly revenue digest",
    "status": "needs_input",
    "summary": "Generated and emailed the weekly revenue digest.",
    "input_tokens": 12500,
    "output_tokens": 3200,
    "credits_consumed": 15,
    "tool_calls_count": 4,
    "started_at": "2025-01-15T10:30:00Z",
    "created_at": "2025-01-15T10:30:00Z"
  }
}

Headers

​
X-Crevio-Hmac-SHA256
string
required

Base64-encoded HMAC-SHA256 of the raw request body, keyed with your endpoint's signing secret. Verify this before processing the event.

Body

application/json

Event payload Crevio POSTs to your endpoint.

​
id
string
required

Unique identifier for this webhook event

Example:

"whev_abc123"

​
type
enum<string>
required

The event type

Available options:
ai_task_run.needs_input
Example:

"ai_task_run.needs_input"

​
created_at
string<date-time>
required

ISO 8601 timestamp of when the event was created

Example:

"2025-01-15T10:30:00Z"

​
api_version
string
required

API version used to generate the payload

Example:

"v1"

​
data
object
required

The serialized ai task run for this event

Response

200

Return any 2xx status within 5 seconds to acknowledge receipt.