Invoke Skill Accruals Suggest

post/api/v1/skills/accruals.suggest/invoke

Advisory — LLM-driven; verify against authoritative sources before relying. Suggest month-end accruals for a client by scanning the trial balance, variance against prior periods, and recurring patterns. Read-only — produces structured suggestions for review; the user posts via record_journal_entry.

Request bodyapplication/json

Field	Type	Description
`client_id`required	`string (uuid)`	—
`period`required	`string`	YYYY-MM month-end target (e.g. '2026-04')
`lookback_months`	`integer`	How many prior periods to scan for recurring patterns.
`focus_areas`	`string[]`	Optional shortlist of accrual categories — e.g. ['wages', 'interest', 'rent', 'utilities']. Empty means scan everything.
`jurisdiction`	`"AU" \| "GB" \| "CA" \| "US" \| "NZ" \| null`	—

Responses

200Skill executed successfully

Field Type Description

skillrequired string —

outputrequired

object

—

show nested

Field	Type	Description
`stub_fields`	`string[]`	—
`warnings`	`string[]`	—
`summary`	`string`	—
`suggestions`	`any[]`	—
`citations`	`any[]`	—

correlation_idrequired string —

401Authentication required

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

403Insufficient permissions

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

404Skill not found

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

429Rate limit exceeded

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

5XXInternal server error

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

curl https://api.dev.arch.ie/api/v1/skills/accruals.suggest/invoke \
  -X POST \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
       "client_id": "00000000-0000-0000-0000-000000000000",
       "period": "string",
       "lookback_months": 0,
       "focus_areas": [
         "string"
       ],
       "jurisdiction": null
     }'