Skip to main content
Update Agent
curl --request PUT \
  --url https://labs.chonkie.ai/api/v1/agents/{agent_slug}
{
  "agent": {}
}
Update an existing agent’s configuration.

​
Examples

import requests

agent_slug = "documentation-assistant"
url = f"https://labs.chonkie.ai/api/v1/agents/{agent_slug}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

data = {
    "model": "gpt-4o",
    "temperature": 0.5
}

response = requests.put(url, headers=headers, json=data)
result = response.json()

print(f"Updated agent: {result['agent']['name']}")
print(f"New model: {result['agent']['model']}")

​
Request

​
Path Parameters

​
agent_slug
string
required
The slug of the agent to update.

​
Body Parameters

All parameters are optional. Only include fields you want to update.
​
name
string
New agent name.
​
description
string
New description.
​
model
string
Change the LLM model.
​
systemPrompt
string
Update system prompt.
​
maxContextChunks
integer
Change max context chunks.
​
useContext
boolean
Enable/disable context injection.
​
knowledge
string
Change knowledge base.

​
Response

​
Returns

​
agent
object
Updated agent 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.