Skip to main content
POST
/
skills
/
upload
Upload a skill
curl --request POST \
  --url https://api.lava.so/v1/skills/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "skill_name": "my-skill",
  "files": [
    {
      "path": "SKILL.md",
      "type": "md",
      "content": "<string>"
    }
  ]
}
'
{
  "success": true,
  "skill_name": "my-skill",
  "file_count": 3,
  "message": "Skill \"my-skill\" uploaded successfully (3 files)."
}

Documentation Index

Fetch the complete documentation index at: https://lava.so/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer token authentication used for standard API calls. Format: 'Bearer YOUR_API_KEY'

Body

application/json
​
skill_name
string
required

Kebab-case skill name (lowercase letters, numbers, and hyphens)

Required string length: 1 - 100
Pattern: ^[a-z0-9]+(-[a-z0-9]+)*$
Example:

"my-skill"

​
files
object[]
required

Files to include in the skill

Required array length: 1 - 20 elements

Response

Skill uploaded successfully

​
success
boolean
required
Example:

true

​
skill_name
string
required
Example:

"my-skill"

​
file_count
integer
required
Example:

3

​
message
string
required
Example:

"Skill \"my-skill\" uploaded successfully (3 files)."