v1

latestOpenAPI 3.0.02026-07-26492143.5 KB

Skills

List skills

List skills the caller has access to. Filter by team, search by name, or narrow to a specific creator, related MCP server, or agent.

get/skills

Query parameters

team_idstring

Scope the listing to a single team. When omitted, returns skills owned by the authenticated user.

search_querystring

Case-insensitive substring match against the skill name.

sort_order'newest' | 'popular' | 'most_used'

Sort order for the returned skills.

page_sizeinteger

Number of skills per page. Clamped between 1 and 100.

cursorstring

Opaque pagination cursor returned in next_cursor from a prior page.

creator_user_idstring

Filter to skills created by this user ID.

related_server_idstring

Filter to skills that reference this MCP server ID in their metadata.

agent_idstring

Filter to skills attached to this agent.

unusedstring

When set, filters to skills that have not been used.

Response

Skills matching the provided filters.

next_cursorstring nullable

Opaque cursor for the next page, or null when there are no more results.

total_countinteger nullable

Total number of skills matching the filters across all pages.

Example response

{
  "skills": [
    {
      "id": "skill_x7y8z9",
      "name": "Lead enrichment",
      "description": "Enriches inbound leads with firmographics.",
      "team_id": "team_4f8c92ab",
      "created_at": "2026-05-15T14:32:00Z",
      "updated_at": "2026-05-16T09:10:00Z",
      "usage_count": 42,
      "view_count": 117,
      "last_used_at": "2026-05-18T22:01:00Z",
      "version_id": "sv_a1b2c3d4",
      "major_version": 3,
      "is_deployed": true,
      "version_created_at": "2026-05-16T09:10:00Z"
    }
  ]
}