Bots#

AI agents with isolated memory stores. Each bot maintains its own memories.

List Bots#

GET /api/bots/bots?workspace_id={workspace_id}&page={page}&per_page={per_page}

Parameters:

• workspace_id (optional) - Filter by workspace
• page (optional) - Page number (default: 1)
• per_page (optional) - Items per page (default: 20, max: 100)

Example:

curl -H "Authorization: Bearer moa_your_token"   "https://api.memof.ai/api/bots/bots?workspace_id=ws_456"

Create Bot#

POST /api/bots/bot/create

Request:

{
  "name": "Assistant Bot",
  "workspace_id": "ws_456",
  "description": "Helpful assistant",
  "metadata": {"model": "gpt-4"}
}

Example:

curl -X POST https://api.memof.ai/api/bots/bot/create   -H "Authorization: Bearer moa_your_token"   -H "Content-Type: application/json"   -d '{
    "name": "Sales Assistant",
    "workspace_id": "ws_456",
    "description": "Helps with sales",
    "metadata": {"department": "sales"}
  }'

Get Bot#

GET /api/bots/bot/{bot_id}

Update Bot#

PUT /api/bots/bot/{bot_id}/update

Example:

curl -X PUT https://api.memof.ai/api/bots/bot/bot_123/update   -H "Authorization: Bearer moa_your_token"   -H "Content-Type: application/json"   -d '{"name": "Updated Bot", "metadata": {"version": "2.0"}}'

Delete Bot#

DELETE /api/bots/bot/{bot_id}/delete

⚠️ Warning: Deletes bot AND all memories permanently.

Best Practices#

✅ Do:

• Clear, descriptive names
• Use metadata for configuration
• One focused purpose per bot

❌ Don't:

• Generic names ("Bot1")
• Make one bot do everything
• Leave unused bots

Next Steps#

• Memories - Give your bot knowledge
• Quick Start - Complete examples