Invoke Skill Documents Analyse
post
/api/v1/skills/documents.analyse/invokeAnalyse an uploaded document — summarise, extract figures, classify, risk-assess.
Request bodyapplication/json
| Field | Type | Description |
|---|---|---|
file_idrequired | string (uuid) | — |
analysis_type | "summarize" | "extract_figures" | "classify" | "risk_assess" | —summarizeextract_figuresclassifyrisk_assess |
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/documents.analyse/invoke \
-X POST \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{
"file_id": "00000000-0000-0000-0000-000000000000",
"analysis_type": "summarize"
}'