Skip to main content
GET
List Agents

Overview

List all agents owned by the API key holder with pagination, search, and filtering by type and category.

Authentication

string
required
Your eigi.ai API key. Must be prefixed with vk_.

Query Parameters

integer
default:"1"
Page number (minimum: 1).
integer
default:"10"
Items per page (minimum: 1, maximum: 100).
Search in agent name and description.
string
Filter by agent type: INBOUND or OUTBOUND.
string
Filter by agent category (e.g., Customer Service, Sales).

Response

array
Array of agent objects — each containing the full agent configuration (id, name, type, STT/LLM/TTS config, prompt, tools, etc.).
integer
Total number of agents matching the criteria.
integer
Current page number.
integer
Number of items per page.
integer
Total number of pages available.

Authorizations

X-API-Key
string
header
required

API key for authentication. Get your API key from the eigi.ai Dashboard under Settings → API Keys.

Query Parameters

page
integer
default:1

Page number

Required range: x >= 1
page_size
integer
default:10

Items per page (max: 100)

Required range: 1 <= x <= 100

Search in agent name and description

agent_type
enum<string>

Filter by agent type

Available options:
INBOUND,
OUTBOUND
agent_category
string

Filter by agent category

Response

Successfully retrieved agents

agents
object[]
total
integer
page
integer
page_size
integer
total_pages
integer