Sharing Playground Sessions

You can now share your Cosmo Playground session with others using a single URL. This feature enables easier collaboration and debugging across your team — no need to copy and paste queries or configurations manually.

What’s Included in the Share Link?

When creating a shareable link, you can choose which parts of your Playground session to include.

Here’s what you can share:

Option	Shareable?	Required	Notes
GraphQL Operation	Always	Yes	Always included by default. Cannot be deselected.
Variables	If present	No	Included only when content is available and the option is selected. If no content is present, the option appears disabled under “No content available to share. Add content to enable sharing these options.” To enable it, add relevant content in the Playground.
Headers	If present	No	Included only when content is available and the option is selected. If no content is present, the option appears disabled under “No content available to share. Add content to enable sharing these options.” To enable it, add relevant content in the Playground.

The GraphQL Operation could be a query, mutation or subscription

How to Share a Session?

1. Open the Playground and compose your GraphQL operation
2. Add any variables or headers you’d like to include
3. Click Share icon with the tooltip “Share Playground State” in the toolbar
4. A modal will appear with options to choose:

   • Available options will appear in top section
   • Unavailable options (if no content available) will appear in the bottom section
5. Select the available options you want to include in the shared link
6. Click "Copy link" to generate and copy the shareable URL

Opening a Shared Link

Recipients of a shared link will see the shared Playground session in a new tab with:

• The operation restored exactly as composed
• Optional variables and headers if they were included

Not Included in Shared Links

The following are never included in the shared link:

• Pre-flight scripts
• Pre-operation scripts
• Post-operation scripts

Security Considerations

If you choose to include headers, they are compressed and encoded as part of the generated URL. While the data is not human-readable, it is accessible to anyone who has the link. For your safety, avoid including sensitive data such as API tokens or credentials in shared headers.

Use Cases

• Share reproducible bugs with your team
• Collaborate on queries with full context
• Link to example queries in internal docs
• Speed up onboarding of new developers with pre-filled queries