Invoke Skill Assets Trace

post/api/v1/skills/assets.trace/invoke

Forensic asset tracing — funds flow, related-party mapping, ownership trails.

Request bodyapplication/json

Field	Type	Description
`client_id`required	`string (uuid)`	—
`scope`	`"funds_flow" \| "related_party" \| "asset_dissipation" \| "ownership" \| "matrimonial"`	— `funds_flowrelated_partyasset_dissipationownershipmatrimonial`
`time_period`	`string \| null`	—
`target_entity`	`string \| null`	—
`file_ids`	`string (uuid)[]`	—
`jurisdiction`	`"AU" \| "GB" \| "CA" \| "US" \| "NZ" \| null`	—

Responses

200Skill executed successfully

Field Type Description

skillrequired string —

outputrequired

object

—

show nested

Field	Type	Description
`stub_fields`	`string[]`	—
`warnings`	`string[]`	—
`investigation_id`	`string (uuid)`	—
`funds_flow`	`object[]`	— item shape Empty object.
`related_parties`	`object[]`	— item shape Empty object.
`red_flags`	`any[]`	—
`forensic_narrative`	`string`	—
`evidence_checklist`	`string[]`	—
`citations`	`any[]`	—

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/assets.trace/invoke \
  -X POST \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
       "client_id": "00000000-0000-0000-0000-000000000000",
       "scope": "funds_flow",
       "time_period": null,
       "target_entity": null,
       "file_ids": [
         "00000000-0000-0000-0000-000000000000"
       ],
       "jurisdiction": null
     }'