Tessera docs

Documentation

API Reference

Launch Tessera

Launch

Introduction

Authentication

POST

Create token

POST

Refresh token

DELETE

Revoke session

Projects

GET

POST

GET

DELETE

Environments

GET

List environments

POST

Create preview branch

POST

Promote environment

Rows

GET

GET

POST

PATCH

DELETE

Functions

POST

Invoke function

GET

List function runs

Webhooks

POST

Create webhook

GET

List webhooks

DELETE

Delete webhook

Functions

List function runs

List recent runs of a function with status and timing.

GET

/v1/functions/{name}/runs

Returns runs from the last 7 days, newest first.

Authorizations

Authorizationstringrequired

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

Path parameters

namestringrequired

The function name.

Query parameters

statusstringoptional

succeeded, failed or running.

limitintegeroptional

1–100. Defaults to 20.

Response fields

dataRun[]required

Runs with id, status, started_at and duration_ms.

Errors

401unauthorized

The token is missing, expired or revoked.

404not_found

No function exists with this ID in the environment.

Invoke function

Create webhook

curl --request GET \  --url https://api.tessera.dev/v1/functions/welcome-email/runs?status=failed \  --header "Authorization: Bearer $TESSERA_KEY"

{  "data": [    {      "id": "run_5kq9",      "status": "failed",      "started_at": "2026-09-28T07:00:02Z",      "duration_ms": 30000,      "error": "timeout"    }  ]}

Support

Status