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"