Sfoglia il riferimento

Regole

8 endpoint · Le descrizioni degli endpoint sono in inglese.

List rules (ordered by priority then created_at)

GET/households/{householdId}/rules

read:rules

Richiesta di esempio

bash

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

Risposta200 · Success

Create a classification rule

POST/households/{householdId}/rules

write:rules

Corpo della richiesta

json

{  "name": "Auto-categorise coffee",  "predicate": {    "combinator": "all",    "conditions": [      {        "field": "payee_name",        "op": "contains",        "value": "coffee"      }    ]  },  "action": {    "setCategoryId": "01J8ME9B7QW3ZK5X2V8T4R6S1D"  }}

Richiesta di esempio

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Content-Type: application/json" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/rules \     -d '{"name":"Auto-categorise coffee","predicate":{"combinator":"all","conditions":[{"field":"payee_name","op":"contains","value":"coffee"}]},"action":{"setCategoryId":"01J8ME9B7QW3ZK5X2V8T4R6S1D"}}'

Risposta201 · Success

Fetch a single rule

GET/households/{householdId}/rules/{id}

read:rules

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

Update a rule (priority, enabled, predicate, action)

PATCH/households/{householdId}/rules/{id}

write:rules

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Corpo della richiesta

json

{  "enabled": false}

Richiesta di esempio

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Content-Type: application/json" \     -H "Idempotency-Key: $(uuidgen)" \     -X PATCH https://api.vokse.ai/households/current/rules/{id} \     -d '{"enabled":false}'

Risposta200 · Success

Soft-delete a rule

DELETE/households/{householdId}/rules/{id}

write:rules

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta204 · No content

Apply this rule to existing transactions (manual back-fill; trigger=manual)

POST/households/{householdId}/rules/{id}/apply

write:rules

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Richiesta di esempio

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/rules/{id}/apply

Risposta200 · Success

Preview which existing transactions this rule matches (dry-run, applies nothing)

POST/households/{householdId}/rules/{id}/preview

read:rules

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Richiesta di esempio

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/rules/{id}/preview

Risposta200 · Success

Apply every enabled rule (priority order, first-match-wins) to matching transactions

POST/households/{householdId}/rules/apply-all

write:rules

Richiesta di esempio

bash

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

Risposta200 · Success