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