Docs

Turso Homepage

Blog & Tutorials

Discord

GitHub

Turso

Turso CLI

Client SDKs

Platform API

API Status

Dashboard

Returns a database belonging to the organization or user.

Retrieve

Retrieve Database

The database universal unique identifier (UUID).

The DNS hostname used for client libSQL and HTTP connections.

The database name, **unique** across your organization.

The current status for allowing the database to be attached to another.

The current status of the database. If `true`, the database is archived and requires a manual unarchive step.

The name of the group the database belongs to.

If this database controls other child databases then this will be `true`. See [Multi-DB Schemas](/features/multi-db-schemas).

The primary region location code the group the database belongs to.

A list of regions for the group the database belongs to.

The name of the parent database that owns the schema for this database. See [Multi-DB Schemas](/features/multi-db-schemas).

The current libSQL version the database is running.

SQLite for Production. Powered by libSQL.

Introduction

Welcome to Turso

Welcome to Turso! Get started with Turso in minutes.

Quickstart

Concepts

Turso Concepts

Build locally using SQLite, libSQL Server or Turso.

Local Development

libSQL is SQLite for modern applications.

libSQL

Manage databases, replicas, and teams with the Turso Platform API.

Vector Similarity Search is built into Turso and libSQL Server as a native feature.

AI & Embeddings

Embedded Replicas

Create and share a single schema across multiple databases.

Multi-DB Schemas

Attach and read data across multiple databases.

Attach Database

Allow your users to reach local replicas of your database, wherever they are.

Data Edge

Branching

Point-in-Time Recovery

Scale to Zero

Support

Usage & Billing

Learn how data consistency and connections work with Turso databases.

Data & Connections

Learn how to install the Turso CLI on Mac, Linux and Windows.

Installation

Authentication

Update the Turso CLI to the latest version to benefit from all the latest features, and fixes.

Upgrading

Help

Headless Mode

login

auth login

logout

auth logout

signup

auth signup

token

auth token

whoami

auth whoami

bookmeeting

contact bookmeeting

feedback

contact feedback

list

db list

create

db create

show

db show

destroy

db destroy

inspect

db inspect

shell

db shell

locations

db locations

group list

group create

update

group update

group destroy

transfer

group transfer

unarchive

group unarchive

switch

org switch

org list

org create

billing

org billing

plan show

select

plan select

upgrade

plan upgrade

Get started with Turso using the libSQL remote protocol in a few simple steps.

Turso Quickstart (HTTP)

Reference

libSQL Remote Protocol Reference

Get started with Turso and TypeScript using the libSQL client in a few simple steps

Turso Quickstart (TypeScript / JS)

libSQL JavaScript and TypeScript Reference

Examples

Get started with Turso and Rust using the libSQL crate in a few simple steps

Turso Quickstart (Rust)

Get started with Turso and Go using the libSQL client in a few simple steps.

Turso Quickstart (Go)

Get started with Turso and Python using the libSQL client in a few simple steps.

Turso Quickstart (Python)

Get started with Turso and PHP using the libSQL client in a few simple steps.

Turso Quickstart (PHP)

Get started with Turso and Ruby using the libSQL client in a few simple steps.

Turso Quickstart (Ruby)

Turso Examples (Ruby)

Get started with Turso and Android using the libSQL client in a few simple steps.

Turso Quickstart (Android)

Android Reference

Get started with Turso and Swift using the libSQL client in a few simple steps.

Turso Quickstart (Swift)

Swift Reference

Get started with Turso and C using the libSQL client in a few simple steps.

Turso Quickstart (C)

C Reference

Turso Examples (C)

Get started with Flutter and Dart using the libSQL client in a few simple steps

Turso Quickstart (Flutter / Dart)

Turso Platform API

Get started with Turso API in a few easy steps.

Errors

Returns a list of databases belonging to the organization or user.

List

List Databases

Creates a new database in a group for the organization or user.

Create

Create Database

Retrieve an individual database configuration belonging to the organization or user.

Retrieve Configuration

Retrieve Database Configuration

Update a database configuration belonging to the organization or user.

Update Configuration

Update Database Configuration

Fetch activity usage for a database in a given time period.

Usage

Retrieve Database Usage

Fetch the top queries of a database, including the count of rows read and written.

Stats

Retrieve Database Stats

Delete a database belonging to the organization or user.

Delete

Delete Database

Returns a list of instances of a database. Instances are the individual primary or replica databases in each region defined by the group.

List Instances

List Database Instances

Return the individual database instance by name.

Retrieve Instance

Retrieve Database Instance

Generates an authorization token for the specified database.

Create Token

Generate Database Auth Token

Invalidates all authorization tokens for the specified database.

Invalidate Tokens

Invalidate All Database Auth Tokens

Upload a SQL dump to be used when [creating a new database](/api-reference/databases/create) from seed.

API

Resources

Retrieve Database

Path Parameters

Response