deliveries = client.webhooks.list_deliveries(status="failed", limit=20)
const deliveries = await client.webhooks.listDeliveries({ status: "failed", limit: 20 });
curl 'https://api.hydradb.com/webhooks/indexing/deliveries?status=failed&limit=20' \
-H "Authorization: Bearer $HYDRADB_API_KEY" \
-H "API-Version: 2"
{
"data": {
"count": 12,
"deliveries": [
{
"attempts": 1,
"created_at": "2026-07-02T10:00:00Z",
"delivery_id": "dlv_9f8e7d6c",
"doc_id": "HydraDoc1234",
"error_code": null,
"error_message": null,
"event_type": "indexing.status_changed",
"indexing_status": "completed",
"status": "completed",
"updated_at": "2026-07-02T10:00:05Z"
}
],
"next_cursor": null
},
"error": null,
"meta": {
"collection": "team_docs",
"database": "acme_corp",
"latency_ms": 12.3,
"request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
"source_type": "file",
"sub_tenant_id": "sub_tenant_4567",
"tenant_id": "tenant_1234",
"warnings": [
{
"code": "acl_ignored_by_connector_enforcement",
"message": "This connector enforces ACL, so the request's acl was ignored."
}
]
},
"success": true
}Webhooks
List Deliveries
List webhook deliveries for your organization.
GET
/
webhooks
/
indexing
/
deliveries
deliveries = client.webhooks.list_deliveries(status="failed", limit=20)
const deliveries = await client.webhooks.listDeliveries({ status: "failed", limit: 20 });
curl 'https://api.hydradb.com/webhooks/indexing/deliveries?status=failed&limit=20' \
-H "Authorization: Bearer $HYDRADB_API_KEY" \
-H "API-Version: 2"
{
"data": {
"count": 12,
"deliveries": [
{
"attempts": 1,
"created_at": "2026-07-02T10:00:00Z",
"delivery_id": "dlv_9f8e7d6c",
"doc_id": "HydraDoc1234",
"error_code": null,
"error_message": null,
"event_type": "indexing.status_changed",
"indexing_status": "completed",
"status": "completed",
"updated_at": "2026-07-02T10:00:05Z"
}
],
"next_cursor": null
},
"error": null,
"meta": {
"collection": "team_docs",
"database": "acme_corp",
"latency_ms": 12.3,
"request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
"source_type": "file",
"sub_tenant_id": "sub_tenant_4567",
"tenant_id": "tenant_1234",
"warnings": [
{
"code": "acl_ignored_by_connector_enforcement",
"message": "This connector enforces ACL, so the request's acl was ignored."
}
]
},
"success": true
}Returns the delivery history for your organization, most recent first. Use it to investigate events that never arrived, or that arrived more than once.
Filter by
Page through results with
deliveries = client.webhooks.list_deliveries(status="failed", limit=20)
const deliveries = await client.webhooks.listDeliveries({ status: "failed", limit: 20 });
curl 'https://api.hydradb.com/webhooks/indexing/deliveries?status=failed&limit=20' \
-H "Authorization: Bearer $HYDRADB_API_KEY" \
-H "API-Version: 2"
status to isolate failures:
| Status | Meaning |
|---|---|
pending | Recorded and waiting to be sent. |
sweeping | Claimed for delivery or retry. |
delivered | Your endpoint returned a 2xx. |
failed | An attempt failed and will be retried. |
permanently_failed | Retries are exhausted. No further attempts. |
limit and cursor. limit is 1 to 100 (default 20). To get the next page, pass the response’s next_cursor as cursor. next_cursor is null on the last page. A limit outside that range returns 422, and an unknown status returns 400.
See Webhooks for retry behavior.Authorizations
Send your API key as Authorization: Bearer <your_api_key>.
Query Parameters
Max deliveries to return
Pagination cursor
Filter by delivery status
Response
200 - application/json
OK
Show child attributes
Show child attributes
Example:
{
"count": 12,
"deliveries": [
{
"attempts": 1,
"created_at": "2026-07-02T10:00:00Z",
"delivery_id": "dlv_9f8e7d6c",
"doc_id": "HydraDoc1234",
"error_code": null,
"error_message": null,
"event_type": "indexing.status_changed",
"indexing_status": "completed",
"status": "completed",
"updated_at": "2026-07-02T10:00:05Z"
}
],
"next_cursor": null
}
Error details on failure, or null on success.
Show child attributes
Show child attributes
Example:
null
Show child attributes
Show child attributes
Example:
{
"collection": "team_docs",
"database": "acme_corp",
"latency_ms": 12.3,
"request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
"source_type": "file",
"sub_tenant_id": "sub_tenant_4567",
"tenant_id": "tenant_1234",
"warnings": [
{
"code": "acl_ignored_by_connector_enforcement",
"message": "This connector enforces ACL, so the request's acl was ignored."
}
]
}
Whether the request succeeded.
Example:
true
Was this page helpful?