API Reference

Floo API

The Floo REST API lets you manage voice AI agents, place calls, and stream events into your stack. JSON in, JSON out. Bearer token auth. No SDK required to get started.

Base URL

https://flooai.com/api/v1

All endpoints are namespaced under /api/v1. We version the API in the URL - backwards-incompatible changes ship as /api/v2.

Quickstart

List your agents in 60 seconds. Generate an API key from your dashboard settings, then:

List agentsbash

curl https://flooai.com/api/v1/agents \
  -H "Authorization: Bearer $FLOO_API_KEY"

You will get back something like this.

Responsejson

{
  "agents": [
    {
      "id": "agt_2k9f1a",
      "name": "Sales Receptionist",
      "voice_provider": "cartesia/sonic-3",
      "created_at": "2026-05-01T12: 00: 00Z"
    }
  ]
}

That is the whole shape: a top-level key matching the resource, with the payload underneath. Errors return { "error": "...", "code"?: "..." }.

Explore

Authentication

Mint API keys, send Bearer tokens, and scope access.

Agents

Create and configure voice AI agents.

Calls

Place outbound calls and inspect call records.

Webhooks

Subscribe to call lifecycle events in real time.

Looking for the JS SDK?

Install the official client from npm - typed, ESM-first, works in Node 20+ and modern bundlers.

BASH

npm install @flooai/sdk

Browse SDKs: Node, Python, Web SDK.