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

# Developer Resources

> The Developer Resources section in the admin panel and how to use each resource.

At the very bottom of **Settings → Headless API** in the admin panel you will find the **Developer Resources** section. It holds four links you will need while developing with Headless.

| Resource | Address | For whom |
| - | - | - |
| Interactive API documentation | `/headless/docs` | Developers |
| `openapi.json` | `/headless/openapi.json` | Tools, code generators, AI |
| `llms.txt` | `/headless/llms.txt` | AI (short index) |
| `llms-full.txt` | `/headless/llms-full.txt` | AI (full reference) |

All of them live under your site address, e.g. `https://your-site.com/headless/docs`.

## Interactive API documentation

Presents every endpoint grouped, searchable and **testable from the browser**. It includes authentication, parameters, response examples, error codes and code samples in several languages.

**When to use it:** when you wonder what an endpoint returns, want to try a request quickly or look up what an error code means.

Detailed usage: [OpenAPI documentation](https://developer.leaderos.net/headless/en/openapi.md).

## openapi.json

The machine-readable definition of the API.

**When to use it:**

* Importing a collection into Postman/Insomnia/Bruno
* Generating TypeScript types or clients in other languages
* Giving the full definition to AI tools
* Data source of the MCP server (it reads it automatically)

## llms.txt

A **short** index prepared for AI models: the core rules (authentication, response format, error handling) and a one-line list of all endpoints.

**When to use it:** when you want to quickly give the big picture to a tool with a small context window.

## llms-full.txt

The **full** reference with each endpoint's parameters, request body, responses and error codes. The panel shows this hint:

> "Give llms-full.txt to your AI assistant and it can build a theme for you."

**How to use it:**

> [tab] Chat tool
>
> Copy the file's content into the chat (or upload it as a file) and write your request:
>
> > "Write a store page in Next.js with the API above."

> [tab] Coding assistant
>
> Give the assistant the address:
>
> > "Read [https://your-site.com/headless/llms-full.txt](https://your-site.com/headless/llms-full.txt) and write a login form with this API."

> [tab] MCP
>
> The MCP server serves it automatically as the `leaderos://llms-full.txt` resource; you do not need to provide it by hand.

## Public key and API URL

These details at the top of the same page are also needed for development:

* **Public Key**: the `X-LeaderOS-Key` header on every request ([Dashboard settings](https://developer.leaderos.net/headless/en/dashboard-settings.md))
* **API URL**: `https://your-site.com/headless/v1`

## Recommended workflow

**1. Explore**

Browse the endpoints in the interactive docs and try a few.

**2. Start**

Set up the template with `npm create leaderos-theme@latest` ([create-leaderos-theme](https://developer.leaderos.net/headless/en/create-leaderos-theme.md)).

**3. Connect the AI**

Connect the assistant to the project with MCP and `llms-full.txt` ([Developing with AI](https://developer.leaderos.net/headless/en/ai-development.md)).

**4. Publish**

Deploy to your VDS ([Deployment](https://developer.leaderos.net/headless/en/deployment.md)).

## Help

> [card] [API basics](https://developer.leaderos.net/headless/en/api-basics.md)
>
> Authentication, errors, captcha, payment flow.

> [card] [Settings](https://developer.leaderos.net/headless/en/dashboard-settings.md)
>
> Full explanation of the panel settings.


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