Invoke Skill Controls Test
post
/api/v1/skills/controls.test/invokeTest internal controls — design or operating effectiveness, sample selection, exceptions.
Request bodyapplication/json
| Field | Type | Description |
|---|---|---|
client_idrequired | string (uuid) | — |
control_set | "payment_authorisation" | "journal_approval" | "user_access" | "segregation_of_duties" | "expense_approval" | "custom" | —payment_authorisationjournal_approvaluser_accesssegregation_of_dutiesexpense_approvalcustom |
test_type | "design" | "operating" | "both" | —designoperatingboth |
sample_size | integer | — |
period | string | null | — |
custom_controls | string[] | — |
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/controls.test/invoke \
-X POST \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{
"client_id": "00000000-0000-0000-0000-000000000000",
"control_set": "payment_authorisation",
"test_type": "design",
"sample_size": 0,
"period": null,
"custom_controls": [
"string"
]
}'