Browse the reference

Voice

6 endpoints

List voice memos in this household

GET/households/{householdId}/voice

read:voice

Parameters

Name	In	Required
cursor	query	Optional
limit	query	Optional
status	query	Optional
inboxOnly	query	Optional

Example request

bash

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

Response200 · Success

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

POST/households/{householdId}/voice

write:voice

Example request

bash

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

Response201 · Success

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

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

read:voice

Parameters

Name	In	Required
voiceMemoId	path	Required

Example request

bash

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

Response200 · Success

Soft-delete a voice memo

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

write:voice

Parameters

Name	In	Required
voiceMemoId	path	Required

Example request

bash

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

Response204 · No content

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

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

write:voice

Parameters

Name	In	Required
voiceMemoId	path	Required

Example request

bash

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

Response201 · Success

Re-enqueue a failed transcription

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

write:voice

Parameters

Name	In	Required
voiceMemoId	path	Required

Example request

bash

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

Response201 · Success