Parcourir la référence

Assistant IA

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

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

GET/households/{householdId}/ai/actions

ai:chat

Exemple de requête

bash

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

Réponse200 · Success

Cancel a pending destructive action.

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

ai:chat

Paramètres

Nom	Emplacement	Requis
id	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/ai/actions/{id}/cancel

Réponse200 · Success

Confirm and execute a pending assistant action.

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

ai:chat

Paramètres

Nom	Emplacement	Requis
id	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/ai/actions/{id}/confirm

Réponse200 · 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

Corps de la requête

json

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

Exemple de requête

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

Réponse201 · 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

Paramètres

Nom	Emplacement	Requis
limit	query	Optionnel
cursor	query	Optionnel
q	query	Optionnel

Exemple de requête

bash

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

Réponse200 · Success

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

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

ai:chat

Paramètres

Nom	Emplacement	Requis
id	path	Requis

Exemple de requête

bash

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

Réponse200 · Success

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

ai:chat

Paramètres

Nom	Emplacement	Requis
id	path	Requis

Exemple de requête

bash

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

Réponse200 · Success

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

ai:chat

Paramètres

Nom	Emplacement	Requis
id	path	Requis

Exemple de requête

bash

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

Réponse204 · No content

Stop further turns on this conversation.

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

ai:chat

Paramètres

Nom	Emplacement	Requis
id	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/ai/conversations/{id}/stop

Réponse200 · Success

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

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

ai:chat

Exemple de requête

bash

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

Réponse200 · Success

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

GET/households/{householdId}/ai/tools

ai:tools

Exemple de requête

bash

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

Réponse200 · Success

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

GET/households/{householdId}/ai/usage

ai:tools

Exemple de requête

bash

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

Réponse200 · Success