createSkill

POST

/api/v1/workspaces/{workspaceId}/skills

Workspace admins only.

createSkill

curl --request POST \
  --url '<base-url>/api/v1/workspaces/<workspaceId>/skills' \
  --header 'Content-Type: application/json' \
  --cookie 'agenthold_session=<agenthold_session>' \
  --data '
{
  "name": "string",
  "description": "string",
  "content": "string"
}
'

const url = '<base-url>/api/v1/workspaces/<workspaceId>/skills';
const options = {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    cookie: 'agenthold_session=<agenthold_session>'
  },
  body: JSON.stringify({name: 'string', description: 'string', content: 'string'})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "<base-url>/api/v1/workspaces/<workspaceId>/skills"

payload = {
    "name": "string",
    "description": "string",
    "content": "string"
}
headers = {
    "cookie": "agenthold_session=<agenthold_session>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Response example

{
  "name": "string",
  "description": "string",
  "content": "string",
  "id": "string",
  "workspaceId": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

Authorization

session
optional
API key in cookie

token
optional
HTTP Bearer
Authorization: Bearer <token>

Path parameters

workspaceId
string
required

Request body JSON required

name
string
required
Lowercase letters, digits and dashes.
description
string
required
When the agent should use the skill.
content
string
required
The SKILL.md instructions (Markdown).

Returns

201

Created.

JSON

name
string
required
Lowercase letters, digits and dashes.
description
string
required
When the agent should use the skill.
content
string
required
The SKILL.md instructions (Markdown).
id
string
required
workspaceId
string
required
createdAt
string
required
format: date-time
updatedAt
string
required
format: date-time

400

Error.

JSON

error
string
required

403

Error.

JSON

error
string
required

404

Error.

JSON

error
string
required

409

Error.

JSON

error
string
required