API Documentation

Integrate your AI Agents with your Innovemind notes.

Authentication: All API requests must include your API Key in the header: X-API-Key: YOUR_API_KEY
Generate your key in Settings.
Headless for AI Agents: Agents can authenticate with a GFAVIP Bearer token (no browser required). See the agent guide at /skill.md.

Endpoints

GET /api/folders

Returns a nested JSON tree of all folders, subfolders, and notes visible to the user (including shared folders).

Response Example:
[
  {
    "id": "folder_uuid_1",
    "name": "Work Projects",
    "type": "folder",
    "children": [
      {
        "id": "note_uuid_1",
        "title": "Meeting Notes",
        "type": "note",
        "created_at": "2023-10-27T10:00:00",
        "source": "manual",
        "content_snippet": "Discussed Q4 roadmap..."
      }
    ]
  },
  {
    "id": "note_uuid_2",
    "title": "Unsorted Idea",
    "type": "note",
    "created_at": "2023-10-28T14:30:00",
    "source": "omi",
    "content_snippet": "Remember to buy milk..."
  }
]
GET /api/notes/<note_id>

Returns the full content and metadata for a specific note.

Response Example:
{
  "id": "note_uuid_1",
  "title": "Meeting Notes",
  "content": "# Meeting Notes\n\n- Point 1\n- Point 2",
  "created_at": "2023-10-27T10:00:00",
  "source": "manual",
  "tags": ["work", "meeting"]
}