Invoke Skill Compliance Deadline Calendar

post/api/v1/skills/compliance.deadline.calendar/invoke

Produce a structured calendar of upcoming filing/compliance deadlines for a client over a window. Covers tax returns, BAS/VAT/GST, payroll/STP/RTI, annual returns, audit requirements, super/pension, and board meetings. Read-only — the user or a workstream cycle acts on each entry separately.

Request bodyapplication/json

Field	Type	Description
`client_id`required	`string (uuid)`	—
`jurisdiction`required	`"AU" \| "GB" \| "CA" \| "US" \| "NZ"`	— `AUGBCAUSNZ`
`entity_type`	`"individual" \| "corporation" \| "s_corporation" \| "partnership" \| "trust" \| "non_profit"`	— `individualcorporations_corporationpartnershiptrustnon_profit`
`window`	`"next_30_days" \| "next_quarter" \| "next_year" \| "explicit"`	— `next_30_daysnext_quarternext_yearexplicit`
`lookahead_days`	`integer \| null`	Used only when window='explicit'; ignored otherwise.
`deadline_types`	`string[]`	Optional category filter — e.g. ['tax_return', 'bas', 'vat', 'payroll', 'annual_return', 'audit', 'super', 'pension']. Empty means scan all categories.

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[]`	—
`deadlines`	`any[]`	—
`jurisdiction`	`string`	—
`window_start`	`string (date) \| null`	—
`window_end`	`string (date) \| null`	—

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/compliance.deadline.calendar/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",
       "window": "next_30_days",
       "lookahead_days": null,
       "deadline_types": [
         "string"
       ]
     }'