Invoke Skill Reports Tax Return Prepare

post/api/v1/skills/reports.tax-return.prepare/invoke

Prepare a tax return artifact — income, BAS, IAS, VAT, corporate tax, payroll, or self-assessment.

Request bodyapplication/json

Field	Type	Description
`client_id`required	`string (uuid)`	—
`jurisdiction`required	`"AU" \| "GB" \| "CA" \| "US" \| "NZ"`	— `AUGBCAUSNZ`
`entity_type`	`"individual" \| "company" \| "partnership" \| "trust"`	— `individualcompanypartnershiptrust`
`return_type`	`"income" \| "bas" \| "ias" \| "vat" \| "corp" \| "payroll" \| "self_assessment"`	— `incomebasiasvatcorppayrollself_assessment`
`tax_year`required	`string`	—
`file_ids`	`string (uuid)[]`	—

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[]`	—
`return_type`	`string`	—
`jurisdiction`	`string`	—
`tax_year`	`string`	—
`tax_summary`	`object`	Structured per-return-type summary (e.g. BAS: G1/1A/1B/net; VAT: box_1/3/4/5/6/7). Pre-PR-D3 this was named `summary` and stayed dict-typed; the rename was forced by the BaseArtifactOutput shell which carries `summary: str` for the short narrative line. show nested Empty object.
`workpapers`	`object[]`	— item shape Empty object.
`estimated_liability`	`number \| string`	—

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.tax-return.prepare/invoke \
  -X POST \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
       "client_id": "00000000-0000-0000-0000-000000000000",
       "jurisdiction": "AU",
       "entity_type": "individual",
       "return_type": "income",
       "tax_year": "string",
       "file_ids": [
         "00000000-0000-0000-0000-000000000000"
       ]
     }'