---
title: "List agents using skill"
method: GET
path: "/api/skills/{skillId}/agents"
tags: ["Skills"]
---

# List agents using skill

`GET /api/skills/{skillId}/agents`

## Request

- Base URL: `https://app.cotool.ai`
- URL: `https://app.cotool.ai/api/skills/{skillId}/agents`
- Auth: HTTP bearer

List all agents currently using this skill.

## Path parameters

- `skillId` string, uuid, required: Unique identifier for the skill

## Response `200`

Successful response

- object[]
  - `id` string, uuid, required: Unique identifier for the agent
  - `name` string, required: Agent name
  - `description` string, required: Agent description
  - `agentType` 'response' | 'detection', required: Agent type
  - `updatedAt` string, required: Timestamp when the agent was last updated
  - `invocationCount30d` number, required: How many times this skill was invoked by the agent in the last 30 days

## Other responses

- `400`: Bad request — input validation failed or the request was malformed
- `401`: Unauthorized — missing or invalid API key / session
- `403`: Forbidden — the authenticated user lacks the required permissions
- `500`: Internal server error

---

[API](https://skmtc.dev/cotool/apis/cotool-api.md) - [All operations](https://skmtc.dev/cotool/apis/cotool-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cotool/apis/cotool-api/revisions/f5abe0add203?raw)