Skip to main content
GET
/
skills
cURL
curl 'https://api.gumloop.com/api/v1/skills?team_id=YOUR_TEAM_ID' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
{
  "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",
      "metadata": {
        "related_server_ids": [
          "apollo"
        ]
      },
      "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",
      "creator": {
        "id": "user_2b9d71f0",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "email": "ada@example.com",
        "profile_picture": null
      }
    },
    {
      "id": "skill_p4q5r6",
      "name": "Ticket triage",
      "description": "Classifies and routes support tickets.",
      "team_id": "team_4f8c92ab",
      "created_at": "2026-04-02T09:11:00Z",
      "updated_at": "2026-04-02T09:11:00Z",
      "metadata": {},
      "usage_count": 0,
      "view_count": 5,
      "last_used_at": null,
      "version_id": "sv_e5f6g7h8",
      "major_version": 1,
      "is_deployed": false,
      "version_created_at": "2026-04-02T09:11:00Z",
      "creator": {
        "id": "user_2b9d71f0",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "email": "ada@example.com",
        "profile_picture": null
      }
    }
  ],
  "next_cursor": null,
  "total_count": 2
}

Documentation Index

Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

A personal API key or an OAuth 2.0 access token. Personal API keys also require the x-auth-key header with your user ID.

Query Parameters

​
team_id
string

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

​
search_query
string

Case-insensitive substring match against the skill name.

​
sort_order
enum<string>
default:newest

Sort order for the returned skills.

Available options:
newest,
popular,
most_used
​
page_size
integer
default:20

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

Required range: 1 <= x <= 100
​
cursor
string

Opaque pagination cursor returned in next_cursor from a prior page.

​
creator_user_id
string

Filter to skills created by this user ID.

​
related_server_id
string

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

​
agent_id
string

Filter to skills attached to this agent.

​
unused
string

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

Response

Skills matching the provided filters.

​
skills
object[]
​
next_cursor
string | null

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

​
total_count
integer | null

Total number of skills matching the filters across all pages.