Skip to main content
GET
/
api
/
skills
cURL
curl -X GET "https://app.cotool.ai/api/skills" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
[
  {
    "id": "<string>",
    "organizationId": "<string>",
    "name": "<string>",
    "description": "<string>",
    "requiredTools": [
      "<string>"
    ],
    "createdByUserId": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "deletedAt": "<string>",
    "usedByAgentCount": 123,
    "invocationCount30d": 123,
    "currentVersion": 123
  }
]

Authorizations

​
Authorization
string
header
required

API Key authentication for programmatic access. Include your API key in the Authorization header as: Bearer your_api_key_here

Response

200 - application/json

Successful response

​
id
string
required

Unique identifier for the skill

​
organizationId
string
required

Unique identifier of the organization that owns this skill

​
name
string
required

Machine-safe skill name used in sandbox paths and imports

Required string length: 1 - 64
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
​
description
string
required

Description of what this skill teaches an agent to do

​
requiredTools
string[]
required

Optional required tool types for this skill

​
createdByUserId
string | null
required

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

​
createdAt
string
required

Timestamp when the skill was created

​
updatedAt
string
required

Timestamp when the skill was last updated

​
deletedAt
string | null
required

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

​
usedByAgentCount
number

How many agents currently use this skill

​
invocationCount30d
number

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

​
currentVersion
number

Current version number of this skill