Skip to main content
POST
Create a new skill

Authorizations

X-API-Key
string
header
required

[Production] API key for production authentication

Body

application/json

Skill data

projectId
string
required

MongoDB ObjectID represented as a hex string

builtinSlug
string
Example:

"my-skill-slug"

bundledTools
string[]
compatibility
string
description
string
instructions
string
license
string
metadata
object
name
string
resources
object[]
source
string

Source selects the creation flow. Empty or "user" creates a user-defined skill from the body fields. "builtin" instantiates from the builtin skill catalog identified by BuiltinSlug; in that case Name/Description/Instructions/etc. are taken from the catalog and any values provided in the body are ignored.

Example:

"user"

Response

Created

builtinSlug
string
Example:

""

bundledTools
string[]
compatibility
string
createdAt
integer
createdBy
string
Example:

"507f1f77bcf86cd799439011"

description
string
id
string
Example:

"507f1f77bcf86cd799439011"

instructions
string
lastChangedAt
integer
lastChangedBy
string
Example:

"507f1f77bcf86cd799439011"

license
string
metadata
object
name
string
organisationId
string
Example:

"507f1f77bcf86cd799439011"

projectId
string
Example:

"507f1f77bcf86cd799439011"

referenceId
string
resources
object[]
source
string
Example:

"user"