Skip to main content
POST
Upload a new skill

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

multipart/form-data
files
file[]
required

The bundle's files.

scope
enum<string>
default:personal

Who an artifact is for. tenant is shown as "Global".

Available options:
personal,
tenant
version
string
default:0.1.0
changelog
string
default:""
Maximum string length: 4000

Response

Successful Response

What an uploaded skill bundle turned out to be.

valid
boolean
required
errors
string[]
frontmatter
SkillFrontmatter · object | null

SKILL.md frontmatter, per the agentskills.io specification.

manifest
SkillFile · object[]
scan
SkillScanReport · object | null

Static scan of a skill's bundled files. It informs review only.

size_bytes
integer
default:0
artifact
ArtifactDetail · object | null

An artifact with all its versions.