Install Skill - Theo API Docs

POST

api

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://www.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://www.hitheo.ai/api/v1/skills \
  -H "Authorization: Bearer $THEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"skillId": "skill_abc123"}'

Errors

Status	Code	Description
400	`validation_error`	Invalid `skillId` format (must be UUID)
404	`not_found`	Skill not found

List Skills

Create Skill

⌘I

Install Skill

curl --request POST \
  --url https://api.example.com/api/v1/skills \
  --header 'Content-Type: application/json' \
  --data '
{
  "skillId": "<string>"
}
'

​Authentication

​Request Body

​Request Examples

​Response (HTTP 201)

​Uninstall