Public API v1 - Files

Organize File

post/v1/files/{asset_id}:organize

Request

  • Base URL: https://api.corvio.ai
  • URL: https://api.corvio.ai/v1/files/{asset_id}:organize
  • Auth: HTTP bearer

Path parameters

asset_idstring uuid required

Headers

X-Corvio-Caller-Modelstring nullable

Request body

instructionstring required
target_root_node_idstring uuid nullable
additional_asset_idsstring[]
processing_profile'auto' | 'economy' | 'standard' | 'deep'
max_processing_profile'economy' | 'standard' | 'deep' nullable
scan_mode'auto' | 'always' | 'off'
skills_extraction_mode'auto' | 'always' | 'off'

Response

Successful Response

operation_idstring uuid required
asset_idstring uuid required
asset_idsstring[]
statusstring required
phasestring required
processingobject

Requested/effective processing profile plus scan and Skill-evaluation policy. These are request receipts, not proof that an output was produced.

resultobject

State-aware bounded projection. Queued/running results may state that provisional outputs are omitted; a completed result may include visible artifacts, source_reconciliation, and skills_evaluation. Qualifying Skill evaluations include stable candidate IDs and typed page/node resource refs when the durable write exposed them.

executionobject

Bounded execution receipts for this organization operation. A terminal response may include execution.durable_learning; candidate text and hidden Memory targets are never exposed.

retry_after_secondsinteger nullable

For queued or running work, the minimum suggested delay before another read. Absent at terminal state.

created_atstring date-time required
updated_atstring date-time required
linksobject required

Changes

No recorded changes to this operation across all 1 revision of this API.