skills

Create a new skill

Changed on
post/skills

Request

  • The document declares no server URL.
  • Auth: none declared

Request body

namestring required

The name of the skill (must be unique per user). No leading/trailing whitespace, no consecutive spaces, no control characters. Max 100 characters.

shortDescriptionstring required

A short description of the skill (shown in system prompt for LLM to decide activation)

instructionsstring required

Detailed instructions for the skill (injected when the skill is activated)

ownerType'personal' | 'workspace' required
workspaceIdstring uuid
isActiveboolean

Whether a personal skill is active (defaults to true)

Example request

{
  "name": "Legal Research",
  "shortDescription": "Research legal topics, find relevant case law, and draft legal documents.",
  "instructions": "You are a legal research assistant. When activated, search through the attached legal databases...",
  "isActive": true
}

Response

idstring uuid required
ownerType'personal' | 'workspace' required
userIdstring uuid
workspaceIdstring uuid
namestring required
shortDescriptionstring required
instructionsstring required
marketplaceIdentifierstring nullable required
isActiveboolean required
createdAtstring date-time required
updatedAtstring date-time required
isSharedboolean required
isPinnedboolean required
creatorNamestring nullable required

Changes

    • breaking

      added the new required request property

    • breaking

      the response property became optional for the status

    • info

      added the new optional request property

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status