Mindmap API

The Mindmap API provides mindmap generation capabilities. You can create a mindmap with a topic or question, and optionally specify a layout type.

Authentication

All requests require an API Key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Use with AI Agents

Install the complete felo-ai package to let an Agent create mindmaps alongside every other available Felo Skill. The installer dynamically discovers every package directory containing SKILL.md, so it includes future additions. Install all discovered Skills in Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills, or Hermes Agent ~/.hermes/skills. Follow the manual AI Agent setup guide for the safe setup procedure for each platform.

Create Mindmap

Create a mindmap based on a query (topic or question).

Endpoint

POST https://openapi.felo.ai/v2/mindmap

Request Headers

Request Body

Layout Types

Example: Create with Auto LiveDoc

curl -X POST 'https://openapi.felo.ai/v2/mindmap' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "Artificial Intelligence trends in 2024"
  }'

Example: Create with Specific LiveDoc

curl -X POST 'https://openapi.felo.ai/v2/mindmap' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "Project timeline overview",
    "layout": "TIMELINE",
    "livedoc_short_id": "abc123xyz"
  }'

Success Response (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "resource_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "COMPLETED",
    "livedoc_short_id": "PvyKouzJirXjFdst4uKRK3",
    "mindmap_url": "https://felo.ai/mindmap/550e8400-e29b-41d4-a716-446655440000",
    "svg": "<svg>...</svg>",
    "message": "Mindmap created successfully"
  }
}

Response Fields

Error Codes