Prepared Docs

Prepared Docs

⌘K

    Loading navigation…

User

  1. Working With Data
  2. Axonmundi
  3. Studio

Use Cosmo Studio

Inspect compositions and the client schema in AxonMundi's self-hosted Cosmo Studio

Cosmo Studio is where you inspect the axonmundi federated graph, its subgraphs, composition results, schema checks, changelog, and client schema. Studio is an administration and inspection tool; it does not authenticate router requests for you.

Sign in

Open Studio, choose email sign-in, and complete the Okta redirect. That browser session is separate from both a Prepared end-user bearer token and the CLI's wgc auth login device flow.

After signing in, open the axonmundi graph in the default namespace. If the graph or namespace is unavailable, request the least-privileged access needed from the Studio or Platform owner. Do not use a shared account.

Inspect a graph change

Before treating a subgraph publication as ready for clients:

  1. Open Subgraphs and confirm the service appears under the graph's label matcher.
  2. Inspect the latest composition result. Resolve composition errors before relying on a published schema.
  3. In Schema Explorer, verify the composed client schema, field ownership, and the intended API surface. It is the schema consumers should validate against, not a raw subgraph SDL.
  4. Review Schema Checks and the Changelog for breaking changes.

Traffic-based analysis represents requests that have reached the router. It does not prove an unobserved frontend path is safe, so frontend and producer CI must still validate the operation documents they can ship.

Playground++ and tracing

Use Playground++ only for approved, non-sensitive requests. It is a GraphQL client, not an authorization proxy: querying protected fields requires the same short-lived Prepared access token used by the application.

  • Add X-WG-Include-Query-Plan: true to include the query plan.
  • Add X-WG-TRACE: true to inspect Advanced Request Tracing.

Tracing can expose subgraph timings, inputs, and outputs. Use synthetic or approved non-sensitive data only. Studio may retain query text and configured headers, so never save a bearer token to a shared or long-lived Playground session. Clear one-off headers after use.

For an authorized, temporary token workflow and endpoint details, see Explore the graph.

Make client usage visible

For Studio to accurately track traffic and protect against breaking changes, always use named operations when writing queries, mutations, or subscriptions (e.g., query GetUserProfile rather than an anonymous query { ... }).

Client applications calling Mundi attach stable identification headers:

These headers allow Studio to associate observed operations with specific client releases so breaking-change checks are actionable. The client operation contract defines the complete validation and persisted-operations rollout path.

Next steps

  • Registry and schema workflow for the frontend schema refresh workflow.
  • AxonMundi Studio access for RBAC and SSO administration.

Previous

AxonMundi / AxonMundi onboarding

Next

AxonMundi / Registry and schema workflow

On this page

Sign in
Inspect a graph change
Playground++ and tracing
Make client usage visible
Next steps