Skip to main content
List Agents
curl --request GET \
  --url https://api.example.com/labs.chonkie.ai/api/v1/agents
Retrieve a list of all AI agents in your organization.

​
Examples

import requests

url = "https://labs.chonkie.ai/api/v1/agents"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
agents = response.json()

print(f"Found {len(agents)} agents")
for agent in agents:
    print(f"- {agent['name']} ({agent['slug']})")
    print(f"  Model: {agent['model']}")

​
Request

This endpoint takes no parameters.

​
Response

​
Returns

Array of agent objects with full configuration. Each agent object contains the following fields Basic Information
​
id
string
Unique agent identifier.
​
slug
string
URL-friendly unique identifier for the agent.
​
name
string
Display name of the agent.
​
description
string
Description of the agent’s purpose and capabilities.
​
status
string
Agent status (active, inactive, etc.).
Model Configuration
​
model
string
The LLM model used by the agent.
​
systemPrompt
string
System prompt that defines the agent’s behavior and personality.
​
temperature
float
Temperature setting for response randomness (0.0-2.0).
Knowledge Integration
​
useContext
boolean
Whether knowledge base context injection is enabled.
​
knowledge
string
Slug of the connected knowledge base (if any).
​
maxContextChunks
integer
Maximum number of knowledge base chunks to include in context.
Metadata
​
organizationSlug
string
Organization that owns this agent.
​
metadata
object
Additional custom metadata.
​
createdAt
string
Timestamp when the agent was created.
​
updatedAt
string
Timestamp when the agent was last updated.