Explorar la referencia

Webhooks

8 endpoints · Las descripciones de los endpoints están en inglés.

List webhook subscriptions for this household (no secrets)

GET/households/{householdId}/webhooks/subscriptions

read:webhooks

Ejemplo de petición

bash

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

Respuesta200 · Success

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

POST/households/{householdId}/webhooks/subscriptions

write:webhooks

Cuerpo de la petición

json

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

Ejemplo de petición

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"]}'

Respuesta201 · Success

Update url / eventTypes / status of a subscription

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

write:webhooks

Parámetros

Nombre	En	Obligatorio
id	path	Obligatorio

Cuerpo de la petición

json

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

Ejemplo de petición

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"]}'

Respuesta200 · Success

Delete a webhook subscription + every associated delivery

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

write:webhooks

Parámetros

Nombre	En	Obligatorio
id	path	Obligatorio

Ejemplo de petición

bash

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

Respuesta204 · No content

Recent delivery log for this subscription

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

read:webhooks

Parámetros

Nombre	En	Obligatorio
id	path	Obligatorio
limit	query	Obligatorio

Ejemplo de petición

bash

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

Respuesta200 · Success

Queue a past delivery again with its original payload

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

write:webhooks

Parámetros

Nombre	En	Obligatorio
id	path	Obligatorio
deliveryId	path	Obligatorio

Ejemplo de petición

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

Respuesta202 · Success

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

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

write:webhooks

Parámetros

Nombre	En	Obligatorio
id	path	Obligatorio

Ejemplo de petición

bash

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

Respuesta200 · Success

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

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

write:webhooks

Parámetros

Nombre	En	Obligatorio
id	path	Obligatorio

Ejemplo de petición

bash

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

Respuesta202 · Success