Create Skill

POST/v1/skills

Create a reusable Skill resource from an uploaded bundle or Git source.

Request body

stringnamerequired

Display name, up to 100 characters.

Optional<string>description

Description, up to 1,000 characters.

Optional<string[]>categories

Category labels.

Optional<string>skill_file_url

URL returned by /v1/skills/files. Required when git_url is absent.

Optional<string>git_url

Git source URL. Required when skill_file_url is absent.

Optional<string[]>preview_image_urls

Preview image URLs.

curl -X POST https://api.sandbase.ai/v1/skills \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "release-notes",
    "description": "Draft concise release notes",
    "categories": ["writing"],
    "skill_file_url": "https://media.sandbase.ai/_private/.../release-notes.zip"
  }'

Response200 OK

{
  "id": "skill_01...",
  "name": "acme/release-notes",
  "display_name": "release-notes",
  "vendor_slug": "acme",
  "plugin_slug": "release-notes",
  "icon_url": "",
  "preview_urls": [],
  "created_at": "2026-08-03T10:00:00Z"
}