@Redocly

Creators of Redoc & a whole suite of #API design and documentation tools for API producers and consumers. With Redocly, you can make API docs your superpower 💪

 Sign up at
redocly.com
Joined April 2018
  • Tweets369
  • Following37
  • Followers518
74Media
Realm 0.137.0 is out 🚀 • A setup page for your MCP server • A public MCP endpoint for mixed-access docs • Accordion tags • API search that reaches every field Same release for Reef, Revel, and Redoc. Highlights 🧵
2
5
1
13
591
New Markdoc tag: accordion. Fold FAQs, edge cases, and long examples under a title. Group several with accordion-group, and add singleExpanded to keep one open at a time. It renders a native <details> element, so keyboard and screen reader support is built in.
1
4
1
9
311
Syntax, attributes, and live examples: redocly.com/docs/realm/conte…
24
Is yes the same as true in YAML? In YAML 1.1, yes. In YAML 1.2, it's just the text "yes". Redocly CLI now catches this in AsyncAPI files: it checks the settings for message brokers like Amazon SQS and SNS, Google Pub/Sub, IBM MQ, and Pulsar.
1
3
1
11
449
What's in each release: redocly.com/docs/cli/changel…
55
Half your docs are public, half sit behind login. Which MCP endpoint should an AI tool use? Realm 0.137.0 serves both: /mcp → login, full RBAC /mcp-public → no login, only what anonymous visitors can read Turning it on takes one line 👇
1
3
2
14
515
Clients that call /mcp without a token get a 401 pointing them to /mcp-public, and the two setup pages link to each other. Before you enable it, check what your RBAC rules give the anonymous team: redocly.com/docs/realm/custo…
66
Your API, as a command-line tool. "redocly generate-client --generator cli" turns an OpenAPI description into a CLI: every operationId becomes a command, query parameters become typed flags, and "--dry-run" prints the request without sending it. Here's our Cafe API 👇
2
4
1
12
491
generate-client is experimental. Other generators cover TypeScript, Python, Go, and PHP SDKs, plus Zod, TanStack Query, SWR, and MSW mocks. redocly.com/docs/cli/guides/…
63
New Markdoc for writers: • accordion and accordion-group fold FAQs and edge cases under a title • card gets badges, CTAs, and link icons • admonition gets a new type: idea
1
44
API docs search now indexes every parameter, schema field, description heading, and AsyncAPI message. Search for a field name and the result takes you straight to that field. Everything in 0.137.0: redocly.com/docs/realm/chang…
34
Weekend metrics are in - and looking even better than expected! 📈 Early access is now live for users who opted in. Global rollout is set for ~30 days out to align with our sub-processor policies.
Redocly
@Redocly
Sep 18
We just shipped @typesafeai's Jev to prod as our AI Assistant's reranker. (it's under feature flag only for selected customers still) The early numbers are promising: ⚡ 3.3× faster (390 ms vs 1.29 s p50) 📉 slowest call 0.5 s vs 3.1 s 💸 55% cheaper ✅ 0 errors If numbers hold over the weekend we'll turn it on for everyone next week!
1
7
179
Not only Mermaid - Redocly supports PlantUML and Excalidraw out of the box. 🛠️🎨 Write your diagram code inline and let us handle the rendering - keeping your architecture docs clean, dynamic, and easy to maintain. Try it out: redocly.com/docs/realm/conte…
1
1
1
7
330
We just shipped @typesafeai's Jev to prod as our AI Assistant's reranker. (it's under feature flag only for selected customers still) The early numbers are promising: ⚡ 3.3× faster (390 ms vs 1.29 s p50) 📉 slowest call 0.5 s vs 3.1 s 💸 55% cheaper ✅ 0 errors If numbers hold over the weekend we'll turn it on for everyone next week!
7
4
3
17
1,082
Before shipping we replayed real user questions through it: Jev put the right docs higher (nDCG@5 0.65 vs 0.56, graded by an LLM judge).
1
109
Code mode is enabled for all organizations using Redocly's MCP server. ✅ Up to 90% fewer tool calls ✅ 50–90% input token savings ✅ Up to 5x cheaper with the same (or better!) accuracy Read all about how it works here: redocly.com/blog/mcp-code-mo…
1
4
2
14
532
New AI integration in Redocly CLI: redocly generate-spec --with-ai Generate OpenAPI from real traffic and enhance it with your local AI harness! redocly.com/blog/generate-op…
1
8
180
A year later, AI agents still aren't reading your /llms.txt file. Audit tools love it, but actual LLMs ignore it. If you want coding agents to actually use your docs, ditch the root file hype and focus on clean Markdown and MCP. redocly.com/blog/llms-txt-st…
3
1
6
426
Load more