# Lemma

## Docs

- [Delete project artifact](https://docs.uselemma.ai/api-reference/artifacts/delete-project-artifact.md): Deletes one uploaded project artifact.
- [Get learn-agent artifact version](https://docs.uselemma.ai/api-reference/artifacts/get-learn-agent-artifact-version.md): Returns the learn-agent KB content and metadata for a specific project, agent, and version.
- [Get uploaded project artifact content](https://docs.uselemma.ai/api-reference/artifacts/get-uploaded-project-artifact-content.md): Returns stored text content and metadata for one uploaded text artifact.
- [List learn-agent artifact versions](https://docs.uselemma.ai/api-reference/artifacts/list-learn-agent-artifact-versions.md): Returns learn-agent KB version metadata for a project and agent, newest first. The response omits artifact content.
- [List project artifacts](https://docs.uselemma.ai/api-reference/artifacts/list-project-artifacts.md): Returns learn-agent and uploaded artifacts for a project, scoped to the selected agent.
- [Regenerate project artifacts](https://docs.uselemma.ai/api-reference/artifacts/regenerate-project-artifacts.md): Starts the learn-agent workflow for a tenant-owned project and optional agent. Duplicate project+agent triggers within the dedupe window return the same workflow_id; clients should poll list_project_artifacts for a new latest_version or learn_agent_artifact version to observe completion.
- [Upload project artifact](https://docs.uselemma.ai/api-reference/artifacts/upload-project-artifact.md): Upload an agent-scoped .txt or .md file (text/plain or text/markdown).
- [Get issue](https://docs.uselemma.ai/api-reference/issues/get-issue.md): Get a single issue. The validation field is null when no validation row exists; when present it contains status, confidence, evidenceSummary, checkedTools, caveats, and validatedAt.
- [Get issue artifact context](https://docs.uselemma.ai/api-reference/issues/get-issue-artifact-context.md): Returns bounded learn-agent and uploaded text artifact context for validation and debugging.
- [Get issue chat context](https://docs.uselemma.ai/api-reference/issues/get-issue-chat-context.md): Returns the issue, recent occurrences, aggregate stats, and per-trace bundles (trace row + trace_stats + spans) for issue chat.
- [Get issue markdown](https://docs.uselemma.ai/api-reference/issues/get-issue-markdown.md): Build markdown for an issue.
- [Get issue metric series](https://docs.uselemma.ai/api-reference/issues/get-issue-metric-series.md): Returns zero-filled daily occurrence buckets for an issue over the last 30 days.
- [List dashboard issues](https://docs.uselemma.ai/api-reference/issues/list-dashboard-issues.md): List dashboard-ready issues for a project.
- [List issue occurrences](https://docs.uselemma.ai/api-reference/issues/list-issue-occurrences.md): List occurrences for an issue.
- [List issues](https://docs.uselemma.ai/api-reference/issues/list-issues.md): List issues for a project.
- [Set issue status](https://docs.uselemma.ai/api-reference/issues/set-issue-status.md): Update issue lifecycle status. Resolved and dismissed close the issue and append close feedback.
- [Create project](https://docs.uselemma.ai/api-reference/projects/create-project.md): Create a project for the authenticated tenant.
- [Get project](https://docs.uselemma.ai/api-reference/projects/get-project.md): Returns a single project if it belongs to the authenticated tenant.
- [Get project analytics](https://docs.uselemma.ai/api-reference/projects/get-project-analytics.md): Returns request/error/speed/token timeseries + top models for a project over a time range.
- [Get project metric event counts](https://docs.uselemma.ai/api-reference/projects/get-project-metric-event-counts.md): Returns metric event counts for a project.
- [Get project model scorecard](https://docs.uselemma.ai/api-reference/projects/get-project-model-scorecard.md): Returns per-model trace/token/speed aggregates for a project.
- [List projects](https://docs.uselemma.ai/api-reference/projects/list-projects.md): Returns projects available to the authenticated tenant.
- [Reorder projects](https://docs.uselemma.ai/api-reference/projects/reorder-projects.md): Persist project ordering for the authenticated tenant.
- [Update project](https://docs.uselemma.ai/api-reference/projects/update-project.md): Update a project for the authenticated tenant.
- [Bulk delete traces](https://docs.uselemma.ai/api-reference/traces/bulk-delete-traces.md): Delete multiple traces for a project.
- [Check per-trace ingest status](https://docs.uselemma.ai/api-reference/traces/check-per-trace-ingest-status.md): Returns enqueued (Redis index), ingested (ClickHouse traces row), ready (trace_stats), or not_found for a specific otel_trace_id.
- [Check ready traces](https://docs.uselemma.ai/api-reference/traces/check-ready-traces.md): Returns whether a project has ready traces.
- [Delete trace](https://docs.uselemma.ai/api-reference/traces/delete-trace.md): Delete a trace for a project.
- [Get agent names by trace ids](https://docs.uselemma.ai/api-reference/traces/get-agent-names-by-trace-ids.md): Returns a map of trace id to agent name (from ClickHouse trace_stats).
- [Get thread trace neighbors](https://docs.uselemma.ai/api-reference/traces/get-thread-trace-neighbors.md): Returns previous and next ready traces from the same thread.
- [Get trace](https://docs.uselemma.ai/api-reference/traces/get-trace.md): Loads a single trace with spans and stats.
- [Get trace by run id](https://docs.uselemma.ai/api-reference/traces/get-trace-by-run-id.md): Resolves a trace from an agent run id.
- [Get trace context bundle](https://docs.uselemma.ai/api-reference/traces/get-trace-context-bundle.md): Returns the trace row, trace_stats row, ordered spans, and issue occurrences for chat/agent context.
- [List dashboard traces](https://docs.uselemma.ai/api-reference/traces/list-dashboard-traces.md): Returns dashboard-ready traces for a project.
- [List thread issue summaries](https://docs.uselemma.ai/api-reference/traces/list-thread-issue-summaries.md): Batch-fetch issue extraction completion and destin issues for thread_ids (join key for eval trial_hash).
- [List thread traces](https://docs.uselemma.ai/api-reference/traces/list-thread-traces.md): Returns every ready trace in the given trace's thread, enriched and ordered oldest first. Empty for standalone traces.
- [List trace agent names](https://docs.uselemma.ai/api-reference/traces/list-trace-agent-names.md): Returns agent names seen in project traces.
- [List trace issue occurrences](https://docs.uselemma.ai/api-reference/traces/list-trace-issue-occurrences.md): Returns issue occurrence evidence linked to a ready trace.
- [List trace spans](https://docs.uselemma.ai/api-reference/traces/list-trace-spans.md): Returns spans for a ready trace.
- [List traces](https://docs.uselemma.ai/api-reference/traces/list-traces.md): Returns traces for a project.
- [Search traces](https://docs.uselemma.ai/api-reference/traces/search-traces.md): Search traces with structural and behavioral filters.
- [Semantic search traces](https://docs.uselemma.ai/api-reference/traces/semantic-search-traces.md): Search traces by semantic similarity over embedded trace summaries.
- [MCP](https://docs.uselemma.ai/connections/mcp.md): Connect your AI coding tools to Lemma using the Model Context Protocol
- [Webhooks](https://docs.uselemma.ai/connections/webhooks.md): Receive signed HTTP POST requests when incidents are detected, analyzed, or resolved
- [Lemma tracing skill](https://docs.uselemma.ai/getting-started/agent-skill.md): Install the Lemma tracing skill with the Skills CLI
- [Concepts](https://docs.uselemma.ai/getting-started/concepts.md): Core concepts and terminology in Lemma
- [Introduction](https://docs.uselemma.ai/getting-started/introduction.md): Lemma is an observability platform for AI agents
- [Quickstart](https://docs.uselemma.ai/getting-started/quickstart.md): Send your first useful agent trace to Lemma
- [Building high-quality traces](https://docs.uselemma.ai/guides/building-high-quality-traces.md): The ideal instrumentation path, with bad → better → best examples for structure, timing, nesting, generations, and tools
- [Instrumenting multi-turn agents](https://docs.uselemma.ai/guides/instrumenting-multi-turn-agents.md): Give each conversation turn its own trace and link the turns with a shared thread id
- [From Langfuse to Lemma](https://docs.uselemma.ai/guides/migrations/langfuse.md): Keep your existing Langfuse instrumentation and add Lemma SDK tracing alongside it to produce the Lemma trace contract
- [From OpenTelemetry to Lemma](https://docs.uselemma.ai/guides/migrations/opentelemetry.md): Keep your existing OpenTelemetry instrumentation and add Lemma SDK tracing alongside it to produce the Lemma trace contract
- [From Raindrop to Lemma](https://docs.uselemma.ai/guides/migrations/raindrop.md): Map Raindrop's event- and signal-centric model onto Lemma's trace contract, and re-instrument your agent to emit conforming Lemma traces
- [LangChain](https://docs.uselemma.ai/integrations/langchain.md): Record LangChain runs with Lemma callback handlers
- [LangGraph](https://docs.uselemma.ai/integrations/langgraph.md): Record LangGraph graph runs with Lemma callback handlers
- [Mastra](https://docs.uselemma.ai/integrations/mastra.md): Record Mastra agent and workflow runs with Lemma
- [OpenAI Agents SDK](https://docs.uselemma.ai/integrations/openai-agents.md): Record OpenAI Agents SDK traces with Lemma
- [Vercel AI SDK](https://docs.uselemma.ai/integrations/vercel-ai.md): Record Vercel AI SDK model calls and tool executions with Lemma
- [Trace contract](https://docs.uselemma.ai/reference/trace-contract.md): What clients send to Lemma, what ingest requires, and which fields unlock product behavior
- [Threads & context](https://docs.uselemma.ai/tracing/instrumentation/context.md): Group multi-turn conversations and attach users
- [Generations](https://docs.uselemma.ai/tracing/instrumentation/generations.md): Capture LLM calls with model, prompt, completion, and timing
- [Instrument an agent](https://docs.uselemma.ai/tracing/instrumentation/instrument-an-agent.md): Build a complete Lemma trace one piece at a time
- [Setup](https://docs.uselemma.ai/tracing/instrumentation/setup.md): Install the Lemma SDK and send traces directly to the Lemma API
- [Spans](https://docs.uselemma.ai/tracing/instrumentation/spans.md): Trace retrieval, ranking, and app logic as child spans
- [Tool calls](https://docs.uselemma.ai/tracing/instrumentation/tool-calls.md): Record tool invocations as child spans with arguments and results
- [Traces](https://docs.uselemma.ai/tracing/instrumentation/traces.md): Wrap one agent execution in one trace with input and output
- [Overview](https://docs.uselemma.ai/tracing/overview.md): How tracing works in Lemma and where to start
- [Common issues](https://docs.uselemma.ai/tracing/troubleshooting/common-issues.md): Troubleshoot missing traces and trace-quality issues: lost context, invisible tools, blank input/output, and unsupported shapes
- [Debug mode](https://docs.uselemma.ai/tracing/troubleshooting/debug-mode.md): Use SDK runtime logs to debug trace delivery and trace shape

## OpenAPI Specs

- [openapi](https://docs.uselemma.ai/api-reference/openapi.json)