Skip to content

Create a skill — personal by default; pass visibility: "shared" to publish it to the workspace

POST
/api/v1/workspaces/{ws}/skills
Media typeapplication/json
object
name
required
string
>= 1 characters <= 100 characters
description
required
string
>= 1 characters <= 500 characters
when_to_use
required
string
>= 1 characters <= 1000 characters
instructions
required
string
>= 1 characters <= 20000 characters
examples
Array<object>
default: <= 20 items
object
input
required
string
>= 1 characters <= 2000 characters
output
required
string
>= 1 characters <= 4000 characters
allowed_tools
Array<string>
default: <= 50 items
visibility
string
default: personal
Allowed values: personal shared
source_template
string
<= 100 characters