Platform · Docs

TypeScript SDK first, with gaps made explicit.

The current first-class source of truth is @acosmi/sdk-ts. Go, Python, Java and OpenAPI are not claimed as equally published; backend OAuth alignment for contract_template scopes is documented as a known gap.

Get started Read overview

Quickstart

Start with a guided path

3 min

Auth & keys

Choose between API keys, OAuth and JWT.

5 min

Your first API call

Hit the simplest endpoint with cURL.

8 min

SDK vs raw HTTP

When to use the SDK, when to call HTTP directly.

12 min

Wire up webhooks

Signature verification, retries, idempotency.

Guides

Understand the core systems

Auth model

When to use API keys, OAuth or JWT.

Error handling

Standard error envelope, status mapping, retryable codes.

Rate limits

Token bucket, Retry-After, enterprise quotas.

Streaming

Choosing between SSE and WebSocket.

Idempotency

Safe retries with Idempotency-Key.

Webhooks

Signatures, retries, callback best-practice.

Cookbook

Hand real work to agents

FlowEmbed an agent into your product

Frontend SDK + backend proxy + token metering.

FlowScheduled agents

Cron + Webhook for recurring tasks.

FlowBuild a RAG

KB → vectors → retrieval → agent.

TypeScript SDKPython SDK statusGo SDK statusJava SDK statusOpenAPI statusStatus