Agents API
Create, read, update, and delete AI agents programmatically.
Base URL
https://ai-teammate.net/apiGET
/agentsReturns a list of all agents owned by the authenticated user.
Response
200 OK
[
{
"id": "agent_abc123",
"name": "Finance Assistant",
"description": "Helps with investment analysis",
"personality": "professional",
"tone": "formal",
"status": "active",
"skills": ["core", "finance"],
"user_count": 150,
"message_count": 2340,
"created_at": "2026-02-14T10:00:00Z"
}
]GET
/agents/:idReturns details of a specific agent.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
id | string | The agent's unique identifier |
POST
/agentsCreates a new agent.
Request Body
JSON
{
"name": "My Agent",
"description": "A helpful assistant",
"personality": "friendly",
"tone": "casual",
"skills": ["core", "search"]
}Body Parameters
| Field | Type | Required | Description |
|---|---|---|---|
name | string | ✅ | Agent name (1-100 chars) |
description | string | - | Brief description |
personality | string | - | e.g., "friendly", "professional" |
tone | string | - | e.g., "casual", "formal" |
skills | string[] | - | Array of skill IDs |
system_prompt | string | - | Custom system prompt |
PUT
/agents/:idUpdates an existing agent. Only provided fields will be updated.
DELETE
/agents/:idPermanently deletes an agent and all its data.
⚠️ This action is irreversible. All conversations and integrations will be lost.
Available Skills
| Skill ID | Name | Description |
|---|---|---|
search | Web Search | Naver + Tavily AI search |
news | News | News search, save, and summarize |
bookmark | Bookmark | URL save & management |
education | Education | Flashcards & spaced repetition |
stock | Stock / Finance | Market data & analysis |
weather | Weather | Weather information |
reminder | Reminder | Scheduled reminders |
image_gen | Image Generation | AI image creation (DALL-E) |
code_exec | Code Execution | Run code snippets |
web_scrape | Web Scrape | Extract web content |
Additional Endpoints
Channel Integrations
Connect agents to Telegram, Discord, and webhooks.
GET
/agents/:id/integrationsList active integrationsPOST
/agents/:id/integrations/telegram/connect-codeGenerate 6-char Telegram connect code (5 min TTL)POST
/agents/:id/integrations/discord/connect-codeGenerate Discord connect codePOST
/agents/:id/integrationsAdd integration (channel, config)DELETE
/agents/:id/integrations/:channelRemove integrationAPI Keys
Manage API keys for programmatic agent access.
GET
/agents/:id/api-keysList API keysPOST
/agents/:id/api-keysCreate API key (returns key once)DELETE
/agents/:id/api-keys/:key_idRevoke API keyDocuments & Memory (RAG)
Upload documents and manage agent memory for context-aware responses.
POST
/agents/:id/documents/uploadUpload document (PDF, DOCX, TXT)GET
/agents/:id/documentsList uploaded documentsDELETE
/agents/:id/documents/:doc_idDelete documentPOST
/agents/:id/documents/import-urlImport document from URLGET
/agents/:id/memoriesList agent memoriesPOST
/agents/:id/memoriesCreate memory entryPUT
/agents/:id/memories/:memory_idUpdate memoryDELETE
/agents/:id/memories/:memory_idDelete memoryShare Links
Create public links to let anyone chat with your agent.
POST
/agents/:id/shareCreate public share linkGET
/agents/:id/sharesList share linksDELETE
/agents/:id/shares/:share_idRevoke share link