Sfoglia il riferimento

Voce

6 endpoint · Le descrizioni degli endpoint sono in inglese.

List voice memos in this household

GET/households/{householdId}/voice

read:voice

Parametri

Nome	Posizione	Obbligatorio
cursor	query	Facoltativo
limit	query	Facoltativo
status	query	Facoltativo
inboxOnly	query	Facoltativo

Richiesta di esempio

bash

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

Risposta200 · Success

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

POST/households/{householdId}/voice

write:voice

Richiesta di esempio

bash

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

Risposta201 · Success

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

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

read:voice

Parametri

Nome	Posizione	Obbligatorio
voiceMemoId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

Soft-delete a voice memo

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

write:voice

Parametri

Nome	Posizione	Obbligatorio
voiceMemoId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta204 · No content

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

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

write:voice

Parametri

Nome	Posizione	Obbligatorio
voiceMemoId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta201 · Success

Re-enqueue a failed transcription

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

write:voice

Parametri

Nome	Posizione	Obbligatorio
voiceMemoId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta201 · Success