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

# Catalog API

> Endpoints para explorar o data lake: árvore de camadas, contagem de linhas, prévia de dados e lineage de pipelines.

A **Catalog API** faz parte da camada de Data Engineering da strattum.ai. Ela expõe metadados do data lake (camadas `raw` e `clean`) sem mover dados — as contagens são lidas dos footers dos arquivos Parquet e as prévias limitadas a uma amostra configurável.

## Base URL

```
http://localhost:8001
```

Em produção, o endereço é configurado no deployment BYOC do cliente.

## Autenticação

A versão 1.0 não exige autenticação — o acesso é controlado pela rede privada do cliente (VPC/VLAN).

## Arquitetura de camadas

| Camada | Onde vive | Quem escreve |
| - | - | - |
| `raw` | Delta tables em `/data/raw/{connector}/{table}/` | Conectores dlt |
| `clean` | DuckDB schema `main_clean` em `/data/strattum.duckdb` | Transformações dbt |

## Endpoints

> **[GET /catalog/tree](https://docs.strattum.ai/api-reference/catalog/tables)**
>
> Árvore completa — todos os conectores, tabelas raw e modelos clean.

> **[GET /catalog/layers](https://docs.strattum.ai/api-reference/catalog/tables)**
>
> Resumo das camadas com contagem de tabelas por camada.

> **[GET /catalog/counts](https://docs.strattum.ai/api-reference/catalog/tables)**
>
> Contagem de linhas de todas as tabelas (leitura de metadados Parquet — rápida).

> **[GET /catalog/preview](https://docs.strattum.ai/api-reference/catalog/tables)**
>
> Prévia das primeiras linhas de uma tabela raw ou modelo clean.

> **[GET /v1/lineage](https://docs.strattum.ai/api-reference/catalog/lineage)**
>
> Grafo de lineage completo: conectores, modelos dbt, Memory e Knowledge.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.