---
title: "Query webhooks"
method: POST
path: "/v2/webhooks/query"
tags: ["Webhooks"]
deprecated: true
---

# Query webhooks

`POST /v2/webhooks/query`

> **Deprecated.**

**Deprecated.** Returns webhooks matching legacy query filters. Use `GET /v2/webhooks` for pagination, search, event filtering, and sorting.

## Request body

- QueryWebhooksRequest
  - `pagination` QueryParamsPagination
    - `page` integer
    - `limit` integer
    - `lastId` string
    - `firstId` string
  - `sortingProps` QueryParamsSort[]
    - `key` string
    - `direction` string
  - `query` object
  - `filters` object[]
  - `includedFields` object

## Response `200`

OK

- QueryWebhooksResponse
  - `count` integer, required
  - `items` Webhook[], required
    - `_id` string, required — Unique webhook ID.
    - `url` string, uri, required — HTTPS endpoint that receives webhook deliveries.
    - `content_type` 'application/json' | 'application/x-www-form-urlencoded', required — Content type sent with webhook deliveries.
    - `display_name` string, required — Human-readable webhook name.
    - `events` string[], required — Workspace event slugs that trigger a delivery, for example `deployment.invoked` or `llm.response`.
    - `secret` string, required — Signing secret used to compute `X-Orq-Signature` as the lowercase hexadecimal HMAC-SHA256 of the exact request body bytes. Treat this value as sensitive.
    - `enabled` boolean — Whether webhook deliveries are enabled.
    - `failure_count` integer — Server-managed number of consecutive delivery failures.
    - `created_by_id` string, required — Account ID that created the webhook.
    - `updated_by_id` string, required — Account ID that most recently updated the webhook.
    - `created` string, date-time, required — Creation time in RFC 3339 format.
    - `updated` string, date-time, required — Most recent update time in RFC 3339 format.

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/versions/1072e5ba28ab/schema)