Create Skill
POST
/v1/skills
const url = 'https://agents.lumalabs.ai/v1/skills';const form = new FormData();form.append('file', 'file');form.append('files', 'file');form.append('scope_id', '2489E9AD-2EE2-8E00-8EC9-32D5F69181C0');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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-32D5F69181C0Create 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.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”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
Responses
Section titled “ Responses ”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
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>
ValidationErrorobject
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" } ]}