What should I use for authenticated API docs and examples?

For authenticated API docs and examples, the best choice is usually:

Use OpenAPI + Swagger UI / Redoc

• OpenAPI is the standard for defining your API.
• Swagger UI gives interactive docs where users can enter a token and try endpoints.
• Redoc gives very polished, readable docs.

Why this is a good fit

• Supports Bearer tokens, API keys, OAuth2, JWT, etc.
• Lets you document auth requirements per endpoint
• Makes it easy to show example requests/responses
• Can be generated from code or written manually

For authenticated examples specifically

Include in your OpenAPI spec:

• securitySchemes for auth
• security on endpoints
• examples for request/response bodies
• curl examples in descriptions or generated docs

If you want something more “developer portal” style

Consider:

• Stoplight
• ReadMe
• Postman documentation
• Fern

These are useful if you want:

• guided onboarding
• interactive auth flows
• code samples in multiple languages
• polished docs portals

Practical recommendation

• If you want open standard + flexibility: OpenAPI + Swagger UI
• If you want best-looking docs: Redoc
• If you want hosted developer portal: ReadMe or Stoplight

If you want, I can also suggest the best option for your stack like FastAPI, Express, Django, Rails, or .NET.