Publish Canvas

POST /api/v1/evi/canvases/{id}/publish
Authorization: Bearer theo_sk_...
Content-Type: application/json

{
  "slug": "my-support-agent",
  "version": "1.0.0",
  "author": { "name": "Your Name" },
  "visibility": "public",
  "readme": "# My Support Agent\nA customer service skill built with the E.V.I. Canvas.",
  "license": "MIT",
  "keywords": ["support", "customer-service"]
}

​

Parameters

• slug (string, required) — Skill slug. Lowercase alphanumeric with hyphens.
• version (string, required) — Semver version (e.g. 1.0.0).
• author (object, required) — { name, email?, url? }.
• visibility (string, optional) — Publishing visibility. Default: "private".
  • "private" — Only you can see and install the skill.
  • "org" — Visible to all members of the target organization. Requires target_org_id.
  • "public" — Listed in the public Skill Store.
• target_org_id (string, optional) — Required when visibility is "org". The UUID of the org to scope the skill to.
• readme (string, optional) — Markdown README for the marketplace listing (max 50,000 chars).
• license (string, optional) — SPDX license identifier. Default: "MIT".
• keywords (array, optional) — Up to 10 search keywords.

​

Response (auto-approved)

{
  "published": true,
  "visibility": "public",
  "submission": {
    "id": "uuid",
    "status": "approved",
    "reviewTier": "auto",
    "autoApproved": true
  },
  "skillId": "uuid"
}

​

Response (pending review)

{
  "published": true,
  "visibility": "org",
  "submission": {
    "id": "uuid",
    "status": "pending_review",
    "reviewTier": "staff",
    "autoApproved": false
  },
  "skillId": "uuid"
}

​

Response (compilation or review failure)