WunderGraph

opencollection: 1.0.0
info:
  name: WunderGraph Cosmo Platform API
  version: 1.0.0
items:
- info:
    name: Namespaces
    type: folder
  items:
  - info:
      name: WunderGraph List namespaces
      type: http
    http:
      method: GET
      url: https://cosmo-cp.wundergraph.com/v1/namespaces
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Lists all namespaces within the organization. Namespaces provide logical isolation for federated graphs, subgraphs,
      and other resources.
  - info:
      name: WunderGraph Create a namespace
      type: http
    http:
      method: POST
      url: https://cosmo-cp.wundergraph.com/v1/namespaces
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Creates a new namespace within the organization for organizing federated graphs and subgraphs.
  - info:
      name: WunderGraph Delete a namespace
      type: http
    http:
      method: DELETE
      url: https://cosmo-cp.wundergraph.com/v1/namespaces/:name
      params:
      - name: name
        value: ''
        type: path
        description: The name of the namespace to delete.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Deletes a namespace and all associated resources including federated graphs and subgraphs.
  - info:
      name: WunderGraph Rename a namespace
      type: http
    http:
      method: POST
      url: https://cosmo-cp.wundergraph.com/v1/namespaces/:name/rename
      params:
      - name: name
        value: ''
        type: path
        description: The current name of the namespace.
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Renames an existing namespace.
- info:
    name: Federated Graphs
    type: folder
  items:
  - info:
      name: WunderGraph List federated graphs
      type: http
    http:
      method: GET
      url: https://cosmo-cp.wundergraph.com/v1/federated-graphs
      params:
      - name: namespace
        value: ''
        type: query
        description: Filter by namespace name.
      - name: limit
        value: ''
        type: query
        description: Maximum number of results to return.
      - name: offset
        value: ''
        type: query
        description: Number of results to skip.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Lists all federated graphs in the organization, optionally filtered by namespace. Federated graphs represent the
      composed supergraph made up of multiple subgraphs.
  - info:
      name: WunderGraph Create a federated graph
      type: http
    http:
      method: POST
      url: https://cosmo-cp.wundergraph.com/v1/federated-graphs
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Creates a new federated graph. A federated graph is composed from one or more subgraphs selected by label matchers.
  - info:
      name: WunderGraph Get a federated graph
      type: http
    http:
      method: GET
      url: https://cosmo-cp.wundergraph.com/v1/federated-graphs/:name
      params:
      - name: name
        value: ''
        type: path
        description: The name of the federated graph.
      - name: namespace
        value: ''
        type: query
        description: The namespace of the graph.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Retrieves details of a specific federated graph by name.
  - info:
      name: WunderGraph Update a federated graph
      type: http
    http:
      method: PUT
      url: https://cosmo-cp.wundergraph.com/v1/federated-graphs/:name
      params:
      - name: name
        value: ''
        type: path
        description: The name of the federated graph to update.
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Updates the configuration of an existing federated graph, including its routing URL, label matchers, or admission
      webhook.
  - info:
      name: WunderGraph Delete a federated graph
      type: http
    http:
      method: DELETE
      url: https://cosmo-cp.wundergraph.com/v1/federated-graphs/:name
      params:
      - name: name
        value: ''
        type: path
        description: The name of the federated graph to delete.
      - name: namespace
        value: ''
        type: query
        description: The namespace of the graph.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Deletes a federated graph and its associated configuration from the control plane.
  - info:
      name: WunderGraph Fetch federated graph SDL
      type: http
    http:
      method: GET
      url: https://cosmo-cp.wundergraph.com/v1/federated-graphs/:name/fetch
      params:
      - name: name
        value: ''
        type: path
        description: The name of the federated graph.
      - name: namespace
        value: ''
        type: query
        description: The namespace of the graph.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Downloads the latest valid Schema Definition Language (SDL) of a federated graph and all its subgraphs from the
      control plane.
  - info:
      name: WunderGraph Get federated graph changelog
      type: http
    http:
      method: GET
      url: https://cosmo-cp.wundergraph.com/v1/federated-graphs/:name/changelog
      params:
      - name: name
        value: ''
        type: path
        description: The name of the federated graph.
      - name: namespace
        value: ''
        type: query
        description: The namespace of the graph.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Retrieves the composition changelog for a federated graph showing schema changes over time.
  - info:
      name: WunderGraph Move a federated graph to another namespace
      type: http
    http:
      method: POST
      url: https://cosmo-cp.wundergraph.com/v1/federated-graphs/:name/move
      params:
      - name: name
        value: ''
        type: path
        description: The name of the federated graph to move.
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Moves a federated graph from one namespace to another.
- info:
    name: Subgraphs
    type: folder
  items:
  - info:
      name: WunderGraph List subgraphs
      type: http
    http:
      method: GET
      url: https://cosmo-cp.wundergraph.com/v1/subgraphs
      params:
      - name: namespace
        value: ''
        type: query
        description: Filter by namespace name.
      - name: limit
        value: ''
        type: query
        description: Maximum number of results to return.
      - name: offset
        value: ''
        type: query
        description: Number of results to skip.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Lists all subgraphs in the organization, optionally filtered by namespace. Subgraphs are isolated GraphQL schemas
      that compose into federated graphs.
  - info:
      name: WunderGraph Create a subgraph
      type: http
    http:
      method: POST
      url: https://cosmo-cp.wundergraph.com/v1/subgraphs
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Creates a new subgraph within the Cosmo platform. Subgraphs are isolated GraphQL schemas that can be independently
      deployed and managed, providing modularity and scalability to your GraphQL APIs.
  - info:
      name: WunderGraph Get a subgraph
      type: http
    http:
      method: GET
      url: https://cosmo-cp.wundergraph.com/v1/subgraphs/:name
      params:
      - name: name
        value: ''
        type: path
        description: The name of the subgraph.
      - name: namespace
        value: ''
        type: query
        description: The namespace of the subgraph.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Retrieves details of a specific subgraph by name.
  - info:
      name: WunderGraph Update a subgraph
      type: http
    http:
      method: PUT
      url: https://cosmo-cp.wundergraph.com/v1/subgraphs/:name
      params:
      - name: name
        value: ''
        type: path
        description: The name of the subgraph to update.
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Updates the configuration of an existing subgraph, such as its routing URL, labels, or subscription settings.
  - info:
      name: WunderGraph Delete a subgraph
      type: http
    http:
      method: DELETE
      url: https://cosmo-cp.wundergraph.com/v1/subgraphs/:name
      params:
      - name: name
        value: ''
        type: path
        description: The name of the subgraph to delete.
      - name: namespace
        value: ''
        type: query
        description: The namespace of the subgraph.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Deletes a subgraph from the platform. This will trigger recomposition of any federated graphs that included this
      subgraph.
  - info:
      name: WunderGraph Publish a subgraph schema
      type: http
    http:
      method: POST
      url: https://cosmo-cp.wundergraph.com/v1/subgraphs/:name/publish
      params:
      - name: name
        value: ''
        type: path
        description: The name of the subgraph to publish.
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Publishes a new schema for the specified subgraph. This triggers composition checks and updates the federated graphs
      that include this subgraph.
  - info:
      name: WunderGraph Check a subgraph schema
      type: http
    http:
      method: POST
      url: https://cosmo-cp.wundergraph.com/v1/subgraphs/:name/check
      params:
      - name: name
        value: ''
        type: path
        description: The name of the subgraph to check.
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Checks a subgraph schema for breaking changes and composition errors across all connected federated graphs without
      publishing. Used for CI/CD validation.
  - info:
      name: WunderGraph Fetch subgraph SDL
      type: http
    http:
      method: GET
      url: https://cosmo-cp.wundergraph.com/v1/subgraphs/:name/fetch
      params:
      - name: name
        value: ''
        type: path
        description: The name of the subgraph.
      - name: namespace
        value: ''
        type: query
        description: The namespace of the subgraph.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Downloads the latest valid Schema Definition Language (SDL) of a specific subgraph.
  - info:
      name: WunderGraph Move a subgraph to another namespace
      type: http
    http:
      method: POST
      url: https://cosmo-cp.wundergraph.com/v1/subgraphs/:name/move
      params:
      - name: name
        value: ''
        type: path
        description: The name of the subgraph to move.
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Moves a subgraph from one namespace to another.
- info:
    name: Monographs
    type: folder
  items:
  - info:
      name: WunderGraph List monographs
      type: http
    http:
      method: GET
      url: https://cosmo-cp.wundergraph.com/v1/monographs
      params:
      - name: namespace
        value: ''
        type: query
        description: Filter by namespace name.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Lists all monographs in the organization. A monograph is a graph with GraphQL Federation disabled, limited to a
      single subgraph.
  - info:
      name: WunderGraph Create a monograph
      type: http
    http:
      method: POST
      url: https://cosmo-cp.wundergraph.com/v1/monographs
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Creates a new monograph (non-federated, single subgraph graph) in the Cosmo platform.
  - info:
      name: WunderGraph Update a monograph
      type: http
    http:
      method: PUT
      url: https://cosmo-cp.wundergraph.com/v1/monographs/:name
      params:
      - name: name
        value: ''
        type: path
        description: The name of the monograph to update.
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Updates the configuration of an existing monograph.
  - info:
      name: WunderGraph Delete a monograph
      type: http
    http:
      method: DELETE
      url: https://cosmo-cp.wundergraph.com/v1/monographs/:name
      params:
      - name: name
        value: ''
        type: path
        description: The name of the monograph to delete.
      - name: namespace
        value: ''
        type: query
        description: The namespace of the monograph.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Deletes a monograph from the platform.
  - info:
      name: WunderGraph Publish a monograph schema
      type: http
    http:
      method: POST
      url: https://cosmo-cp.wundergraph.com/v1/monographs/:name/publish
      params:
      - name: name
        value: ''
        type: path
        description: The name of the monograph to publish.
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Publishes a new schema for the specified monograph.
- info:
    name: Schema Contracts
    type: folder
  items:
  - info:
      name: WunderGraph List schema contracts
      type: http
    http:
      method: GET
      url: https://cosmo-cp.wundergraph.com/v1/schema-contracts
      params:
      - name: namespace
        value: ''
        type: query
        description: Filter by namespace name.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Lists all schema contracts. Schema contracts let you provide filtered versions of your composed graph to different
      consumers.
  - info:
      name: WunderGraph Create a schema contract
      type: http
    http:
      method: POST
      url: https://cosmo-cp.wundergraph.com/v1/schema-contracts
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Creates a new schema contract that provides a filtered view of a federated graph based on tag exclusions.
- info:
    name: Feature Subgraphs
    type: folder
  items:
  - info:
      name: WunderGraph Create a feature subgraph
      type: http
    http:
      method: POST
      url: https://cosmo-cp.wundergraph.com/v1/feature-subgraphs
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Creates a feature subgraph based on an existing subgraph for gradual and experimental feature rollout using feature
      flags.
- info:
    name: Feature Flags
    type: folder
  items:
  - info:
      name: WunderGraph List feature flags
      type: http
    http:
      method: GET
      url: https://cosmo-cp.wundergraph.com/v1/feature-flags
      params:
      - name: namespace
        value: ''
        type: query
        description: Filter by namespace name.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Lists all feature flags in the organization for managing gradual rollout of graph changes.
  - info:
      name: WunderGraph Create a feature flag
      type: http
    http:
      method: POST
      url: https://cosmo-cp.wundergraph.com/v1/feature-flags
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Creates a new feature flag for enabling gradual rollout of feature subgraphs to federated graphs.
- info:
    name: Router
    type: folder
  items:
  - info:
      name: WunderGraph Compose router configuration
      type: http
    http:
      method: POST
      url: https://cosmo-cp.wundergraph.com/v1/router/compose
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Generates a router execution configuration for a federated graph. The router configuration is used by the Cosmo
      Router to serve the composed federated graph.
  - info:
      name: WunderGraph List router tokens
      type: http
    http:
      method: GET
      url: https://cosmo-cp.wundergraph.com/v1/router/tokens
      params:
      - name: federatedGraphName
        value: ''
        type: query
        description: The name of the federated graph.
      - name: namespace
        value: ''
        type: query
        description: The namespace of the graph.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Lists all router tokens for a federated graph. Router tokens are used to authenticate Cosmo Router instances with
      the control plane.
  - info:
      name: WunderGraph Create a router token
      type: http
    http:
      method: POST
      url: https://cosmo-cp.wundergraph.com/v1/router/tokens
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Creates a new router token for authenticating a Cosmo Router instance with the control plane.
- info:
    name: API Keys
    type: folder
  items:
  - info:
      name: WunderGraph List API keys
      type: http
    http:
      method: GET
      url: https://cosmo-cp.wundergraph.com/v1/api-keys
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Lists all API keys for the organization. API keys authenticate CLI and programmatic access to the Cosmo Platform
      API.
  - info:
      name: WunderGraph Create an API key
      type: http
    http:
      method: POST
      url: https://cosmo-cp.wundergraph.com/v1/api-keys
      body:
        type: json
        data: '{}'
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Creates a new API key for authenticating with the Cosmo Platform API. Keys can be scoped with specific permissions.
  - info:
      name: WunderGraph Delete an API key
      type: http
    http:
      method: DELETE
      url: https://cosmo-cp.wundergraph.com/v1/api-keys/:name
      params:
      - name: name
        value: ''
        type: path
        description: The name of the API key to delete.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Deletes an API key by name.
- info:
    name: Analytics
    type: folder
  items:
  - info:
      name: WunderGraph Get graph analytics
      type: http
    http:
      method: GET
      url: https://cosmo-cp.wundergraph.com/v1/analytics
      params:
      - name: federatedGraphName
        value: ''
        type: query
        description: The name of the federated graph.
      - name: namespace
        value: ''
        type: query
        description: The namespace of the graph.
      - name: startDate
        value: ''
        type: query
        description: Start of the analytics time range.
      - name: endDate
        value: ''
        type: query
        description: End of the analytics time range.
      auth:
        type: apikey
        key: Authorization
        value: '{{Authorization}}'
        placement: header
    docs: Retrieves analytics data for a federated graph including request metrics, latency, and error rates.
bundled: true