In der Referenz stöbern

Tags

4 Endpunkte · Die Endpunktbeschreibungen sind auf Englisch.

List tags in this household

GET/households/{householdId}/tags

read:tags

Beispielanfrage

bash

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

Antwort200 · Success

Create a tag

POST/households/{householdId}/tags

write:tags

Request-Body

json

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

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

Antwort201 · Success

Update a tag

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

write:tags

Parameter

Name	Ort	Erforderlich
tagId	path	Erforderlich

Request-Body

json

{  "name": "business"}

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

Antwort200 · Success

Delete a tag (cascades to transaction_tags junction)

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

write:tags

Parameter

Name	Ort	Erforderlich
tagId	path	Erforderlich

Beispielanfrage

bash

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

Antwort204 · No content