Skip to main content
POST
/
api
/
capabilities
/
add-capability
curl -X POST https://app.openhome.com/api/capabilities/add-capability/ \
  -H "X-API-KEY: YOUR_KEY" \
  -F "name=My Skill" \
  -F "category=skill" \
  -F "description=Greets the user" \
  -F "trigger_words=hey skill, activate skill" \
  -F "zip_file=@./my-skill.zip"
This endpoint uses multipart/form-data. Names must be unique on your account — calling this with an existing name returns Ability with same name already exists. Delete the existing Ability first to replace.
​
X-API-KEY
string
required
Your OpenHome API key.
​
name
string
required
Ability name. Must be unique on your account.
​
category
string
required
One of skill, background, or brain.
​
description
string
required
One-line description.
​
trigger_words
string
required
Comma-separated trigger phrases. Example: hey skill, activate skill.
​
zip_file
file
required
Zipped Ability package. Accepted content types: application/zip, application/x-zip, application/x-zip-compressed, application/octet-stream.
​
image_file
file
Optional icon.
curl -X POST https://app.openhome.com/api/capabilities/add-capability/ \
  -H "X-API-KEY: YOUR_KEY" \
  -F "name=My Skill" \
  -F "category=skill" \
  -F "description=Greets the user" \
  -F "trigger_words=hey skill, activate skill" \
  -F "zip_file=@./my-skill.zip"