SandboxConfig

Install a skill

Changed on

Install a skill onto this sandbox config's image. Send a zip as multipart form field "file", or JSON {"source":"..."} to pull a public skill. source is one of: "@owner/slug" or a slash-free slug (ClawHub), a github.com / gitlab.com / skills.sh / clawhub / skillhub URL, a ClawHub skills-sh catalog page (https://clawhub.ai/skills-sh/owner/repo/slug), a skills-sh:owner/repo/slug locator, or a direct zip/SKILL.md URL. Bare "owner/slug" is rejected as ambiguous. The source must be readable anonymously. The install boots a sandbox and runs for minutes, so the request is only accepted; follow it via the install-events stream.

post/sandbox-configs/{id}/skills

Request

  • Base URL
    /api/v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/v1/sandbox-configs/{id}/skills
  • Auth
    • API key in header Authorization
    • or API key in header X-API-Key

Path parameters

idstring required

Sandbox config ID: the agent's sandbox_config_id, or host on WeKnora Lite

Request body multipart/form-data

filestring binary

Skill bundle (zip)

Response

Install accepted

successboolean

Example response

{
  "success": true
}

Changes