skills

Update a skill

Changed on
put/skills/{id}

Request

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

Path parameters

idstring required

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)

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..."
}

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

  • fb52cc48a7faRevision changes
    • breaking

      the response property became optional for the status

    • info

      for the path request parameter id, the format was generalized from uuid to no format

    • info

      removed the non-success response with the status

    • 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