Gateway API Reference

Complete reference documentation for the Curate-Me AI Gateway API. The gateway is a reverse proxy that sits between your application and LLM providers, applying governance policies, tracking costs, and providing full observability with zero code changes.

Base URL

Authentication

All proxy endpoints require a Curate-Me API key (X-CM-API-Key header) and a provider API key (via X-Provider-Key header, Authorization: Bearer, or stored secrets). See Authentication for details.

Endpoint overview

Proxy endpoints

These endpoints accept requests in the same format as the upstream provider and proxy them through the governance chain.

Health and monitoring endpoints

HITL approval endpoints

Admin endpoints

Request format

All requests and responses use JSON. Set the Content-Type header on requests with a body:

Content-Type: application/json

Response headers

Every proxied response includes governance metadata headers:

Conditional headers

These headers appear only when applicable:

Error format

All errors follow the OpenAI-compatible error format:

{
  "error": {
    "message": "Human-readable error description",
    "type": "error_type",
    "param": null,
    "code": "error_code"
  }
}

See the Error Reference for a complete list of error types and codes.

Rate limits

Rate limits are enforced per organization. Default limits vary by subscription tier:

SDKs

The gateway is compatible with any standard LLM SDK. Just change the base URL:

# Python (OpenAI SDK)
from openai import OpenAI
client = OpenAI(
    base_url="https://api.curate-me.ai/v1/openai",
    default_headers={"X-CM-API-Key": "cm_sk_xxx"},
)

// TypeScript (OpenAI SDK)
import OpenAI from 'openai';
const client = new OpenAI({
    baseURL: 'https://api.curate-me.ai/v1/openai',
    defaultHeaders: { 'X-CM-API-Key': 'cm_sk_xxx' },
});

See also the dedicated Python SDK and TypeScript SDK pages for the curate-me and @curate-me/sdk packages.

Interactive documentation

The gateway exposes auto-generated OpenAPI documentation:

• Swagger UI: https://api.curate-me.ai/docs
• ReDoc: https://api.curate-me.ai/redoc

For local development, use http://localhost:8002/docs.