Overview - Tembo Docs

Base URLs

Tembo API and self-hosted deployments use the same API operations and schemas.

Tembo API: https://api.tembo.io
Self-hosted: https://{deployment-origin}/api/public-api

Self-hosted deployments use their own deployment origin and currently require the additional /api/public-api path prefix.

Authentication

For the Tembo API, create an API key from Settings > API Keys in the hosted Tembo dashboard. For self-hosted, create an API key in your deployment’s own dashboard.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.tembo.io/v1/sessions

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://tembo.example.com/api/public-api/v1/sessions

TypeScript SDK

npm install @tembo-io/sdk

Set the TEMBO_API_KEY environment variable to your API key. Keep it on your server, not in browser code or source control.

import Tembo from '@tembo-io/sdk';

const client = new Tembo();

const sessions = await client.sessions.list({ limit: '5' });
console.log(sessions);

Rate limits

100 requests per minute per API key. 1,000 requests per hour per organization.

​Base URLs

​Authentication

​TypeScript SDK

​Rate limits

Base URLs

Authentication

TypeScript SDK

Rate limits