Tessera docs

Documentation

API Reference

Launch Tessera

Launch

Introduction

Authentication

POST

Create token

POST

Refresh token

DELETE

Revoke session

Projects

GET

List projects

POST

Create project

GET

Retrieve project

DELETE

Delete project

Environments

GET

List environments

POST

Create preview branch

POST

Promote environment

Rows

GET

List rows

GET

Retrieve row

POST

Create row

PATCH

Update row

DELETE

Delete row

Functions

POST

Invoke function

GET

List function runs

Webhooks

POST

Create webhook

GET

List webhooks

DELETE

Delete webhook

Projects

Create project

Create a project with development and production environments.

POST

/v1/projects

Creates a project, provisions its database in the chosen region and returns the new project with its environments.

Authorizations

Authorizationstringrequired

Bearer token. Use a server key or a user access token: Bearer <token>.

Request body

namestringrequired

Display name, 1–64 characters.

regionstringoptional

us-east-1, eu-west-1 or ap-southeast-1. Defaults to us-east-1.

planstringoptional

free, pro or team. Defaults to free.

Response fields

idstringrequired

Project ID, prefixed prj_.

namestringrequired

Display name.

regionstringrequired

Database region.

environmentsEnvironment[]required

development and production.

Errors

401unauthorized

The token is missing, expired or revoked.

403forbidden

The key doesn't have the scope needed for this endpoint.

422validation_failed

One or more fields are invalid. See error.fields for details.

Previous

List projects

Next

Retrieve project

curl --request POST \  --url https://api.tessera.dev/v1/projects \  --header "Authorization: Bearer $TESSERA_KEY" \  --header "Content-Type: application/json" \  --data '{"name":"Acme","region":"eu-west-1"}'
{  "id": "prj_8f2k1",  "name": "Acme",  "region": "eu-west-1",  "environments": [    {      "id": "env_dev1",      "name": "development"    },    {      "id": "env_prd1",      "name": "production"    }  ]}

© 2026 Tessera, Inc.

Support

Status

Create a free website with Framer, the website builder loved by startups, designers and agencies.