First request
Shape inputs and inspect output.
A first request is two calls: read what Tessen can do, then start an execution with a key and read it back. Both are real routes; the full contract for each is in the API Reference.
# Read what Tessen can do. No authentication needed.
curl https://tessen.ai/api/capabilities
# Start an execution with a key created in the Console.
curl -X POST https://tessen.ai/api/execution \
-H "Authorization: Bearer tsn_cloud_EXAMPLE" \
-H "content-type: application/json" \
-d '{"goal":"a one-page site for a bakery in Lisbon","outcome":"website"}'
# Read it back by the plan id the 202 returned.
curl "https://tessen.ai/api/execution?id=<plan id>" \
-H "Authorization: Bearer tsn_cloud_EXAMPLE"Define the intent
An execution starts from a goal in plain language and the kind of outcome you want. Tessen writes the plan before it answers, so the response already names the stages it will run.
Inspect the output
Read the execution back by its id while it runs. Each stage reports its own state; a failed stage says why, in the same error shape every route uses.
Keys are created by a person in the Console, never by a program, so a first request always begins with a sign-in.