Skip to main content
POST
Upload a skill version

Authorizations

x-cominty-token
string
header
required

A Cominty Platform API secret. A key created now starts with sk-cmt-. Send it as is, or as Bearer sk-cmt-..., with at most one Bearer prefix. A key created before the prefix existed has no sk-cmt- and still works.

Path Parameters

skill_pid
string
required

Identifier of the skill.

Body

multipart/form-data
file
file
required

Zip archive of at most 30 MB, with the same layouts as POST /skills.

Response

Successful Response

id
string
required
created_at
string<date-time>
required
updated_at
string<date-time>
required

When the default version was uploaded.

display_name
string
required
active
boolean
required
scope
enum<string> | null
required

null for a built-in skill.

Available options:
organization,
private
frontmatter
SkillFrontmatter · object
required
source
enum<string>
required
read-only

cominty for a built-in, read-only skill. custom for one you uploaded.

Available options:
cominty,
custom