Agents API

Create, read, update, and delete AI agents programmatically.

Base URL

https://agent.mobiolabs.net/api

GET/agents

Returns 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/:id

Returns details of a specific agent.

Path Parameters

Parameter	Type	Description
`id`	string	The agent's unique identifier

POST/agents

Creates 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/:id

Updates an existing agent. Only provided fields will be updated.

DELETE/agents/:id

Permanently deletes an agent and all its data.

⚠️ This action is irreversible. All conversations and integrations will be lost.

Available Skills

Skill ID	Name	Description
`core`	Core	Memory and context (always included)
`search`	Web Search	Search the web for information
`finance`	Finance	Market data and analysis
`development`	Development	Code review and documentation
`productivity`	Productivity	Calendar and task management