Explorar a referência

Etiquetas

4 endpoints · As descrições dos endpoints estão em inglês.

List tags in this household

GET/households/{householdId}/tags

read:tags

Exemplo de pedido

bash

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

Resposta200 · Success

Create a tag

POST/households/{householdId}/tags

write:tags

Corpo do pedido

json

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

Exemplo de pedido

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

Resposta201 · Success

Update a tag

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

write:tags

Parâmetros

Nome	Local	Obrigatório
tagId	path	Obrigatório

Corpo do pedido

json

{  "name": "business"}

Exemplo de pedido

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

Resposta200 · Success

Delete a tag (cascades to transaction_tags junction)

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

write:tags

Parâmetros

Nome	Local	Obrigatório
tagId	path	Obrigatório

Exemplo de pedido

bash

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

Resposta204 · No content