Skip to navigation
Gateway APISkills

Create a skill or a new version of it

View as Markdown

Create a skill file (markdown, up to 5 MB). To upload a new version of a skill file, pass its fileId. To change only a part of a skill file, use edit_skill. A new skill file goes to the General folder unless you give a folderId. Requires write access.

Authentication

AuthorizationBearer

A Basement key (bsmt_...), from Agents, Connect in the app.

Request

This endpoint expects an object.
namestringRequired

File name, e.g. account-research.skill.md

contentstringRequired
The skill's full markdown content
fileIdstringOptional

Optional ID of the skill file to update, from list_skills

folderIdstringOptional

Optional folder for a new skill file, from list_folders. You must have write access to it. Ignored with fileId

Response

The tool's answer.
idstringOptional

The new file's ID (when a file was created)

versionCountintegerOptional

The file's new version (when a file was replaced)

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error
500
Internal Server Error