COcotool
Skills

Update skill

Update an existing skill.

put/api/skills/{skillId}

Request

  • Base URL
    https://app.cotool.ai
  • Auth
    HTTP bearer

Path parameters

skillIdstring uuid required

Unique identifier for the skill

Request body

namestring

Machine-safe skill name used in sandbox paths and imports

descriptionstring

Updated skill description

instructionPromptstring

Updated instruction prompt content

requiredToolsstring[]

Updated required tool types

Response

Successful response

idstring required

Unique identifier for the skill

organizationIdstring required

Unique identifier of the organization that owns this skill

namestring required

Machine-safe skill name used in sandbox paths and imports

descriptionstring required

Description of what this skill teaches an agent to do

requiredToolsstring[] required

Optional required tool types for this skill

userIdstring nullable required

User ID that owns this user-scoped skill, or null for organization skills

createdByUserIdstring nullable required

User ID that created this skill, or null for system-created records

updatedByUserIdstring nullable

User ID that last edited this skill, or null for system edits or unknown authorship

createdAtstring required

Timestamp when the skill was created

updatedAtstring required

Timestamp when the skill was last updated

deletedAtstring nullable required

Timestamp when the skill was soft-deleted, or null if active

displayNamestring

Human-readable skill name when it differs from the machine-safe name

usedByAgentCountnumber

How many agents currently use this skill

invocationCount30dnumber

Distinct chats in the last 30 days where an agent read this skill from the sandbox

currentVersionnumber

Current version number of this skill

instructionPromptstring required

Primary instruction prompt content for this skill

Changes

No recorded changes to this operation across all 2 revisions of this API.