Corvio Developer Platform

Give your agents a durable place to work.

One resource language for asking, searching, writing, retaining files, synchronizing Markdown, and testing—built around receipts your next call can trust.

POST /v1/questionsProduction
curl https://api.corvio.ai/v1/questions \
  -H "Authorization: Bearer $CORVIO_API_KEY" \
  -H "Idempotency-Key: launch-risk-review" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "What launch risks remain?",
    "sources": ["workspace", "memory"]
  }'
201 CREATEDquestion_idconversation_idsource_document_ids
Resource model

Useful work leaves evidence.

Corvio responses are designed for iteration. Follow returned links and IDs instead of reconstructing state from prose.

Durable by default

Answers return stable question, conversation, document, source, and artifact IDs.

Authority rechecked

Every call re-evaluates the key owner, Workspace membership, role, scope, ACL, expiry, and revocation.

Safe to retry

Creates accept Idempotency-Key; document replacement accepts an expected content revision.

A question is a resource, not a disposable response.
{
  "id": "question_uuid",
  "status": "completed",
  "conversation_id": "conversation_uuid",
  "source_document_ids": ["document_uuid"],
  "artifacts": [{
    "kind": "document",
    "document_id": "artifact_uuid",
    "content_revision": 4
  }],
  "links": {
    "self": "/v1/questions/question_uuid",
    "conversation": "/v1/conversations/conversation_uuid"
  }
}
Surface area

Small enough to learn. Complete enough to operate.

The generated reference remains the exact operation authority; this map shows the durable capability boundaries.

Questions

Ask Corvio, inspect durable runs, and continue with conversation_id.

GET · POST/questions

Conversations

Recover stable continuation handles without replaying chat history.

GET/conversations

Workspace search

Search knowledge with page, node, chunk, and source references intact.

POST/search

Documents

List, read, create, revision-update, archive, and privately share documents.

GET · POST · PUT · DELETE/documents

Workspace files

Retain originals, download exact bytes, and launch organization runs with stable Asset handles.

GET · POST/files

Local Markdown sync

Plan, pull, push, commit, and explicitly resolve revision/hash conflicts.

GET · POST/sync

Test control

Discover catalog contracts and launch Workspace-bound test runs as an administrator.

GET · POST/admin/tests
Official Agent Skill

Install the operating model, not another prompt snippet.

corvio-operate-workspace teaches compatible agents how to discover the API, preserve provenance, continue conversations, paginate, retry safely, and verify durable effects.

Example agent request

Use $corvio-operate-workspace to find the latest launch plan, summarize unresolved risks with source document IDs, then continue that Corvio conversation and create a prioritized checklist.

Discovery → evidence → durable effect → verification
Get started

Build with the same contracts Corvio uses to verify itself.