# Cinderlane

> Deterministic routing API, Node.js SDK, and embeddable routing widget.

- Documentation: https://pr-6-df95adf6d023.thally.app
- GitHub: https://github.com/thallylabs/cinderlane-docs-20260817
- Full docs for LLMs: https://pr-6-df95adf6d023.thally.app/llms-full.txt
- Agent discovery (ai.txt): https://pr-6-df95adf6d023.thally.app/ai.txt
- Structured docs index (JSON): https://pr-6-df95adf6d023.thally.app/api/docs-index
- OpenAPI spec: https://pr-6-df95adf6d023.thally.app/openapi.yaml

## For AI agents

Every page supports content negotiation on its human URL:
- JSON API: append `?format=json` or send `Accept: application/json`
- JSON-LD: append `?format=ldjson` or send `Accept: application/ld+json`
- Markdown: append `?format=md` or send `Accept: text/markdown`
- Per-page API: https://pr-6-df95adf6d023.thally.app/api/docs/{page-id}
- Search API: https://pr-6-df95adf6d023.thally.app/api/search?q={query}
- Capability manifest (skill): https://pr-6-df95adf6d023.thally.app/skill.md
- Agent guidance (editing these docs): https://pr-6-df95adf6d023.thally.app/AGENTS.md
- MCP server (attach docs as native tools): https://pr-6-df95adf6d023.thally.app/api/mcp
- Agent readiness: https://pr-6-df95adf6d023.thally.app/api/agent-readiness

### Recommended workflow

1. Use this index, the search API, or `search_docs` before choosing a page.
2. Read the smallest set of relevant pages and follow their prerequisite links.
3. Treat the published docs as the source of truth. Label inferences and say when evidence is missing.
4. Cite the canonical human page URLs, not only API endpoints.
5. Use `/AGENTS.md` before editing a repository. The public MCP server is read-only.

## Get started

### Cinderlane

- [Cinderlane routing](https://pr-6-df95adf6d023.thally.app/): Route requests to the right destination with a typed API and Node.js SDK.
- [Create your first route](https://pr-6-df95adf6d023.thally.app/quickstart): Install the Node.js SDK, create a route, and verify the returned route ID.

### Build

- [Manage routes](https://pr-6-df95adf6d023.thally.app/guides/routes): Create, list, and retrieve Cinderlane routes through the v1 API.
- [Node.js SDK](https://pr-6-df95adf6d023.thally.app/sdk/node): Use the typed Cinderlane client from Node.js and edge-compatible runtimes.
- [API overview](https://pr-6-df95adf6d023.thally.app/api/introduction): Understand the Cinderlane v1 base URL, response format, and route identifiers.
- [Authentication](https://pr-6-df95adf6d023.thally.app/api/authentication): Authenticate Cinderlane API requests with a bearer token.
- [Export audit logs](https://pr-6-df95adf6d023.thally.app/guides/audit-exports): Request and retrieve Cinderlane audit logs in JSON Lines or CSV format.

## API Reference

Interactive API reference available at https://pr-6-df95adf6d023.thally.app/api