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

# List agents

`GET /api/v1/agents`

## Request

- Base URL: `https://dashboard.sealgate.ai`
- URL: `https://dashboard.sealgate.ai/api/v1/agents`
- Auth: HTTP bearer

List registered agents. ADMIN sees domain agents; OWNER sees all. Requires the admin role.

## Query parameters

- `page` integer
- `per_page` integer
- `q` string
- `agent_type` string
- `include_archived` boolean

## Response `200`

A page of agent summaries

- AgentSummaryPage
  - `items` AgentSummary[], required
    - `id` integer, required: Agent primary key
    - `name` string, required: Unique agent name
    - `agent_id` string, required: Unique agent identifier in agent:HEX format
    - `agent_type` string, nullable: Agent type or category
    - `domain` string, required: Email domain the agent belongs to
    - `archived` boolean, required: Whether the agent is archived
    - `created_at` string, date-time, required
  - `total` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `total_pages` integer, required

## Other responses

- `401`: Missing or invalid API key
- `403`: The caller's role is not permitted to perform this action
- `422`: Request validation failed

---

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