Docs

Turso Homepage

Blog & Tutorials

Discord

GitHub

Turso

Turso CLI

Client SDKs

Platform API

API Status

Dashboard

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

The DNS hostname used for client libSQL and HTTP connections (specific to this instance only).

The name of the instance (location code).

The location code for the region this instance is located.

The type of database instance this, will be `primary` or `replica`.

The instance universal unique identifier (UUID).

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

Returns a database belonging to the organization or user.

Retrieve

Retrieve 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

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.

Upload Dump

Upload SQLite Dump

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

List Groups

Creates a new group for the organization or user.

Create Group

Returns a group belonging to the organization or user.

Retrieve Group

Delete a group belonging to the organization or user.

Delete Group

Add Location

Add Location to Group

Removes a location from the specified group.

Remove Location

Remove Location from Group

Transfer a group to another organization that you own or a member of.

Transfer

Transfer Group

Unarchive a group that has been archived due to inactivity.

Unarchive

Unarchive Group

Updates all databases in the group to the latest libSQL version.

Update Versions

Update Databases in a Group

Generates an authorization token for the specified group.

Create Group Auth Token

Invalidates all authorization tokens for the specified group.

Invalidate All Group Auth Tokens

Returns a list of locations where you can create or replicate databases.

List Locations

Returns the closest region to the user's location.

API

Resources

List Database Instances

Path Parameters

Response