Invoke Skill Audit Workpaper Review

post/api/v1/skills/audit.workpaper.review/invoke

Advisory — LLM-driven; verify against authoritative sources before relying. Review an audit workpaper — completeness, methodology, evidence sufficiency, and standards compliance. Pairs with prepare_audit_workpaper; supports self-check, senior review, partner review, and concurring-partner review tiers.

Request bodyapplication/json

Field	Type	Description
`client_id`required	`string (uuid)`	—
`period`required	`string`	—
`file_ids`required	`string (uuid)[]`	Uploaded workpaper file(s) to review. At least one required.
`workpaper_type`	`"lead_schedule" \| "substantive_test" \| "planning_memo" \| "going_concern" \| "subsequent_events" \| "revenue_testing" \| "expense_testing" \| "debt_confirmation" \| "related_party"`	— `lead_schedulesubstantive_testplanning_memogoing_concernsubsequent_eventsrevenue_testingexpense_testingdebt_confirmationrelated_party`
`framework`	`"ASA" \| "ISA" \| "PCAOB" \| "GAAS" \| "ISA_UK"`	— `ASAISAPCAOBGAASISA_UK`
`review_level`	`"self_check" \| "senior_review" \| "partner_review" \| "concurring_partner_review"`	— `self_checksenior_reviewpartner_reviewconcurring_partner_review`
`materiality`	`number \| string \| null`	—
`focus_areas`	`string[]`	Optional reviewer focus shortlist — e.g. ['sample_selection', 'evidence_sufficiency', 'cutoff', 'standards_compliance']. Empty means full review.

Responses

200Skill executed successfully

Field Type Description

skillrequired string —

outputrequired

object

—

show nested

Field	Type	Description
`artifact_id`	`string (uuid) \| null`	—
`download_url`	`string`	—
`summary`	`string`	—
`citations`	`any[]`	—
`warnings`	`string[]`	—
`stub_fields`	`string[]`	—
`review_status`	`"pending" \| "cleared" \| "findings_to_address" \| "rejected"`	— `pendingclearedfindings_to_addressrejected`
`findings`	`any[]`	—
`recommendations`	`string[]`	—
`coverage_assessment`	`object`	Per-area coverage rating — e.g. {'sample_selection': 'adequate', 'evidence': 'weak', 'cutoff': 'not_tested'}. show nested Empty object.

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/audit.workpaper.review/invoke \
  -X POST \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
       "client_id": "00000000-0000-0000-0000-000000000000",
       "period": "string",
       "file_ids": [
         "00000000-0000-0000-0000-000000000000"
       ],
       "workpaper_type": "lead_schedule",
       "framework": "ASA",
       "review_level": "self_check",
       "materiality": null,
       "focus_areas": [
         "string"
       ]
     }'