Skip to main content
POST
/
api
/
v1
/
skills
Install Skill
curl --request POST \
  --url https://api.example.com/api/v1/skills \
  --header 'Content-Type: application/json' \
  --data '
{
  "skillId": "<string>"
}
'
Install a skill from the marketplace. Once installed, the skill is automatically loaded on every completion request.

​
Authentication

Requires a Bearer token. See Authentication.

​
Request Body

​
skillId
string
required
UUID of the skill to install.

​
Request Examples

curl -X POST https://hitheo.ai/api/v1/skills \
  -H "Authorization: Bearer $THEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"skillId": "skill_abc123"}'

​
Response (HTTP 201)

{ "installed": true }

​
Uninstall

To uninstall a skill, send a DELETE request with the same body: 
curl -X DELETE https://hitheo.ai/api/v1/skills \
  -H "Authorization: Bearer $THEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"skillId": "skill_abc123"}'

​
Errors

StatusCodeDescription
400validation_errorInvalid skillId format (must be UUID)
404not_foundSkill not found