DOCUMENTATION / TESSEN API (PREVIEW)

API Reference

Every documented endpoint, at the contract its handler enforces.

The Tessen execution API is in preview and is not part of the Project Zero developer launch. Project Zero has its own API — see the API section.

Four resources are documented in full. Each entry names a route that exists in this application, and a test fails if a documented path has no route file or a documented method is not exported by it.

Base URL: https://tessen.ai — there is no /v1 namespace.

Executions

An execution is a plan: a goal, the stages Tessen chose for it, and the state of each. Creating one returns immediately with the plan — the work runs after the response.

POST/api/execution

Start an execution, or resume one that stopped at an approval gate.

GET/api/execution

Read one of your plans, or your ten most recent.

Capabilities

What Tessen can be asked to do, and the honest status of each — including the ones that are registered and deliberately not offered.

GET/api/capabilities

The capability registry, with coverage totals.

API Keys

Keys are created and revoked by a person in a browser, never by a program. This resource is documented so the boundary is visible, not so it can be automated.

GET/api/keys

List your keys. Prefixes only — the secret is never returned again.

POST/api/keys

Create a key. The plaintext secret is returned exactly once.

DELETE/api/keys

Revoke a key.

Usage

Your own request volume, errors and latency. Scoped to the caller — there is no user parameter, deliberately.

GET/api/devstats

Requests, errors, latency percentiles and per-key activity.

GET/api/usage

Your token consumption.