Compile Canvas

POST /api/v1/evi/canvases/{id}/compile
Authorization: Bearer theo_sk_...

Validates the canvas graph and compiles it into two outputs:

SkillManifest — Used by the skill system for marketplace listing, install, and prompt injection.
WorkflowSteps — Used by the workflow engine for runtime execution.

The compiled output is saved on the canvas record. The canvas status transitions to "testing".

Validation Checks

Exactly 1 Input node
At least 1 reachable Output node
No cycles in the execution path
All nodes reachable from Input
Model nodes must have an upstream Prompt node
All node types must be valid (input, prompt, model, tool, knowledge, condition, output, vision)

Response (success)

{
  "compiled": true,
  "manifest": { "name": "...", "slug": "...", "version": "1.0.0", "..." },
  "steps": [{ "type": "ai_transform", "name": "...", "config": { "..." } }],
  "errors": []
}

Response (validation errors)

{
  "compiled": false,
  "errors": [
    { "code": "cycle_detected", "message": "Canvas graph contains a cycle." },
    { "code": "model_no_prompt", "message": "Model node has no Prompt node upstream.", "nodeId": "model-1" }
  ]
}

Status 422 is returned when validation fails.

Canvases

Test Canvas

Overview

Completions

Media Generation

Audio

Skills API

E.V.I. Canvas

Workflows

Hooks

Settings

Embed Widgets

Guardrails

Routing Studio

Theo Browser

Benchmarks

Webhooks

Billing

Resources

Validation Checks

Response (success)

Response (validation errors)

​Validation Checks

​Response (success)

​Response (validation errors)

Validation Checks

Response (success)

Response (validation errors)