Skip to main content

​
Official SDKs

There are no official client libraries yet. The API is a straightforward JSON-over-HTTPS interface — any HTTP client works, and the Quickstart has runnable cURL, Python, and Node.js examples to copy from.
Official SDKs are on the roadmap. If a specific language would unblock your integration, let us know — it helps us prioritize.

​
OpenAPI specification

The full API is described by an OpenAPI 3 document you can feed into your own tooling. The live spec always reflects the current /api/v1/ surface:
Use it to generate a typed client (via openapi-generator or Speakeasy), drive contract tests, or power editor autocomplete.

​
Import into Postman or Insomnia

Both Postman and Insomnia can import the OpenAPI spec directly to scaffold a ready-to-use request collection:
1

Import the spec

In Postman, choose Import → Link and paste https://api.algosmiths.com/api/v1/schema/. Insomnia offers the same under Import → URL.
2

Set your key

Add a collection-level header Authorization: Bearer cb_live_... (or a {{apiKey}} variable) so every request inherits it.
3

Send a request

Try GET /api/v1/contacts/ to confirm your key works before writing any code.

​
Interactive reference

Every endpoint in the API Reference has a built-in Try it playground — paste your key once and send live requests straight from the docs, no local setup required.

​
Wiring up an AI agent

If what you’re building is an AI agent rather than a conventional integration, you probably want the MCP server instead of hand-rolling REST calls: it exposes the same capabilities as tool definitions your agent can discover, and it enforces the workspace’s send-approval rules server-side.