> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trellis.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Trellis API

> Operational intelligence for the physical economy.

# Operational Intelligence for the Physical Economy

The Trellis API is the integration surface for industrial AI agents that reason over your operational data — production lines, project portfolios, equipment logs, document repositories — and answer in natural language.

It is built for heavy industry: real estate development, construction, manufacturing, energy, and logistics.

## How Trellis works

Three layers, exposed through one API.

<CardGroup cols={3}>
  <Card title="Representations" icon="layer-group">
    Trellis ingests unstructured operational data and maps entities into
    proprietary representation models that the agent can reason over.
  </Card>

  <Card title="Agentic Engine" icon="brain-circuit">
    A capable coworker that automates complex processes, produces detailed
    analyses, and learns custom skills against your data.
  </Card>

  <Card title="Enterprise Apps" icon="grid-2">
    Encapsulate agent capabilities behind custom UIs and ship them into a
    secure internal app store in minutes.
  </Card>
</CardGroup>

## What you can build

<CardGroup cols={2}>
  <Card title="Conversational data access" icon="messages">
    Let stakeholders ask "how many units shipped this quarter?" and get a
    streamed answer with the SQL the agent ran.
  </Card>

  <Card title="Document grounding" icon="file-magnifying-glass">
    Anchor agent answers to engineering specs, contracts, and maintenance
    records. The agent decides when to retrieve.
  </Card>

  <Card title="Voice agents" icon="microphone">
    Open a LiveKit room with one POST and let field operators talk to your
    data hands-free.
  </Card>

  <Card title="Embedded copilots" icon="window">
    Build internal copilots that reuse your saved queries and your
    organization's behavioral rules.
  </Card>
</CardGroup>

## Quick links

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    From API key to first streamed answer in under five minutes.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    API key → JWT exchange. Six-hour token lifetime.
  </Card>

  <Card title="Streaming" icon="bolt" href="/api-reference/chats/overview">
    SSE for stateless turns; WebSocket for interruptible ones.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/introduction">
    Forty-eight endpoints across ten groups. Hand-written, exhaustive.
  </Card>
</CardGroup>

## Base URL

```
https://api.trellis.sh
```