Skip to main content
GET
cURL

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

Query Parameters

includeBuiltIn
string
Allowed value: "true"

Response

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

userId
string | null
required

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

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

source
object
required

Origin and ownership semantics for this skill

updatedByUserId
string | null

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

createdBy
object | null

Display identity of the user that created this skill

updatedBy
object | null

Display identity of the user that last edited this skill

displayName
string

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

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