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

Frequently asked questions

Everything you need to know about Theneo's

How does Theneo auto-detect changes in my API and documentation?

Theneo automatically detects changes through two primary methods:

CI/CD Pipeline Integration: By integrating Theneo with your existing CI/CD pipeline, it can monitor and identify changes every time you deploy updates. This ensures that any modifications made during the development and deployment processes are captured seamlessly.


Web Editor Deployments: If you manually make changes using Theneo's web editor and deploy them, Theneo will automatically detect these updates. This flexibility allows you to manage changes both programmatically and manually without missing any alterations.

This dual approach ensures comprehensive and real-time tracking of all changes to your API and documentation without requiring manual intervention.

What qualifies as a breaking change, and how is it flagged?

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.

What details are included in the AI-generated release notes?

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.

Is there a cost for using Theneo's changelog features?

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.

How does Theneo ensure enterprise-grade security and compliance?

No, Theneo's changelog features are completely free. Users can subscribe to and receive as many updates as they want without any cost. This allows your team and users to stay informed about all changes and enhancements without any financial barriers.

How does Theneo auto-detect changes in my API and documentation?

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.

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