Skip to main content
This guide walks you from zero to a first trace appearing in the Web Console in about five minutes.
You need a Tuor account with access to at least one organization. Sign up at tuor.dev.

Create a project

Projects are the unit of organization in Tuor. Every trace belongs to exactly one project; each trace’s self-describing spans control how its trajectory renders. In the Web Console:
  1. Open the Projects tab in the top navigation.
  2. Click Create Project.
  3. Give it a name (1-100 characters).
  4. Open the project and copy its ID from the Config tab (IDs look like proj_aB3x…). You will use this as project_id in every ingest request.
The output is always structured JSON rendered as an editable path form. Each trace can describe its own field controls in output_schema — enum label pickers, boolean toggles, or json blocks — while paths you leave out get a control inferred from the value’s type. There’s no project-level output type to choose. See Reviewer Blueprints for the payload recipes.

Get an API key

API keys authenticate programmatic traffic from your services to Tuor. They are scoped to the organization that issued them. Only organization admins can create them.
  1. Open Settings → API Keys in the Web Console.
  2. Click Create New Key and give it a name (e.g. production-ingest, staging).
  3. Copy the key shown on screen — it starts with tuor_ and is shown only once. Store it in your secret manager.
Keys never expire on their own. Revoke a key from the same panel; revoked keys stop working immediately.

Send your first trace

Replace proj_abc123 with the project ID you copied from the Web Console. The simplest possible ingest:
A successful response returns a TraceDetailResponse with the new trace’s id, status (pending), timestamps, structured tag summaries, and event timeline. The trace should appear immediately on the Traces page for the corresponding project in the Web Console.
Keep spans in the same order as the original model trajectory. Tuor preserves assistant messages even when they repeat the structured model_output review target.

Call Tuor from application code

Call the API directly from your service code and keep the API key in your server-side secret manager.

Where next?