delivery = client.webhooks.get_delivery("{delivery_id}")
const delivery = await client.webhooks.getDelivery({ deliveryId: "{delivery_id}" });
curl 'https://api.hydradb.com/webhooks/indexing/deliveries/{delivery_id}' \
-H "Authorization: Bearer $HYDRADB_API_KEY" \
-H "API-Version: 2"
{
"data": {
"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"
},
"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
}{
"data": null,
"detail": {
"deprecated": true,
"deprecated_field": "tenant_id",
"deprecated_since": "2.0.1",
"error_code": "VALIDATION_ERROR",
"message": "Request validation failed",
"preferred_field": "database",
"retry_after_seconds": 1,
"retryable": true
},
"error": {
"code": "DATABASE_NOT_FOUND",
"message": "Database not found"
},
"meta": {
"latency_ms": 12.3,
"request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d"
},
"success": false
}Webhooks
Get Delivery
Read one webhook delivery by ID.
GET
/
webhooks
/
indexing
/
deliveries
/
{delivery_id}
delivery = client.webhooks.get_delivery("{delivery_id}")
const delivery = await client.webhooks.getDelivery({ deliveryId: "{delivery_id}" });
curl 'https://api.hydradb.com/webhooks/indexing/deliveries/{delivery_id}' \
-H "Authorization: Bearer $HYDRADB_API_KEY" \
-H "API-Version: 2"
{
"data": {
"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"
},
"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
}{
"data": null,
"detail": {
"deprecated": true,
"deprecated_field": "tenant_id",
"deprecated_since": "2.0.1",
"error_code": "VALIDATION_ERROR",
"message": "Request validation failed",
"preferred_field": "database",
"retry_after_seconds": 1,
"retryable": true
},
"error": {
"code": "DATABASE_NOT_FOUND",
"message": "Database not found"
},
"meta": {
"latency_ms": 12.3,
"request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d"
},
"success": false
}Returns one delivery, including its current status, attempt count, and the last error code and message when an attempt failed.
The
delivery = client.webhooks.get_delivery("{delivery_id}")
const delivery = await client.webhooks.getDelivery({ deliveryId: "{delivery_id}" });
curl 'https://api.hydradb.com/webhooks/indexing/deliveries/{delivery_id}' \
-H "Authorization: Bearer $HYDRADB_API_KEY" \
-H "API-Version: 2"
delivery_id is the value sent in the X-HydraDB-Delivery-ID header of the delivery itself, so you can look up any request your endpoint received. See Webhooks.Authorizations
Send your API key as Authorization: Bearer <your_api_key>.
Path Parameters
Delivery ID
Example:
"dlv_9f8e7d6c"
Response
OK
Show child attributes
Show child attributes
Example:
{
"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"
}
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?