Skip to main content
The AgentFlow API is a REST API built with FastAPI. All responses use JSON. Streaming endpoints use Server-Sent Events.

Base URL

http://localhost:8000

Authentication

All requests require a Bearer token (Auth0 JWT):
curl -H "Authorization: Bearer <token>" http://localhost:8000/agents
See Authentication for details.

Resource Groups

GroupBase PathDescription
Agents/agentsCRUD and execution
Tools/agents/{id}/toolsTool management
Knowledge Bases/knowledge-basesKB management and search
Conversations/conversationsConversation history

Streaming

Execution endpoints (/agent/{id}/run, /agent/{id}/chat) return SSE streams. Use -N with cURL or an SSE client library to consume them.

Error Format

{
  "detail": "Agent not found",
  "status_code": 404
}

Interactive Docs

The auto-generated Swagger UI is available at /docs when the server is running.