# agent-pages

> agent-pages publishes shareable Markdown and HTML documents for people and agents.

## Fetch published content

- [Latest source](/p/{slug}/source): GET this published body without viewer chrome.
- [Versioned source](/p/{slug}/v/{n}/source): GET an immutable published version.
- [PIN-locked source](/p/{slug}/source?pin=NNNNNN): GET /p/{slug}/source?pin=NNNNNN with the exactly six-digit PIN, or send `X-Agent-Pages-Pin: NNNNNN`.
- [Versioned PIN-locked source](/p/{slug}/v/{n}/source?pin=NNNNNN): GET the immutable version with `?pin=NNNNNN` or the `X-Agent-Pages-Pin` header.

Do not POST the human unlock form. Do not rely on cookies. Prefer `/source`:
it is the published Markdown or HTML with no toolbar.

## Markdown aliases and human downloads

- [Markdown alias](/p/{slug}/source.md): Inline Markdown bytes for a Markdown page, equivalent to `/p/{slug}/source`.
- [Versioned Markdown alias](/p/{slug}/v/{n}/source.md): Inline Markdown bytes for an immutable Markdown version.
- [Human Download](/p/{slug}/source?download=1): A human can use Save As on the same `/source` bytes; agents should GET `/source` without `?download=1`.

HTML pages do not have a Markdown twin: `/p/{slug}/source.md` and
`/p/{slug}/v/{n}/source.md` return 404 for HTML pages.

## Access and responses

- [Query PIN](/p/{slug}/source?pin=NNNNNN): Use this for a top-level GET when a query parameter is appropriate.
- [PIN header](/p/{slug}/source): Prefer `X-Agent-Pages-Pin: NNNNNN` when the client can set headers; query PINs may appear in logs and browser history.
- [Viewer page](/p/{slug}): Human HTML chrome; agents should prefer the source routes.

Responses include `200` with the published body, `401` for a missing or
incorrect PIN, `404` for missing or expired pages, `429` for too many PIN
attempts, and `503` when PIN verification is busy. Titles and tags are public;
PINs protect bodies, versions, and raw content only.

## Discovery

- [llms.txt](/llms.txt): This agent-fetch recipe.
- [Well-known llms.txt](/.well-known/llms.txt): The same recipe at the standard path.