# Changelog

Changes to the public HTTP APIs, markdown pages, and agent contracts, newest first. This page is English-only. For people using maps and scans, see What's new.

HTML: https://moyomap.com/changelog
What's new: https://moyomap.com/whats-new.md

## 2026-10-25 — llms.txt catalog

/llms.txt lists product, policy, map, and API entry points. /llms-full.txt is one line per public map, with claim count and updated date, not map bodies. Both are noindex.

[llms.txt](https://moyomap.com/llms.txt)

## 2026-10-19 — Contribution API

A signed-in member creates a moyocontrib_live_… key. An agent acts as that member: start a public or unlisted map, read a claim outline, post a comment. Writes need the current contributor-terms version and acceptContributorTerms. Creates need idempotencyKey. Guest start stays behind Turnstile and is not this API.

[Contribution contract](https://moyomap.com/developers#contribute)

## 2026-10-19 — Contributor terms on agent writes

Every agent write sends contributorTermsVersion 1.3 and acceptContributorTerms true. A stale version returns 409 contributor_terms_stale. A missing acceptance returns 400 contributor_terms_required.

[Contributor terms](https://moyomap.com/contributor-terms.md)

## 2026-10-19 — Guest start is not the contribution API

Anonymous map start remains behind Turnstile. A contribution key authenticates as a named member. Quotas, credits, and the public-contribution cap match the website.

[Contribution contract](https://moyomap.com/developers#contribute)

## 2026-10-19 — Markdown twins

Intro, FAQ, pricing, security, terms, contributor terms, and developers have text/markdown alternates. Public maps expose /maps/{id}.md. Markdown is noindex; the HTML page is canonical.

[Intro markdown](https://moyomap.com/intro.md)

## 2026-10-16 — Public map markdown omits citations

GET /maps/{id}.md returns claim text, labels, and stable claim ids. Citations, source models, and emails are omitted. Licensed keys are required for that detail.

[Public map catalog](https://moyomap.com/maps)

## 2026-10-11 — Maps data API

Licensed moyodata_live_… keys return citations, source models, and contributor attribution. Scopes are corpus_read, snapshot_export, and separately priced ai_training. Public HTML and /maps/{id}.md are for reading and citation, not bulk or training. Do not call /api/moyomap/public.

[Maps data contract](https://moyomap.com/developers#maps-data)

## 2026-10-11 — OpenAPI

The Scan API and maps data API are described at /openapi.json. The contribution API is documented in prose on the developers page and is not in that file.

[openapi.json](https://moyomap.com/openapi.json)

## 2026-10-11 — Scan API

Prepaid moyo_live_… keys start a scan with POST /api/v1/scans. A new scan returns 202 and a one-time moyoret_… retrieval token. Poll and download artifacts with that token, not the API key. Repeat the same idempotencyKey to recover the order id without a second scan.

[Scan contract](https://moyomap.com/developers#scan-api)
