Skip to content
Agents
Skills

Publish Version

POST
/v1/skills/{skill_id}/versions
curl --request POST \
--url https://agents.lumalabs.ai/v1/skills/example/versions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form file=@file \
--form files=@file \
--form scope_id=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0

Publish a new version from a bundle; its SKILL.md must keep the skill's name.

A bundle identical to the latest version, file for file, publishes nothing and answers 200 with that version.

skill_id
required
Skill Id
string
Media typemultipart/form-data
object
file

The bundle as one zip.

string format: binary
files

The bundle's files, each part's filename its path inside the bundle.

Array<string>
scope_id

Make this a workspace skill. Ignored when publishing a version.

string format: uuid

Successful Response

Media typeapplication/json
ClientSkillVersion

One immutable version of a skill and the files it holds.

object
created_at
required
Created At
string format: date-time
file_count
required
File Count
integer
files
required
Files
Array<object>
ClientSkillFile

One file of a published version, as recorded on its version row.

object
kind
required
ClientSkillFileKind
string
Allowed values: skill_md reference asset
path
required
Path
string
sha256
required
Sha256
string
size
required
Size
integer
skill_id
required
Skill Id
string format: uuid
total_bytes
required
Total Bytes
integer
version
required
Version
integer
Example
{
"files": [
{
"kind": "skill_md"
}
]
}

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
"detail": [
{
"ctx": {},
"input": "example",
"loc": [
"example"
],
"msg": "example",
"type": "example"
}
]
}