PLATFORM UPDATE

Beyond a Website Redesign: How Carmen Cloud Became a More Complete SaaS Platform

The new carmencloud.com connects a familiar WordPress workflow to a static production frontend, role-based workspaces, scoped API keys and grounded AI documentation.

Carmen Cloud · Engineering & Product

The new carmencloud.com is live. The visible change is a new site, but the more important change sits behind it: Carmen Cloud now has a clearer separation between content management, the public production frontend and the application services customers use every day.

We kept WordPress as the familiar editorial environment. At the same time, the public site no longer depends on a traditional WordPress runtime for every request. Authentication, AI-assisted documentation, forms and backend processes are connected as independent services, while the production frontend can be published as a static experience.

That architectural shift happened alongside a broader redesign of Carmen Cloud itself. Workspaces are now real collaboration and billing boundaries, API keys can be managed per integration, and usage can be understood at both workspace and key level. The result is not just a faster website. It is a more practical foundation for teams building production systems with recognition APIs.

The old model had reached its limits

The earlier Carmen Cloud account model grew from a simpler product. A user, a company, a subscription, a workspace and an API credential were treated too much like one combined entity. That was understandable when the typical journey was one person creating one account and obtaining one key. It became restrictive as customers moved from experiments to shared, long-running integrations.

Real teams need more flexibility. A developer may work across several customer or environment-specific contexts. Finance may need invoice access without operational permissions. A production backend and a staging integration should not have to share the same credential. Rotating a key should not interrupt unrelated systems, and investigating unexpected usage should not begin with guesswork about which integration generated it.

These are not cosmetic dashboard issues. They are signs that identity, access, billing and consumption need separate, explicit boundaries.

Workspaces are now the organizing boundary

The redesigned model starts with the workspace. A user can own or be invited to multiple workspaces, and access can be granted according to role. Owners retain control of the workspace, administrators can manage operational settings, and billing users can work with subscriptions, credit purchases and invoices without receiving every other permission.

Each workspace brings together the resources that belong to one customer context or operational boundary:

  • subscriptions and prepaid credits;
  • API keys and their permissions;
  • usage data;
  • stored recognition events and hook settings;
  • the people who are allowed to manage them.

This gives companies a clean way to separate clients, products, environments or business units while still allowing the same person to participate in more than one workspace. It also makes the commercial model easier to understand: subscriptions and billing belong to the workspace that consumes the service, not implicitly to one individual user.

Carmen Cloud workspace connecting team members, scoped API keys, usage reporting and vehicle recognition services
Workspaces now provide a shared boundary for roles, subscriptions, API keys, usage and operational settings.

Multiple API keys, with a purpose for each one

A production API credential should represent an integration, not a person. Carmen Cloud now allows multiple API keys within a workspace so that teams can create separate credentials for different applications, services and environments.

Access can be limited per key to the products that integration actually needs. Where a controlled rollout or compatibility requirement calls for it, API-version and engine-parameter overrides can also be assigned at key level. Keys can be used for the appropriate frontend-assisted or backend/service-to-service calling pattern without forcing unrelated consumers to share one all-purpose secret.

This makes routine operational work safer and simpler. A staging credential can be revoked without touching production. A partner integration can receive only the required API access. Key rotation can be performed one system at a time. If traffic changes unexpectedly, usage can be reviewed by workspace and by individual API key.

The benefit is less about adding settings and more about reducing ambiguity. Each credential has an owner, a scope and a reason to exist.

Documentation that understands the product boundary

The documentation experience was rebuilt as part of the same project. Carmen Cloud now combines structured reference material, practical tutorials and an AI-assisted search and chat layer.

This matters because related recognition products can sound deceptively similar in a short question. The Vehicle API analyzes vehicle images and can return license-plate data together with vehicle make, model and color information; it can also process ADR hazardous-material markings when that service is requested. The Transportation & Cargo API is intended for logistics identifiers such as ISO container codes, rail wagon IDs and trailer numbers, with its own validation rules and parameters.

An assistant that simply sees “recognize a code on a truck” can easily blend these domains and produce a plausible but unusable answer. We therefore adapted the AI-Kit backend templates and knowledge-base instructions around explicit product boundaries. Questions are routed toward the relevant source set, and ambiguous requests should be clarified rather than answered with a mixture of Vehicle and Transportation & Cargo parameters.

Developer using AI documentation search for the Carmen Cloud Vehicle and Transportation APIs
Grounded search and chat keep vehicle-recognition questions separate from transportation and cargo code recognition.

The knowledge base is deliberately curated. Its initial stable source set focuses on the finalized Vehicle API, Transportation & Cargo API and PR (Passport Reader) API documentation, while unfinished or overlapping material is kept out until it is ready. The goal is not to make the assistant sound certain about everything. The goal is to make it useful within the documentation we can stand behind.

The same principle applies to DocSearch: results should lead developers to the right reference, tutorial or API definition instead of merely matching similar words. AI adds a conversational entry point, but the maintained documentation remains the source of truth.

WordPress stayed — its production role changed

WordPress and Elementor remain useful for the people who create and update Carmen Cloud content. Replacing that editorial workflow would have added migration work without improving the product. Instead, we changed what happens after content is ready to publish.

The production site is published through a static workflow. Rendered pages and the assets required by the browser are delivered independently of the WordPress authoring runtime. This reduces the number of runtime concerns attached to a public content request and gives us a predictable publication step.

“Static” does not mean the site has become non-interactive. It means that page delivery and application behavior are separated. Authentication runs against the identity layer, the dashboard calls protected APIs, AI features use their configured backend, and forms can trigger backend processes. WordPress remains the place where the experience is assembled; it is no longer required to execute every production interaction.

Behind the build

A note on the implementation

For the WordPress-facing layer, we used WP Suite: Static Publisher for the publication workflow, Gatey for authentication, AI-Kit for documentation search and chat, and Flow for forms and backend-connected processes. Having these pieces work around the same WordPress-to-services boundary shortened the integration work. It did not replace the Carmen Cloud dashboard or its domain logic; it gave us more time to focus on the workspace model, permissions, API-key controls, billing behavior and documentation quality.

One production experience, with clearer responsibilities

Experience

WordPress + Elementor

Editorial content and page layout remain in the familiar authoring workflow.

Delivery

Static publication

The public frontend is delivered independently of the WordPress runtime.

Identity

Authentication layer

Sign-in and account sessions connect to the dedicated identity service.

Product

Carmen Cloud APIs

Workspaces, billing, keys, usage and recognition remain product-owned behavior.

Knowledge

Docs + grounded AI

Maintained sources stay authoritative while search and chat improve discovery.

Processes

Forms + workflows

Structured interactions can continue into backend-connected actions.

This separation makes change less risky. Content can evolve without rewriting authentication. A new API key policy does not require a new CMS. Documentation prompts can be refined without changing recognition endpoints. The components still form one user experience, but they no longer need to be one runtime.

What this enables next

For Carmen Cloud customers, the immediate improvements are practical: teams can share workspaces with appropriate roles, keep billing attached to the correct operational context, issue separate API keys, restrict their access and understand where usage originates.

For us, the platform is now in a better position to grow. New documentation can be added to a clearer information model. AI answers can be evaluated against explicit product scopes. Dashboard capabilities can evolve around stable workspace boundaries, and the public site can be published through a repeatable workflow.

The launch of the new carmencloud.com is therefore both a website milestone and a platform milestone. WordPress is still there, doing the job it does well. Around it, Carmen Cloud now has a production architecture that better reflects how a modern SaaS product is actually used: by multiple people, across multiple integrations, with access, billing, documentation and operations treated as first-class concerns.

Explore the new Carmen Cloud

Start with the developer documentation, or sign in to see the workspace and API-key model in the Cloud Dashboard.