Skills API

Create and manage reusable AI skills that can be triggered via slash commands in chat. Skills allow you to define custom prompt templates that users can invoke to perform specialized tasks, such as SQL query generation, data analysis, or domain-specific assistance.

What's New

Full CRUD operations for account-level skills
Version history tracking for skills (immutable versions)
Per-workspace skill assignment and configuration
Workspace-level toggle to enable/disable all skills
Optional includeCreatedByEmail parameter for listing skills with creator information

New Endpoints

Account Skills (CRUD)

Method	Endpoint	Description
`GET`	`/api/v1/accounts/{accountId}/skills`	List all skills
`POST`	`/api/v1/accounts/{accountId}/skills`	Create a new skill
`GET`	`/api/v1/accounts/{accountId}/skills/{skillId}`	Get a skill
`POST`	`/api/v1/accounts/{accountId}/skills/{skillId}`	Update a skill (creates new version)
`DELETE`	`/api/v1/accounts/{accountId}/skills/{skillId}`	Delete a skill

Skill Versions

Method	Endpoint	Description
`GET`	`/api/v1/accounts/{accountId}/skills/{skillId}/versions`	List all versions
`GET`	`/api/v1/accounts/{accountId}/skills/{skillId}/versions/{versionId}`	Get a specific version
`DELETE`	`/api/v1/accounts/{accountId}/skills/{skillId}/versions/{versionId}`	Delete a version

Workspace Skills Assignment

Method	Endpoint	Description
`GET`	`/api/v1/accounts/{accountId}/workspaces/{workspaceId}/skills`	List skills for workspace
`POST`	`/api/v1/accounts/{accountId}/workspaces/{workspaceId}/skills/{skillId}`	Enable skill for workspace
`DELETE`	`/api/v1/accounts/{accountId}/workspaces/{workspaceId}/skills/{skillId}`	Disable skill for workspace

Modified Endpoint

PATCH /api/v1/accounts/{accountId}/workspaces/{workspaceId} - Added skillsEnabled field

Skill Object

{
  "id": "version-uuid",
  "skillId": "skill-uuid",
  "accountId": "account-uuid",
  "version": 1,
  "name": "SQL Query Helper",
  "command": "/sql-helper",
  "description": "Helps generate SQL queries from natural language",
  "instructions": "You are a SQL assistant. Help the user write queries.",
  "autoDetect": false,
  "createdAt": "2026-01-27T10:30:00Z",
  "createdBy": "user-uuid",
  "createdByEmail": "[email protected]"
}

Note: The createdByEmail field is optional and only included when the includeCreatedByEmail=true query parameter is provided in the list request.

Create Skill Request

{
  "name": "SQL Query Helper",
  "command": "/sql-helper",
  "description": "Helps generate SQL queries from natural language",
  "instructions": "You are a SQL assistant. Help the user write queries for the given context.",
  "autoDetect": false
}

Enable/Disable Skills for Workspace

Toggle skills availability at the workspace level:

curl -X PATCH \
  'https://api.bobsled.ai/api/v1/accounts/{accountId}/workspaces/{workspaceId}' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"skillsEnabled": false}'

Assign Skill to Workspace

curl -X POST \
  'https://api.bobsled.ai/api/v1/accounts/{accountId}/workspaces/{workspaceId}/skills/{skillId}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Getting Started

Create a skill at the account level
Assign the skill to one or more workspaces
Users can invoke the skill via the slash command in chat (e.g., /sql-helper)