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?
Open the Playground and compose your GraphQL operation
Add any variables or headers you’d like to include
Click Share icon with the tooltip “Share Playground State” in the toolbar
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
Select the available options you want to include in the shared link
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