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

Environments

Create preview branch

Create an isolated preview environment from a git branch.

POST

/v1/projects/{project_id}/branches

Creates a branch environment, applies the schema from the given git ref, loads seed data and deploys functions.

Authorizations

Authorizationstringrequired

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

Path parameters

project_idstringrequired

The project ID.

Request body

namestringrequired

Branch name, usually the git branch.

git_refstringrequired

Commit SHA or branch to build from.

copy_fromstringoptional

Environment to inherit secrets from. Defaults to development.

Response fields

idstringrequired

Environment ID.

api_urlstringrequired

Base URL for this branch.

statusstringrequired

provisioning until ready.

Errors

401unauthorized

The token is missing, expired or revoked.

422validation_failed

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

409branch_exists

A branch with this name already exists.

Previous

List environments

Next

Promote environment

curl --request POST \  --url https://api.tessera.dev/v1/projects/prj_8f2k1/branches \  --header "Authorization: Bearer $TESSERA_KEY" \  --header "Content-Type: application/json" \  --data '{"name":"feat-invoices","git_ref":"a41c9e2"}'
{  "id": "env_br_7s2",  "name": "feat-invoices",  "api_url": "https://feat-invoices--prj_8f2k1.tessera.dev",  "status": "provisioning"}

© 2026 Tessera, Inc.

Support

Status

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