Skip to main content
POST
Update skill by uploading a new revision

Authorizations

Authorization
string
header
required

An opaque Omnara personal or organization bearer token.

Path Parameters

orgID
string
required
Pattern: ^org_[a-z2-7]{26}$
skillID
string
required
Pattern: ^skl_[a-z2-7]{26}$

Body

multipart/form-data
archive
file
required
skill_md
string

Replacement SKILL.md content. Every other file in the current revision's archive is preserved unchanged.

Response

Skill updated with a new revision.

id
string
required
Pattern: ^skl_[a-z2-7]{26}$
org_id
string
required
Pattern: ^org_[a-z2-7]{26}$
owner
object
required
name
string
required

Machine-readable skill identifier consisting of lowercase ASCII segments separated by single hyphens.

Required string length: 1 - 64
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
revision_id
string
required
Pattern: ^skr_[a-z2-7]{26}$
revision
integer<int32>
required

Latest revision number of the skill.

Required range: x >= 1
description
string
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
skill_md
string
files
object[]

Files in the skill archive, including SKILL.md, with paths relative to the skill's top-level directory. Returned when fetching a single skill; omitted from list responses.