Invoke Skill Reports Financial Prepare

post/api/v1/skills/reports.financial.prepare/invoke

Generate a financial report (TB, P&L, balance sheet, mgmt accounts, or financial statements).

Request bodyapplication/json

Field	Type	Description
`client_id`required	`string (uuid)`	—
`report_type`required	`"trial_balance" \| "profit_loss" \| "balance_sheet" \| "management_accounts" \| "monthly_management" \| "leave_provision" \| "soce" \| "payroll_summary" \| "financial_statements"`	— `trial_balanceprofit_lossbalance_sheetmanagement_accountsmonthly_managementleave_provisionsocepayroll_summaryfinancial_statements`
`period`required	`string`	—
`comparison_periods`	`string[]`	—
`industry`	`string \| null`	—
`output_format`	`"pdf" \| "xlsx" \| "both"`	— `pdfxlsxboth`
`max_age_hours`	`number \| null`	—

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[]`	—
`xlsx_download_url`	`string \| null`	—
`report_type`	`string`	—
`period`	`string`	—
`sections`	`string[]`	—
`rows_written`	`integer`	—

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/reports.financial.prepare/invoke \
  -X POST \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
       "client_id": "00000000-0000-0000-0000-000000000000",
       "report_type": "trial_balance",
       "period": "string",
       "comparison_periods": [
         "string"
       ],
       "industry": null,
       "output_format": "pdf",
       "max_age_hours": null
     }'