Blog

Guides & updates from APIKumo

Notes on building APIs, shipping docs, and wiring up MCP — straight from the team.

How to secure API secrets in APIKumo: Bearer, Basic, and API-key auth without ever hardcoding a value
tutorial

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.

7 min read
Onboarding a new developer to your API in under ten minutes using APIKumo's Try-it panel and MCP endpoint
tutorial

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.

7 min read
Organizing large collections with nested folders, context menus, and naming conventions
tutorial

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.

7 min read
Importing an OpenAPI 3 spec into APIKumo: what comes in and what to do next
tutorial

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.

6 min read
Versioning your API docs in APIKumo: when to snapshot, what the changelog shows readers
docs

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.

6 min read
How APIKumo's visibility modes let you graduate docs from private to public at your own pace
guide

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.

7 min read
Syncing your collection across devices: how sign-in and cloud sync work in APIKumo
guide

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.

6 min read
How to write schema descriptions that power the docs chat assistant
tutorial

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.

6 min read
How to design request and response schemas in APIKumo for cleaner, self-documenting APIs
tutorial

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.

7 min read