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

# AGENTS

# Dabar docs — agent instructions

## About this project

* Public documentation site for the Dabar API, built on [Mintlify](https://mintlify.com)
* Pages are MDX files with YAML frontmatter
* Configuration lives in `docs.json`
* Run `mint dev` to preview locally
* Run `mint broken-links` to check links

## Terminology

* **Politics** — a reusable analysis policy. Stored in the `politics` collection.
* **Project** — a run that applies a politics to a set of files. Stored in the `project` collection.
* **User** — an authenticated Dabar account (collection `user`). Authentication uses the `auth.token` field, sent by clients as the `api-token` header.
* **Knowledge files** — reference documents attached to a politics (word / pdf). They must be publicly accessible URLs.
* **Files** — inputs attached to a project (video, document, url, photo, audio, text). Text files are uploaded to the `dabarai-assets` S3 bucket automatically.

## Style preferences

* Use active voice and second person ("you")
* Keep sentences concise — one idea per sentence
* Use sentence case for headings
* Bold for UI elements: Click **Settings**
* Code formatting for file names, commands, paths, and code references
* Document request/response examples with `<RequestExample>` / `<ResponseExample>` blocks
* Document parameters with `<ParamField>` and responses with `<ResponseField>`

## Content boundaries

* Document only the public lambda endpoints (Projects, Politics)
* Do not expose internal collection structure beyond what the API returns
* Do not include credentials, tokens, VPC IDs, or role ARNs in public pages