Zum Inhalt springen
vokse.
In der Referenz stöbern
Alle Ressourcen

Kategorien

7 Endpunkte · Die Endpunktbeschreibungen sind auf Englisch.

List categories in this household

GET/households/{householdId}/categories
read:categories
Beispielanfrage
bash
curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/households/current/categories
Antwort200 · Success

Create a category in a group

POST/households/{householdId}/categories
write:categories
Request-Body
json
{  "name": "Groceries",  "groupId": "01J8ME9C4TJ6WX2K8V5R3Q7S9Z"}
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/categories \     -d '{"name":"Groceries","groupId":"01J8ME9C4TJ6WX2K8V5R3Q7S9Z"}'
Antwort201 · Success

Update a category

PATCH/households/{householdId}/categories/{categoryId}
write:categories

Parameter

NameOrtErforderlich
categoryIdpathErforderlich
Request-Body
json
{  "name": "Groceries & household"}
Beispielanfrage
bash
curl -H "Authorization: Bearer vokse_sk_…" \     -H "Content-Type: application/json" \     -H "Idempotency-Key: $(uuidgen)" \     -X PATCH https://api.vokse.ai/households/current/categories/{categoryId} \     -d '{"name":"Groceries & household"}'
Antwort200 · Success

Soft-delete a category

DELETE/households/{householdId}/categories/{categoryId}
write:categories

Parameter

NameOrtErforderlich
categoryIdpathErforderlich
Beispielanfrage
bash
curl -H "Authorization: Bearer vokse_sk_…" \     -X DELETE https://api.vokse.ai/households/current/categories/{categoryId}
Antwort204 · No content

Atomically reorder categories across groups

POST/households/{householdId}/categories/reorder
write:categories
Beispielanfrage
bash
curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/categories/reorder
Antwort204 · No content

Suggest catalogue icons for category names. Layered resolver (emoji hint → multilingual dictionary → persistent cache → AI); never fails: unknown names get the default icon with confidence 0.

POST/households/{householdId}/icons/suggest
read:categories
Beispielanfrage
bash
curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/icons/suggest
Antwort200 · Success

Seed a starter category pack into this household. Idempotent by name: existing groups are reused and existing categories skipped, so re-running never duplicates the structure. Names are created in the household data language.

POST/households/{householdId}/starter-pack
write:categories
Request-Body
json
{  "packId": "essentials"}
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/starter-pack \     -d '{"packId":"essentials"}'
Antwort201 · Success