Invoke Skill Payroll Advise
post
/api/v1/skills/payroll.advise/invokePayroll compliance advice — STP/RTI/SGC, contractor classification, payroll tax.
Request bodyapplication/json
| Field | Type | Description |
|---|---|---|
topicrequired | string | — |
jurisdiction | "AU" | "GB" | "CA" | "US" | "NZ" | null | — |
client_id | string (uuid) | null | — |
payroll_system | "xero" | "adp" | "gusto" | "rippling" | "myob" | "unknown" | —xeroadpgustoripplingmyobunknown |
Responses
200Skill executed successfully
| Field | Type | Description | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
skillrequired | string | — | ||||||||||||||||||||||||
outputrequired | object | —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/payroll.advise/invoke \
-X POST \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{
"topic": "string",
"jurisdiction": null,
"client_id": null,
"payroll_system": "xero"
}'