Retry a failed or permanently failed delivery
import requests
url = "https://api.hydradb.com/webhooks/indexing/deliveries/{delivery_id}/retry"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.hydradb.com/webhooks/indexing/deliveries/{delivery_id}/retry', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request POST \
--url https://api.hydradb.com/webhooks/indexing/deliveries/{delivery_id}/retry \
--header 'Authorization: Bearer <token>'{
"data": {
"delivery_id": "dlv_9f8e7d6c",
"message": "Success",
"queued": true
},
"error": {
"code": "DATABASE_NOT_FOUND",
"message": "Database not found"
},
"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"
},
"success": true
}{
"data": "<unknown>",
"detail": {
"deprecated": true,
"deprecated_field": "tenant_id",
"error_code": "VALIDATION_ERROR",
"message": "Request validation failed",
"preferred_field": "database"
},
"error": {
"code": "DATABASE_NOT_FOUND",
"message": "Database not found"
},
"meta": {
"latency_ms": 12.3,
"request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d"
},
"success": true
}Webhooks
Retry Delivery
Queue a failed webhook delivery to be attempted again.
POST
/
webhooks
/
indexing
/
deliveries
/
{delivery_id}
/
retry
Retry a failed or permanently failed delivery
import requests
url = "https://api.hydradb.com/webhooks/indexing/deliveries/{delivery_id}/retry"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.hydradb.com/webhooks/indexing/deliveries/{delivery_id}/retry', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request POST \
--url https://api.hydradb.com/webhooks/indexing/deliveries/{delivery_id}/retry \
--header 'Authorization: Bearer <token>'{
"data": {
"delivery_id": "dlv_9f8e7d6c",
"message": "Success",
"queued": true
},
"error": {
"code": "DATABASE_NOT_FOUND",
"message": "Database not found"
},
"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"
},
"success": true
}{
"data": "<unknown>",
"detail": {
"deprecated": true,
"deprecated_field": "tenant_id",
"error_code": "VALIDATION_ERROR",
"message": "Request validation failed",
"preferred_field": "database"
},
"error": {
"code": "DATABASE_NOT_FOUND",
"message": "Database not found"
},
"meta": {
"latency_ms": 12.3,
"request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d"
},
"success": true
}Queues a failed delivery for another attempt. Use it after fixing the problem on your side, such as a receiver that was down or was rejecting valid signatures.
The retry is signed with your current signing secret, not the one in force when the delivery was first attempted. If you have rotated since, your receiver must know the new secret.
See Webhooks for retry and backoff behaviour.
Authorizations
API key sent as a Bearer token: "Bearer prefix.secret"
Path Parameters
Delivery ID
Example:
"dlv_9f8e7d6c"
Response
OK
Show child attributes
Show child attributes
Example:
{
"delivery_id": "dlv_9f8e7d6c",
"message": "Success",
"queued": true
}
Error message, empty string on success.
Show child attributes
Show child attributes
Example:
{
"code": "DATABASE_NOT_FOUND",
"message": "Database not found"
}
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"
}
Whether the request succeeded.
Example:
true
Was this page helpful?
