---
title: "List agents"
method: GET
path: "/agents"
tags: ["Agents"]
---

# List agents

`GET /agents`

List agents the caller has access to. Filter by team, search by name, or narrow to agents that use a specific tool or trigger.

## Query parameters

- `team_id` string
- `search` string
- `creator` string
- `has_triggers` boolean
- `tool` string
- `flow` string

## Response `200`

Agents matching the provided filters.

- object
  - `agents` object[]
    - `id` string — Unique agent identifier.
    - `name` string
    - `description` string
    - `team_id` string — ID of the team that owns the agent.
    - `is_active` boolean
    - `model_name` string — ID of the LLM the agent runs on.
    - `system_prompt` string
    - `tools` object[] — Tools the agent can call. Secret references are stripped before being returned.
    - `resources` object[]
    - `metadata` object
    - `folder_id` string
    - `created_at` string, date-time — ISO 8601 timestamp of when the agent was created.
    - `active_trigger_count` integer — Number of active triggers on this agent.
  - `next_cursor` string — Reserved for future cursor-based pagination. Currently always `null`.

## Other responses

- `401` — Unauthorized — missing or invalid API key.
- `403` — Forbidden — the caller does not have agent access on the requested team.
- `500` — Internal server error.

---

[API](https://skmtc.dev/gumloop/apis/public-api.md) · [All operations](https://skmtc.dev/gumloop/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gumloop/public-api/revisions/115f2d6ce387/schema)