Explorar la referencia

Etiquetas

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

List tags in this household

GET/households/{householdId}/tags

read:tags

Ejemplo de petición

bash

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

Respuesta200 · Success

Create a tag

POST/households/{householdId}/tags

write:tags

Cuerpo de la petición

json

{  "name": "reimbursable",  "color": "#86986F"}

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/tags \     -d '{"name":"reimbursable","color":"#86986F"}'

Respuesta201 · Success

Update a tag

PATCH/households/{householdId}/tags/{tagId}

write:tags

Parámetros

Nombre	En	Obligatorio
tagId	path	Obligatorio

Cuerpo de la petición

json

{  "name": "business"}

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/tags/{tagId} \     -d '{"name":"business"}'

Respuesta200 · Success

Delete a tag (cascades to transaction_tags junction)

DELETE/households/{householdId}/tags/{tagId}

write:tags

Parámetros

Nombre	En	Obligatorio
tagId	path	Obligatorio

Ejemplo de petición

bash

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

Respuesta204 · No content