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

# API Reference

> Complete schema for the LightOn REST API.

All endpoints are under `/api/v3/` and require a bearer token.
See [Authentication](/authentication) for setup.

The reference pages in this section are generated from the OpenAPI specification. Every parameter, response shape, and error code is documented exactly as the server implements it.

## Intelligence

<Columns cols={2}>
  <Card title="Ask" icon="comments">
    `POST /api/v3/ask`: retrieval-augmented generation: a grounded LLM answer plus its sources, sync or streamed. [Tutorial](/tutorials/ask)
  </Card>

  <Card title="Search" icon="magnifying-glass">
    `POST /api/v3/search`: hybrid vector + lexical retrieval with optional reranking. [Tutorial](/tutorials/search)
  </Card>

  <Card title="Files" icon="cloud-arrow-up">
    Upload, list, fetch, update, and delete documents in your workspaces. [Tutorial](/tutorials/files)
  </Card>

  <Card title="Facets" icon="layer-group">
    Define classification trees, classify files, set attribute values, and read structured metadata. [Tutorial](/tutorials/facets/overview)
  </Card>

  <Card title="Tags" icon="tag">
    Manage company-wide document tags used to scope search and organise content.
  </Card>

  <Card title="Workspaces" icon="folder">
    Create and manage workspaces, the access-controlled containers your documents live in.
  </Card>
</Columns>

## Document processing

<Columns cols={2}>
  <Card title="Parse" icon="file-lines">
    `POST /api/v3/parse`: convert documents to clean Markdown, synchronously or as an async job. [Tutorial](/tutorials/parse)
  </Card>

  <Card title="Extract" icon="wand-magic-sparkles">
    Pull typed fields from documents using a JSON Schema you provide. [Tutorial](/tutorials/extract)
  </Card>
</Columns>

## Administration

<Columns cols={2}>
  <Card title="API Keys" icon="key">
    Provision and revoke API keys used to authenticate against the API.
  </Card>
</Columns>