Sfoglia il riferimento

Assistente IA

12 endpoint · Le descrizioni degli endpoint sono in inglese.

List pending AI actions awaiting user confirmation. Paginated with opaque cursor.

GET/households/{householdId}/ai/actions

ai:chat

Richiesta di esempio

bash

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

Risposta200 · Success

Cancel a pending destructive action.

POST/households/{householdId}/ai/actions/{id}/cancel

ai:chat

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

Confirm and execute a pending assistant action.

POST/households/{householdId}/ai/actions/{id}/confirm

ai:chat

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

Stream a chat turn (SSE). Returns text/event-stream. 403 AI_CONSENT_REQUIRED until the ai_processing consent is granted.

POST/households/{householdId}/ai/chat

ai:chat

Corpo della richiesta

json

{  "message": "How much did I spend on groceries last month?"}

Richiesta di esempio

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Content-Type: application/json" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/ai/chat \     -d '{"message":"How much did I spend on groceries last month?"}'

Risposta201 · Success

List conversations in the household visible to the user. Ordered by updatedAt (most recent first); cursor-paginated; optional q title search.

GET/households/{householdId}/ai/conversations

ai:chat

Parametri

Nome	Posizione	Obbligatorio
limit	query	Facoltativo
cursor	query	Facoltativo
q	query	Facoltativo

Richiesta di esempio

bash

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

Risposta200 · Success

Fetch a single conversation (creator + household owners only).

GET/households/{householdId}/ai/conversations/{id}

ai:chat

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

PATCH/households/{householdId}/ai/conversations/{id}

ai:chat

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

DELETE/households/{householdId}/ai/conversations/{id}

ai:chat

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta204 · No content

Stop further turns on this conversation.

POST/households/{householdId}/ai/conversations/{id}/stop

ai:chat

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

Bulk-delete the current user's conversations (ids or all).

POST/households/{householdId}/ai/conversations/bulk-delete

ai:chat

Richiesta di esempio

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/ai/conversations/bulk-delete

Risposta200 · Success

Tools available to the current member's role (count + names).

GET/households/{householdId}/ai/tools

ai:tools

Richiesta di esempio

bash

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

Risposta200 · Success

Current user AI usage for today + daily cap + household monthly cap.

GET/households/{householdId}/ai/usage

ai:tools

Richiesta di esempio

bash

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

Risposta200 · Success