statement-review

Assess Finding With Ai

Enqueue the AI-accountant narrative for one finding (accountant).

Brokered like every "Run with AI" flow: one pending ai_task row the UI polls; the narrative lands cached on the finding (ai_assessment) keyed to its value fingerprint, so an unchanged finding is never re-billed. The deterministic verdict stays authoritative — the AI only explains/proposes.

post/companies/{company_id}/review/findings/{finding_identity}/assess-with-ai

Request

  • Base URL: https://app.zeno-works.ch (the document declares no server; this is the origin it was published from)
  • URL: https://app.zeno-works.ch/companies/{company_id}/review/findings/{finding_identity}/assess-with-ai
  • Auth: none declared

Path parameters

company_idstring required
finding_identitystring required

Headers

authorizationstring nullable

Cookies

access_tokenstring nullable

Response

Successful Response

idstring required
kind'payroll_run' | 'ar_draft' | 'period_close' | 'fixed_asset_review' | 'statement_review' required

Which "Run with AI" flow an ai_task row executes.

payroll_run — advance a draft payroll run calculate→approve→post; ar_draft — draft + ready an outgoing AR invoice from an instruction; period_close — run the close checks + the autopost accrual sweep; fixed_asset_review — apply the recognition settings to a fiscal year's asset inventory, post its due depreciation, accept the year's unambiguous held capitalization proposals, and (under auto only) finalize the review. statement_review — produce the AI-accountant narrative assessment for one statement-review finding (doc/pipeline.md §Statement review); the verdict stays deterministic, the task only explains and proposes.

status'pending' | 'processing' | 'done' | 'failed' required

Queue lifecycle of an ai_task row (doc/architecture.md §"Work queue").

pending → processing on claim (heartbeat claimed_at), then a terminal done/failed; the stuck-row sweep returns abandoned processing rows to pending.

target_idstring nullable
payloadobject required
resultunknown
errorstring nullable
requested_bystring nullable
created_atstring date-time required
finished_atstring date-time nullable

Changes

No recorded changes to this operation across all 1 revision of this API.