API Reference

Complete API reference for FlowCaptain: authentication, availability checks, booking, cancellation, rescheduling, and MCP endpoint.

API Reference

The FlowCaptain API provides a full appointment lifecycle: check availability, book, cancel, and reschedule. All endpoints accept JSON and return JSON responses.

Base URL

https://api.flowcaptain.ai

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer sk_live_your_api_key_here

API keys are scoped to a specific calendar and can be managed in the FlowCaptain dashboard.

Endpoints Overview

Method	Path	Description
POST	/api/v1/check-availability	Check available time slots
POST	/api/v1/book-appointment	Book an appointment
POST	/api/v1/cancel-appointment	Cancel an existing appointment
POST	/api/v1/reschedule-appointment	Reschedule an existing appointment
POST	/mcp	MCP endpoint (auto-discovers all tools)

Response Format

All endpoints return a JSON object with a human-readable message in the language of the input query (German or English).