API Overview

The KeepFlow API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes.

Base URL

https://api.keepflow.ai/v1

Request format

All requests must include:

• `Content-Type: application/json` header
• `Authorization: Bearer <api_key>` header

Response format

All responses follow a consistent structure:

{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-03-15T10:30:00Z"
  }
}

Error handling

Errors return appropriate HTTP status codes with a descriptive message:

{
  "error": {
    "code": "invalid_request",
    "message": "The 'email' field is required."
  }
}