Parcourir la référence

Voix

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

List voice memos in this household

GET/households/{householdId}/voice

read:voice

Paramètres

Nom	Emplacement	Requis
cursor	query	Optionnel
limit	query	Optionnel
status	query	Optionnel
inboxOnly	query	Optionnel

Exemple de requête

bash

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

Réponse200 · Success

Upload a voice memo (mp3/m4a/wav/webm/ogg, max 25 MB)

POST/households/{householdId}/voice

write:voice

Exemple de requête

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/voice \     -F "file=@receipt.jpg"

Réponse201 · Success

Get a voice memo + 300s presigned URL for the audio

GET/households/{householdId}/voice/{voiceMemoId}

read:voice

Paramètres

Nom	Emplacement	Requis
voiceMemoId	path	Requis

Exemple de requête

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/households/current/voice/{voiceMemoId}

Réponse200 · Success

Soft-delete a voice memo

DELETE/households/{householdId}/voice/{voiceMemoId}

write:voice

Paramètres

Nom	Emplacement	Requis
voiceMemoId	path	Requis

Exemple de requête

bash

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

Réponse204 · No content

Materialise the parsed voice memo into a Transaction. Overrides win over the parse.

POST/households/{householdId}/voice/{voiceMemoId}/confirm

write:voice

Paramètres

Nom	Emplacement	Requis
voiceMemoId	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/voice/{voiceMemoId}/confirm

Réponse201 · Success

Re-enqueue a failed transcription

POST/households/{householdId}/voice/{voiceMemoId}/retry

write:voice

Paramètres

Nom	Emplacement	Requis
voiceMemoId	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/voice/{voiceMemoId}/retry

Réponse201 · Success