Stories from the workspace
Tutorials, release notes, and the design choices behind what we ship.
- How to secure API secrets in APIKumo: Bearer, Basic, and API-key auth without ever hardcoding a value — A practical guide to using APIKumo's built-in Bearer, Basic, and API-key auth modes together with environment variables, so your credentials stay out of version control, exported files, and shared code samples.
- Onboarding a new developer to your API in under ten minutes using APIKumo's Try-it panel and MCP endpoint — Publishing your API with APIKumo gives new developers a live Try-it panel and an MCP endpoint so they can make a real, authenticated call on day one — no lengthy setup guide required.
- Organizing large collections with nested folders, context menus, and naming conventions — When a collection grows past a few dozen endpoints, structure becomes as important as the requests themselves. Here are practical strategies for using nested folders, context menus, and naming conventions to keep large APIKumo collections fast to navigate and easy to maintain.
- Importing an OpenAPI 3 spec into APIKumo: what comes in and what to do next — If your team already maintains an OpenAPI 3 or Swagger 2.0 spec, you can have a fully navigable APIKumo collection — with requests, schemas, and auth — in under a minute. This post walks through exactly what gets mapped on import and which manual steps unlock the most value afterward.
- Versioning your API docs in APIKumo: when to snapshot, what the changelog shows readers — Learn how to use APIKumo's versioning and changelog features to ship breaking and additive API changes confidently — without disrupting the docs your readers depend on today.
- How APIKumo's visibility modes let you graduate docs from private to public at your own pace — APIKumo's three visibility modes — Closed, Open, and Restricted — give developer-experience teams and indie API builders a structured way to graduate docs from private to public without ever losing control of who sees what.
- Syncing your collection across devices: how sign-in and cloud sync work in APIKumo — APIKumo automatically syncs your collections, environments, and saved requests across every device you sign in from — here is how the sync model works and how your secrets stay safe.
- How to write schema descriptions that power the docs chat assistant — The quality of your published docs chat assistant depends almost entirely on what you write in the schema editor. This guide shows API producers how to write field descriptions, enum explanations, and example values that give Claude the grounding it needs to answer reader questions accurately.
- How to design request and response schemas in APIKumo for cleaner, self-documenting APIs — APIKumo's structured schema editor lets you define fields, types, enums, and examples inline — and every detail surfaces automatically in your published docs without a single extra line of writing.
- Using the Cmd/Ctrl+K palette and multi-tab editing to navigate large collections fast — When your APIKumo workspace grows to dozens or hundreds of saved requests, knowing how to navigate it efficiently matters as much as knowing your API. This guide covers the keyboard-first workflows — the command palette, multi-tab editing, and right-click context menus — that keep you moving fast.
- Publishing your API docs site on a custom apikumo.com subdomain: a setup walkthrough — Learn how to publish your API documentation to a public apikumo.com subdomain — from picking a memorable name and setting visibility to sharing per-endpoint permalinks and exposing llms.txt so AI agents can discover your API.
- How to use environments and variables to manage Local, Staging, and Production configs — Managing Local, Staging, and Production API configs in one tool is painless when you use APIKumo's environments and {{variable}} substitution — here's a complete walkthrough.