In der Referenz stöbern

KI-Assistent

12 Endpunkte · Die Endpunktbeschreibungen sind auf Englisch.

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

GET/households/{householdId}/ai/actions

ai:chat

Beispielanfrage

bash

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

Antwort200 · Success

Cancel a pending destructive action.

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

ai:chat

Parameter

Name	Ort	Erforderlich
id	path	Erforderlich

Beispielanfrage

bash

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

Antwort200 · Success

Confirm and execute a pending assistant action.

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

ai:chat

Parameter

Name	Ort	Erforderlich
id	path	Erforderlich

Beispielanfrage

bash

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

Antwort200 · 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

Request-Body

json

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

Beispielanfrage

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

Antwort201 · 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

Parameter

Name	Ort	Erforderlich
limit	query	Optional
cursor	query	Optional
q	query	Optional

Beispielanfrage

bash

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

Antwort200 · Success

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

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

ai:chat

Parameter

Name	Ort	Erforderlich
id	path	Erforderlich

Beispielanfrage

bash

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

Antwort200 · Success

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

ai:chat

Parameter

Name	Ort	Erforderlich
id	path	Erforderlich

Beispielanfrage

bash

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

Antwort200 · Success

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

ai:chat

Parameter

Name	Ort	Erforderlich
id	path	Erforderlich

Beispielanfrage

bash

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

Antwort204 · No content

Stop further turns on this conversation.

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

ai:chat

Parameter

Name	Ort	Erforderlich
id	path	Erforderlich

Beispielanfrage

bash

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

Antwort200 · Success

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

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

ai:chat

Beispielanfrage

bash

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

Antwort200 · Success

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

GET/households/{householdId}/ai/tools

ai:tools

Beispielanfrage

bash

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

Antwort200 · Success

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

GET/households/{householdId}/ai/usage

ai:tools

Beispielanfrage

bash

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

Antwort200 · Success