# Siltstone

> Siltstone is a grounded selection API: send a text and up to 2,000 typed questions (bool, choice, score, number, date, time, datetime) to POST https://api.siltstone.ai/v1/ask, and get back one answer per question, each with a confidence. The text is read once and every question runs against that read.

Every page below is Markdown. The whole set, in reading order, is one file: https://docs.siltstone.ai/llms-full.txt. Start with the Quickstart for a working request, and the Ask reference for every field.

## Start

- [Introduction](https://docs.siltstone.ai/index.md): Read a text once, then answer thousands of typed questions against that single read, each with a probability.
- [Quickstart](https://docs.siltstone.ai/quickstart.md): An API key, one request, and how to read what comes back.
- [Clients](https://docs.siltstone.ai/clients.md): A hand-written client for every popular language, one file each, and every example in yours.
- [Authentication](https://docs.siltstone.ai/authentication.md): API keys, how to send them, and how to keep them out of places they leak from.
- [Docs for AI agents](https://docs.siltstone.ai/agents.md): Every page as Markdown, llms.txt, and a line that points a coding agent at the right pages.

## Questions

- [Question types](https://docs.siltstone.ai/questions.md): Picked from a menu you wrote, or written under a grammar: seven types, one read of the text.
- [Bool](https://docs.siltstone.ai/questions/bool.md): Does the text say X? Answers true or false.
- [Choice](https://docs.siltstone.ai/questions/choice.md): Which one of these? Answers one of your option names.
- [Score](https://docs.siltstone.ai/questions/score.md): Where on this scale? Answers a position that can fall between levels.
- [Number](https://docs.siltstone.ai/questions/number.md): How many, how much, how high? One number, written as digits.
- [Dates and times](https://docs.siltstone.ai/questions/dates.md): When? A date, a time or both, in one ISO format, whatever the text writes.
- [Writing menus](https://docs.siltstone.ai/questions/writing-menus.md): The one rule that matters, and how to word options the model can tell apart.
- [When the text doesn't say](https://docs.siltstone.ai/questions/not-stated.md): The abstain row: what it does, and why it is off unless you ask for it.

## Confidence

- [Reading an answer](https://docs.siltstone.ai/confidence.md): confidence, margin, probabilities and review: what each number means and which to act on, for picked and written answers.
- [Choosing a threshold](https://docs.siltstone.ai/confidence/thresholds.md): Where to draw the line between acting on an answer and sending it to a person.

## Patterns

- [Triage and routing](https://docs.siltstone.ai/patterns/triage.md): Send a ticket, email or message to the right place, and know when not to.
- [Structured extraction](https://docs.siltstone.ai/patterns/extraction.md): Turn a document into a typed record, one question per field.
- [Checking a catalogue](https://docs.siltstone.ai/patterns/presence.md): Which of 200 things does this text mention? 200 bools, one request.

## API reference

- [Ask](https://docs.siltstone.ai/api/ask.md): POST /v1/ask: answer a set of questions about one text.
- [Documents](https://docs.siltstone.ai/api/documents.md): Register a text once and ask about it by id.
- [Errors](https://docs.siltstone.ai/api/errors.md): Status codes, the error body, and what to do about each.

## Account

- [API keys](https://docs.siltstone.ai/account/keys.md): Creating, naming, rotating and revoking keys.
- [Organizations](https://docs.siltstone.ai/account/organizations.md): Workspaces, members and roles.
- [Usage and billing](https://docs.siltstone.ai/account/usage.md): Prepaid credit at $0.042 per million input tokens: what's billed, and where to see it.

## Optional

- [Full documentation](https://docs.siltstone.ai/llms-full.txt): every page above in one file.