Skip to main content
Make hosted workflow source code public through Libretto Cloud.
The cloud share command creates a public code share for a workflow that is already deployed to Libretto Cloud. Use it when you want anyone with the generated URL to fork your automation code and use it as the starting point for their own automation.
Workflow sharing requires a Libretto Cloud account, API key, and tenant-level code sharing. Code sharing is disabled by default for new tenants. If you have not set up Libretto Cloud yet, start with Libretto Cloud Hosting.

​
cloud share

​
Syntax

​
workflow
string
required
The hosted workflow name to share. This is the workflow name declared in code and deployed with npx libretto cloud deploy.
​
--refresh
boolean
Refresh an existing share from the workflow’s current deployment.

​
Prerequisites

1

Create a Libretto Cloud account

Sign up for Libretto Cloud before sharing workflows:
See Libretto Cloud Hosting for the full hosted setup flow.
2

Issue an API key

Create an API key and expose it as LIBRETTO_API_KEY:
3

Enable code sharing

Code sharing is disabled by default for each tenant. Enable it before creating public workflow links:
4

Deploy the workflow

Share works on hosted workflows. Deploy the package that contains the workflow before sharing it:

​
Output

When sharing succeeds, Libretto prints the public marketplace URL and code URL:
If the workflow is already shared, rerun the command with --refresh to update the shared code from the current deployment:

​
cloud sharing

Use the cloud sharing commands to inspect or change whether public workflow code sharing is enabled for the current Libretto Cloud tenant. New tenants start with code sharing disabled.
All cloud sharing commands require LIBRETTO_API_KEY.
Shared workflow code is public. Review the deployed source before sharing, and keep credentials in Libretto Cloud credentials or environment configuration instead of hard-coding them in workflow files.