Parcourir la référence

Webhooks

8 endpoints · Les descriptions des points de terminaison sont en anglais.

List webhook subscriptions for this household (no secrets)

GET/households/{householdId}/webhooks/subscriptions

read:webhooks

Exemple de requête

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/households/current/webhooks/subscriptions

Réponse200 · Success

Register an outbound webhook subscription. Secret returned ONCE in the response.

POST/households/{householdId}/webhooks/subscriptions

write:webhooks

Corps de la requête

json

{  "url": "https://example.com/hooks/vokse",  "eventTypes": [    "transaction.created",    "budget.overrun"  ]}

Exemple de requête

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Content-Type: application/json" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/webhooks/subscriptions \     -d '{"url":"https://example.com/hooks/vokse","eventTypes":["transaction.created","budget.overrun"]}'

Réponse201 · Success

Update url / eventTypes / status of a subscription

PATCH/households/{householdId}/webhooks/subscriptions/{id}

write:webhooks

Paramètres

Nom	Emplacement	Requis
id	path	Requis

Corps de la requête

json

{  "eventTypes": [    "transaction.created"  ]}

Exemple de requête

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Content-Type: application/json" \     -H "Idempotency-Key: $(uuidgen)" \     -X PATCH https://api.vokse.ai/households/current/webhooks/subscriptions/{id} \     -d '{"eventTypes":["transaction.created"]}'

Réponse200 · Success

Delete a webhook subscription + every associated delivery

DELETE/households/{householdId}/webhooks/subscriptions/{id}

write:webhooks

Paramètres

Nom	Emplacement	Requis
id	path	Requis

Exemple de requête

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -X DELETE https://api.vokse.ai/households/current/webhooks/subscriptions/{id}

Réponse204 · No content

Recent delivery log for this subscription

GET/households/{householdId}/webhooks/subscriptions/{id}/deliveries

read:webhooks

Paramètres

Nom	Emplacement	Requis
id	path	Requis
limit	query	Requis

Exemple de requête

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/households/current/webhooks/subscriptions/{id}/deliveries

Réponse200 · Success

Queue a past delivery again with its original payload

POST/households/{householdId}/webhooks/subscriptions/{id}/deliveries/{deliveryId}/retry

write:webhooks

Paramètres

Nom	Emplacement	Requis
id	path	Requis
deliveryId	path	Requis

Exemple de requête

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/webhooks/subscriptions/{id}/deliveries/{deliveryId}/retry

Réponse202 · Success

Rotate the HMAC signing secret for this subscription (returned ONCE)

POST/households/{householdId}/webhooks/subscriptions/{id}/rotate-secret

write:webhooks

Paramètres

Nom	Emplacement	Requis
id	path	Requis

Exemple de requête

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/webhooks/subscriptions/{id}/rotate-secret

Réponse200 · Success

Send a signed test delivery to this subscription through the real delivery path

POST/households/{householdId}/webhooks/subscriptions/{id}/test

write:webhooks

Paramètres

Nom	Emplacement	Requis
id	path	Requis

Exemple de requête

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/webhooks/subscriptions/{id}/test

Réponse202 · Success