Back to Docs

API Reference

Complete API documentation for filepath.

Interactive Documentation

OpenAPI Spec

JSON

Complete API specification

Interactive Docs

Scalar

Test endpoints in browser

Agent API Guide

Guide

Programmatic access for AI agents

llms.txt

Context

For AI assistants

Core Endpoints

POST /api/auth/sign-up/email

Create new account

POST /api/auth/sign-in/email

Sign in to existing account

GET /api/sessions

List all sessions

POST /api/sessions

Create new session

GET /api/sessions/{id}

Get session details

GET /api/sessions/{id}/nodes

List all nodes in session

POST /api/sessions/{id}/nodes

Spawn new agent node

GET /api/sessions/{id}/tree

Get hierarchical tree structure

GET /api/user/keys

Get masked API keys

POST /api/user/keys

Store encrypted API key

GET /api/models

List available LLM models

GET /api/config

Get environment config (WebSocket URL)

WebSocket Endpoint

wss://api.myfilepath.com/agents/chat-agent/{nodeId}

Real-time chat with agent. Uses Cloudflare AIChatAgent protocol.

Authentication

  • Session Cookie — Standard browser auth (Better Auth)
  • API Key — x-api-key header for programmatic access
  • Bearer Token — JWT in Authorization: Bearer ... header