Skip to main content

​
Quickstart with the TypeScript SDK

The fastest way to use the Platform API from JavaScript or TypeScript is the official @tursodatabase/api client: 
npm install @tursodatabase/api

import { createClient } from "@tursodatabase/api";

const turso = createClient({
  org: process.env.TURSO_ORG!,
  token: process.env.TURSO_PLATFORM_TOKEN!,
});

// Create a database
const db = await turso.databases.create("user-abc123", { group: "default" });

// Generate a scoped auth token for that database
const { jwt } = await turso.databases.createToken("user-abc123");

// Delete it when no longer needed
await turso.databases.delete("user-abc123");
For the raw HTTP reference, see the resource endpoints below.

​
Common use cases

​
Database per user / database per agent (multi-tenant)

Provision a dedicated database per user or per AI agent. Each entity gets its own isolated SQLite database that you create, token-scope, and tear down via the API. 
import { createClient } from "@tursodatabase/api";

const turso = createClient({
  org: process.env.TURSO_ORG!,
  token: process.env.TURSO_PLATFORM_TOKEN!,
});

// On user signup or agent creation — provision a database
const db = await turso.databases.create(`agent-${agentId}`, { group: "default" });

// Generate a scoped token for that database
const { jwt } = await turso.databases.createToken(`agent-${agentId}`);

// Store db.hostname and jwt for the session
Once the database is created, connect to it from your application:

​
Platform / reseller

Create and manage databases on behalf of your end users. Use the Platform API to build your own database-as-a-service on top of Turso. 
// List all databases in your organization
const databases = await turso.databases.list();

// Get details for a specific database
const db = await turso.databases.get("customer-db");

API Quickstart

Step-by-step guide to create your first database with the API.

​
API Resources

Start integrating the Turso API with your platform in a few simple steps.

Groups API

Create and manage where your database is located.

Database API

Create, manage and generate auth tokens for databases.

Locations API

Fetch all available locations where your database group can be located.

Organizations API

Manage your organization, it's members and invites.

API Tokens API

Create, validate and revoke API keys that can be used to access the API.

Audit Logs API

Monitor logs of what's happening in your organization.