List webhook events

webhookEvents(projectReference: ID!, webhookId: ID!, input: WebhookEventsInput): WebhookEventPage!

Requires project.agents.read.

Arguments

ArgumentTypeRequiredDescription
projectReferenceID!YesProject UUID or slug.
webhookIdID!YesThe webhook id. A missing webhook fails with not_found.
inputWebhookEventsInputNo

Input fields

input

WebhookEventsInput

FieldTypeRequiredDescription
limitIntNoMaximum webhook events to return, 1 to 100; default 50.
cursorIDNoThe previous page's pageInfo.endCursor. Keep sortOrder the same across pages.
sortOrderWebhookSortOrderNoCreation order; default desc (newest first). Ties break by id ascending.

Response

Returns WebhookEventPage!. Open the type for its fields and nested types.

FieldType
data[WebhookEvent!]!
pageInfoPageInfo!

Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

graphql
query WebhookEvents($projectReference: ID!, $webhookId: ID!, $input: WebhookEventsInput) {
  webhookEvents(projectReference: $projectReference, webhookId: $webhookId, input: $input) {
    data {
      id
      projectId
      runId
      status
      createdAt
    }
    pageInfo {
      hasNextPage
      endCursor
      hasPreviousPage
      startCursor
    }
  }
}
json
{
  "projectReference": "00000000-0000-4000-8000-000000000001",
  "webhookId": "00000000-0000-4000-8000-000000000001"
}