Skip to content
Agents
Skills

Create Skill

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

Create a skill from a bundle and publish it as version 1.

Multipart: either file (one zip) or files (one part per file, each filename its path inside the bundle — SKILL.md, references/<name>.md, assets/<name>.<ext>). An optional scope_id makes it a workspace skill; only a workspace skill may carry assets.

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
ClientSkill

One skill. Its content lives in its versions.

object
created_at
required
Created At
string format: date-time
description
required
Description

The latest version's description.

string
id
required
Id
string format: uuid
latest_version
required
Latest Version
integer
name
required
Name

The name in the skill's SKILL.md frontmatter.

string
scope_id
required
Any of:
string format: uuid
updated_at
required
Updated At
string format: date-time
Examplegenerated
{
"created_at": "2026-04-15T12:00:00Z",
"description": "example",
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"latest_version": 1,
"name": "example",
"scope_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"updated_at": "2026-04-15T12:00:00Z"
}

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"
}
]
}