API Documentation
  1. Bobsled AI API
  2. Skills

Update skill (create new version)

post
https://{tenant}.bobsled.ai/api/v1/accounts//skills/

Creates a new version of an existing skill. Use this to update the name, command, instructions, or other fields while maintaining version history. Supports optimistic locking via baseVersion parameter.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

The ID of the account

uuid
required

The skill ID (identifies which skill, stable across versions)

Body Params
string
length between 1 and 255

Display name of the skill

string
length between 2 and 50
^\/[a-z0-9][a-z0-9_-]*$/i

Slash command trigger (must start with /, alphanumeric with hyphens/underscores)

string
length ≤ 1000

Optional description of the skill

string
length between 1 and 50000

Prompt template for the skill

boolean

Whether the skill should auto-detect when to activate

inputSchema
object | null

Input parameter schema. Set to null to remove, omit to keep existing.

actions
object | null

Action definitions for external API integrations. Set to null to remove all actions, or omit to keep existing actions.

toolRefs
array of objects | null

Saved account-level tool references exposed to the skill. Replaces existing refs when provided; omit to keep existing refs.

toolRefs
workflowIds
array of uuids

IDs of standalone workflows to link to this skill version. If provided, replaces all existing links. If omitted, inherits links from previous version.

workflowIds
autoTriggerWorkflowIds
array of uuids
length ≤ 10

Subset of workflowIds that auto-execute before the LLM reasons about this skill. Must be a subset of workflowIds; both must be provided together. Max 10 entries.

autoTriggerWorkflowIds
integer

Expected current version for optimistic locking (optional)

boolean

Whether this version is deployed (live) or a draft. Defaults to false for saves, true for deploys.

uuid

Database user ID to record as the creator of the new version. Only honored for agent (M2M) callers; ignored for user-token callers (the authenticated user is used instead).

Responses

Updated 4 months ago

Did this page help you?
Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 4 months ago

Did this page help you?