Frequently Asked Questions

Everything you need to know about Theneo’s AI-native docs & developer portals

What formats can I import?

OpenAPI 2.0/3.x (YAML/JSON), Swagger, Postman Collections, GraphQL (SDL/introspection), SOAP/WSDL, gRPC (proto), Markdown/MDX, HTML, Insomnia, and more. You can combine auto-generated API reference with hand-written pages.

Will Theneo stay in sync with our APIs and code?

Yes. Connect your specs or repo and Theneo auto-detects changes. Choose auto-publish, PR-gated, or staged deployments. CLI and API let you trigger builds from CI and keep environments in lockstep with releases.

More information https://app.theneo.io/theneo/quickstart/automation-and-dev-tools/github-actions

Do you support Git workflows, approvals, and content reuse?

Yes. Git-based drafts, branches, and reviews; inline comments and suggestions; required approvers; reusable snippets, variables, and templates for shared content (e.g., auth notes, error handling).

How interactive is the reference? (examples, auth, “try it”)

Live Try-it with API keys and OAuth flows, per-env base URLs, and pre-populated sample requests/responses generated from schemas. Examples can be static, auto-generated, or curated per language.

How far can we customize and white-label?

From theme tweaks to full white-label on Enterprise: custom CSS/JS, typography, layouts, sidebars, landing pages, and even a bespoke reference UI. Multi-brand, multi-project portals are supported.

Can we use our own domains and environments?

Yes. Custom domains + SSL (e.g., docs.company.com), preview/staging environments, and environment-specific variables (keys, base URLs). Supports private, public, or mixed sites.

How powerful is search?

AI search + semantic Q&A across references and guides, typo-tolerant and synonym-aware, with filters/facets. Enterprise can search across multiple projects/workspaces.

Can Theneo automate changelogs and release notes?

Yes. We detect spec/content diffs and draft changelogs and release notes automatically. You can publish instantly and optionally notify email subscribers.

How do we control access? (SSO, RBAC, private/public)

Role-based permissions, domain allow-lists, private sections, approval queues, and audit logs. SSO via SAML/OIDC/JWT (Okta, Azure AD, Google Workspace) is supported.

What about hosting options, data residency, and certifications?

Hosted on AWS (U.S. by default) with encryption in transit and at rest. Enterprise can request regional hosting or self-hosting (private cloud/on-prem) with BYO-AI or AI disabled. Compliance: ISO 27001, ISO 9001, SOC 2, GDPR. Backups and BCP/DR in place.

How do you handle performance and traffic spikes?

Global CDN and caching; assets and pages are optimized for fast TTFB and LCP. Proven with large, high-traffic public portals and very large specs/content sets.

Do you support localization?

Yes. Multi-language sites with human or AI-assisted translation and per-locale routing. Strings/snippets can be reused across locales with manual overrides.

What does onboarding and support look like? What are the SLAs?

Growth and Enterprise includes migration help. Enterprise includes design/customization, a dedicated account manager, private Slack channel, and weekly check-ins. Uptime SLA and support SLAs apply by plan. Staging environments are included for Enterprise.

All of this to increase
API usage & adoption 3x times

NEW
Cursor for your API

Design, test, and ship APIs with AI, plus a local MCP server