Create a skill — shared with the workspace by default, whether a person or an agent (token, connected AI) creates it. An agent can also share it with named workspace members; making one public only raises an approval a person must give. A workspace admin can switch agent publishing off, after which an agent-authored skill is created personal

POST

/api/v1/workspaces/{ws}/skills

Request Body^required

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

visibility

string

Allowed values: personal members shared public

member_ids

Array<string>

<= 100 items

version

string

<= 64 characters /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/

source_template

string

<= 100 characters

Responses

201