Public API v1

Ask Question

post/v1/questions

Request

  • Base URL: https://api.corvio.ai
  • URL: https://api.corvio.ai/v1/questions
  • Auth: HTTP bearer

Headers

Idempotency-Keystring nullable
X-Corvio-Agent-Event-Idstring uuid nullable
X-Corvio-Agent-Event-Lease-Tokenstring nullable
X-Corvio-Caller-Modelstring nullable
X-Corvio-Client-Namestring nullable
X-Corvio-Client-Versionstring nullable

Request body

promptstring required
conversation_idstring uuid nullable
asset_idsstring[]

Existing Corvio Workspace Assets to attach to this question. Upload local bytes first, then pass the finalized Asset IDs here.

mode'answer_only' | 'allow_actions'

answer_only forbids Workspace and durable-learning writes. Use allow_actions for authorized document/Work Model changes and for evidence-based Memory/Skill closure.

sourcesstring[]
processing_profile'auto' | 'economy' | 'standard' | 'deep'
max_processing_profile'economy' | 'standard' | 'deep' nullable
scan_mode'auto' | 'always' | 'off'
skills_extraction_mode'auto' | 'always' | 'off'
contextobject nullable

Response

Successful Response

idstring uuid required
object'question'
status'in_progress' | 'needs_user_input' | 'completed' | 'failed' | 'cancelled' required
promptstring required
answerstring nullable
conversation_idstring uuid required
thread_idstring uuid required
trace_idstring nullable
source_document_idsstring[]
answer_blocksobject[]
usageobject
executionobject

Durable execution receipt including caller origin, requested/effective processing profile, the scan/Skill-evaluation knowledge policy, and bounded Memory/Skill review and execution outcomes when this Question performed durable learning.

errorobject nullable
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.