Pixel Bloom lattice in pale lilac with one bright cobalt pixel
Docs
/
Getting started

Quickstart

Make your first request in under five minutes.

API v1
SDK 2.4
01

Create an API key

In the console, open Keys and choose Create. The full key is shown once, so copy it somewhere safe.

LATTIS_API_KEY
lt_live_••••••••••3f2a
02

Install the SDK

Python 3.9+ or Node 18+. The SDK reads your key from the environment.

Shell
terminal
pip install lattis
# or
npm install @lattis/sdk
03

Send a request

Run an agent with two tools. The response streams by default.

quickstart.py
from lattis import Lattis
client = Lattis(api_key="lt_live_...")
run = client.agents.run(
agent="support-triage",
input="Customer reports a failed export in workspace 8842",
tools=["search_tickets", "read_logs"],
)
print(run.output.summary)
quickstart.ts
import { Lattis } from "@lattis/sdk";
const client = new Lattis({ apiKey: process.env.LATTIS_API_KEY });
const run = await client.agents.run({
agent: "support-triage",
input: "Customer reports a failed export in workspace 8842",
tools: ["search_tickets", "read_logs"],
});
console.log(run.output.summary);
quickstart.sh
curl https://api.lattis.dev/v1/agents/run \
-H "Authorization: Bearer $LATTIS_API_KEY" \
-d '{"agent":"support-triage","input":"Customer reports a failed export in workspace 8842"}'
Note

Keys starting lt_test_ never bill and run against a sandbox region.

04

Watch the trace

Open Traces in the console to see every step, tool call, token and millisecond of the run.

$ lattis run support-triage
streaming
plan
0.1 s
search_tickets
0.3 s
read_logs
0.4 s
issue_refund
awaiting approval
1,284 tokens · 1.2 s · trace tr_8f2a