An approval was asked for: a reviewer's decision is waiting

POST

Parameters

Header Parameters

webhook-id

required

string

The event id; the same on every retry. Deduplicate on it.

webhook-timestamp

required

string

/^[0-9]+$/

Unix seconds when the request was signed. Reject requests far from your clock.

webhook-signature

required

string

v1,<base64 HMAC-SHA256 of "{webhook-id}.{webhook-timestamp}.{body}"> under the endpoint’s secret; space-separated when two secrets sign during a rotation.

Request Body^required

Media typeapplication/json

An approval was asked for: a reviewer’s decision is waiting. Sent once per approval (an escalation is a new approval). projectId in the endpoint’s filter narrows it to the approval’s project.

object

id

required

Event id, also sent as the webhook-id header; the same on every retry.

string

type

required

string

Allowed value: approval.requested

createdAt

required

string format: date-time

data

required

object

approval

required

The approval an approval.requested event names. What it is about stays behind sign-in: no context, no tool call or run input.

object

approvalId

required

string

projectId

string

requiredRole

required

The least reviewer role that may decide it.

string

Allowed values: standard senior admin

title

string

assignedTo

The one reviewer it is assigned to, when it is.

string

createdAt

required

string format: date-time

expiresAt

string format: date-time

url

Its page in the console, when the runtime knows its public address.

string

Responses

2XX

Received. Any other answer, or none within 10 seconds, is retried.