> ## Documentation Index
> Fetch the complete documentation index at: https://test-8862363a-tembo-docs-codex-usage-reset.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Create sessions, manage repositories, and automate workflows programmatically.

## 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](https://app.tembo.io). For self-hosted, create an API
key in your deployment's own dashboard.

<CodeGroup>
  ```bash Tembo API theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    https://api.tembo.io/v1/sessions
  ```

  ```bash Self-hosted theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    https://tembo.example.com/api/public-api/v1/sessions
  ```
</CodeGroup>

## TypeScript SDK

```bash theme={null}
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.

```typescript theme={null}
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.