Invoke Skill Derive Period
post
/api/v1/skills/derive.period/invoke(Utility) Derive canonical period bounds + matching prior-period bounds from a kind discriminator + anchor date. Pure compute — same input always produces identical output. Supports BAS-AU monthly/quarterly/annual today; additional jurisdictions are new ``kind`` values.
Request bodyapplication/json
| Field | Type | Description |
|---|---|---|
kindrequired | any | — |
anchor_daterequired | string (date) | — |
Responses
200Skill executed successfully
| Field | Type | Description | |||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
skillrequired | string | — | |||||||||||||||||||||||||||||||||
outputrequired | object | Skill output — period bounds + matching prior-period bounds.
All date fields are ISO strings so they substitute cleanly into Jinja2
templates in WDL (``{{ outputs.derive_period.period_start }}``)
without ``date`` repr surprises.
Prior period: the unique period of the same kind immediately
preceding the current one — useful for comparatives. For BAS this is
the prior month / prior FY quarter / prior FY.show nested
| |||||||||||||||||||||||||||||||||
correlation_idrequired | string | — |
401Authentication required
| Field | Type | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errorrequired | object | —show nested
|
403Insufficient permissions
| Field | Type | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errorrequired | object | —show nested
|
404Skill not found
| Field | Type | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errorrequired | object | —show nested
|
429Rate limit exceeded
| Field | Type | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errorrequired | object | —show nested
|
5XXInternal server error
| Field | Type | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errorrequired | object | —show nested
|
curl https://api.dev.arch.ie/api/v1/skills/derive.period/invoke \
-X POST \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{
"kind": null,
"anchor_date": "string"
}'