Explorar la referencia

Categorías

7 endpoints · Las descripciones de los endpoints están en inglés.

List categories in this household

GET/households/{householdId}/categories

read:categories

Ejemplo de petición

bash

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

Respuesta200 · Success

Create a category in a group

POST/households/{householdId}/categories

write:categories

Cuerpo de la petición

json

{  "name": "Groceries",  "groupId": "01J8ME9C4TJ6WX2K8V5R3Q7S9Z"}

Ejemplo de petición

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

Respuesta201 · Success

Update a category

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

write:categories

Parámetros

Nombre	En	Obligatorio
categoryId	path	Obligatorio

Cuerpo de la petición

json

{  "name": "Groceries & household"}

Ejemplo de petición

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

Respuesta200 · Success

Soft-delete a category

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

write:categories

Parámetros

Nombre	En	Obligatorio
categoryId	path	Obligatorio

Ejemplo de petición

bash

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

Respuesta204 · No content

Atomically reorder categories across groups

POST/households/{householdId}/categories/reorder

write:categories

Ejemplo de petición

bash

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

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

Ejemplo de petición

bash

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

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

Cuerpo de la petición

json

{  "packId": "essentials"}

Ejemplo de petición

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

Respuesta201 · Success