For AI agents: the complete documentation index is at https://docs.routebase.dev/llms.txt. Every page is also available as Markdown by appending index.md to its URL or by sending Accept: text/markdown.
MCP Reference

Promotions, Sync & Audit — MCP Tools

Promotion history, artifact sync reviews and the audit log of a spec. This page documents the Promotions, Sync & Audit group of the Routebase MCP server, with the scope and the parameters of each tool.

A session that stages its tools advertises this group once the agent calls enable_toolset with the slug api-design-insight. Full-access keys, scoped keys and OAuth sessions see every tool they are allowed to call without that step.

get_audit_log

Read the API design audit log: who changed what, when, and whether it was a person or an API key. Filter by entityId for the history of one endpoint or schema — worth doing before changing something you did not write. Paginated; without filters it returns the whole organization's history newest first. Requires organization context.

Required scope: specs:read

Parameter Type Required Description
specId string No Optional spec ID (GUID) to filter by
entityId string No Optional entity ID (GUID) — the endpoint, schema or folder to trace
entityType string No Optional entity type to filter by, e.g. 'endpoint', 'schema', 'folder'
action string No Optional action to filter by, e.g. 'created', 'updated', 'deleted'
actorUserId integer No Optional numeric user ID to filter by
dateFrom string No Optional lower bound, ISO 8601 (e.g. '2026-07-01T00:00:00Z')
dateTo string No Optional upper bound, ISO 8601
page integer No (default 1) Page number, 1-based (default 1)
pageSize integer No (default 50) Entries per page (default 50, max 200)

list_artifact_sync_reviews

List what in this project has fallen out of sync with the specs behind it — mocks, tests and monitors whose endpoint changed or disappeared. Worth reading after changing a draft: these are the follow-ups that change created. Requires project context.

Required scope: specs:read

No parameters.

list_promotions

List how versions of a spec reached their environments: which version, which environment, whether it was a rollback and whether it froze the version. get_environment_pins shows the current state; this is how it got there. Requires project context.

Required scope: specs:read

Parameter Type Required Description
specId string Yes Public ID (GUID) of the API specification
environmentId string No Optional environment ID (GUID) to filter by
take integer No (default 50) How many entries to return, newest first (default 50)