Beta

API ReferenceSkill Version

Publish Version

POSThttps://api.youvico.com/api/skills/:id/versions
MCP Tool
publish_skill_versionPublish Skill Version
Rate Limit
Tier 3
Scope
skills:write

Publishes a new skill version. Only skills whose source is WORKSPACE can be changed.

Example

curl -X POST 'https://api.youvico.com/api/skills/SK1234567890ABCD/versions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "content": "# Review Helper\n\nCheck revisions.", "note": "Initial public draft", "isDefault": true }'

{
  "data": {
    "id": "SV1234567890ABCD"
  }
}
Request
curl -X POST 'https://api.youvico.com/api/skills/SK1234567890ABCD/versions' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"content": "# Review Helper\n\nCheck revisions.",
"note": "Initial public draft",
"isDefault": true
}'
Response201 Created
{
  "data": {
    "id": "SV1234567890ABCD"
  }
}

Request

Path

idstringrequired
Skill ID

Body

contentstringrequired
Markdown content
notestring

1-1024 characters

Version note

Example: Initial public draft

isDefaultboolean
Whether to make it the default version

Example: true

Response

Returns 201 Created.

dataobject
Created version
data.idstring
ID of the created version

Example: SV1234567890ABCD