Public API v1

Create Question Operation

Start a durable Question without tying its lifetime to this HTTP request.

post/v1/question-operations

Request

  • Base URL: https://api.corvio.ai
  • URL: https://api.corvio.ai/v1/question-operations
  • Auth: HTTP bearer

Headers

Idempotency-Keystring 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

operation_idstring uuid required
object'question_operation'
status'queued' | 'running' | 'needs_user_input' | 'succeeded' | 'failed' | 'cancelled' required
phasestring required
status_messagestring required
question_idstring uuid nullable
conversation_idstring uuid nullable
progress_cursorinteger
progress_has_moreboolean
retry_after_secondsinteger nullable
cancellation_requestedboolean
errorobject nullable
created_atstring date-time nullable
updated_atstring date-time nullable
linksobject

Changes

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