Harness 設定

Mindmap API

prompt と任意の LiveDoc context から mindmaps を作成します。

POST/v2/mindmap

認証

Bearer API key

Content type

application/json

レート制限

endpoint ごとの制限が適用される場合があります。

LiveDoc API

Mindmap API は topic、question、project request から mindmap を生成し、結果を LiveDoc に保存して Agent が後で reuse/retrieve できるようにします。

認証

Authorization: Bearer YOUR_API_KEY

Create Mindmap

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

リクエスト Body

パラメータ	型	必須	説明
`query`	string	はい	mindmap generation topic or question, max 2000 characters
`layout`	string	いいえ	layout type. Default: `MIND_MAP`
`livedoc_short_id`	string	いいえ	LiveDoc ID. If omitted, a new LiveDoc is created automatically

Layout Types

Layout	Description
`MIND_MAP`	Classic mind map, default
`LOGICAL_STRUCTURE`	Logical structure diagram
`ORGANIZATION_STRUCTURE`	Organization chart
`CATALOG_ORGANIZATION`	Catalog organization chart
`TIMELINE`	Timeline diagram
`FISHBONE`	Fishbone diagram

例

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","layout":"MIND_MAP"}'

レスポンスフィールド

フィールド	型	説明
`resource_id`	string	Resource ID of the created mindmap
`status`	string	Generation status, such as `COMPLETED`
`livedoc_short_id`	string	LiveDoc short ID where the mindmap is stored
`mindmap_url`	string	URL for viewing the mindmap
`svg`	string	SVG content of the mindmap
`message`	string	Status message

エラーコード

Code	HTTP Status	説明
`INVALID_API_KEY`	401	API Key is invalid or revoked
`MINDMAP_CREATE_FAILED`	502	Mindmap creation failed
`LIVEDOC_CREATE_FAILED`	502	Failed to create LiveDoc
`LIVEDOC_NOT_FOUND`	404	Specified LiveDoc not found
`LLM_SERVICE_UNAVAILABLE`	503	LLM service is unavailable
`LLM_REQUEST_TIMEOUT`	504	LLM request timed out