Skills

Create Skill

Creates a new skill in your organization.

post/api/skills

Request

  • Base URL: https://app.withwillow.ai
  • URL: https://app.withwillow.ai/api/skills
  • Auth: HTTP bearer

Request body

namestring required
slugstring required
descriptionstring
contentstring

Skill content in Markdown format

status'active' | 'draft'
metadataobject
allowed_toolsstring[]

Example request

{
  "name": "My Skill",
  "slug": "my-skill"
}

Response

Skill created successfully

Example response

{
  "data": {
    "id": "sk_abc123",
    "slug": "my-skill",
    "name": "My Skill",
    "description": "A custom skill",
    "status": "active",
    "created_at": "2026-01-15T09:30:00Z",
    "is_org": true,
    "org_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "updated_at": "2026-01-15T09:30:00Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.