Workflow catalogue

Search, run, and save public workflows shared by other Libretto Cloud tenants.

Catalogue commands require LIBRETTO_API_KEY. The API key's tenant owns each run and bookmark. Publishers do not receive access to the caller's tenant, credentials, or results.

Each catalogue workflow also exposes reviewed source code on its public page. See Sharing workflows externally for the publisher flow.

CLI

Search the public catalogue and inspect a workflow before running it:

12libretto cloud catalogue search eligibility
libretto cloud catalogue get acme/check-eligibility

Start a run with input parameters and references to credentials already stored in your Libretto Cloud tenant:

123libretto cloud catalogue run acme/check-eligibility \
  --params '{"member_id":"123"}' \
  --credentials '{"portal_login":"payer-portal"}'

The command returns a job ID. Poll once or wait until it reaches a terminal state:

12libretto cloud catalogue status <job-id>
libretto cloud catalogue status <job-id> --watch

Save a workflow with an optional alias, notes, and non-secret defaults:

12345678libretto cloud catalogue save acme/check-eligibility \
  --alias eligibility \
  --notes "Default west region" \
  --defaults '{"region":"west"}'

libretto cloud catalogue saved
libretto cloud catalogue run eligibility --params '{"member_id":"123"}'
libretto cloud catalogue remove <bookmark-id>

Explicit run parameters override saved defaults. Use --json on any command for machine-readable output. Commands that accept JSON also accept the matching file option, such as --params-file, --credentials-file, or --defaults-file.

Do not put secret values in params or bookmark defaults. The --credentials map contains stored credential IDs or names, not raw secrets.

HTTP routes

All routes require x-api-key.

Method	Route	Purpose
`GET`	`/v1/catalogue?q=<query>&limit=<limit>`	Search the catalogue.
`GET`	`/v1/catalogue/:publisher/:workflow`	Inspect one workflow.
`POST`	`/v1/catalogue/run/:publisher/:workflow`	Queue a run.
`GET`	`/v1/catalogue/bookmarks`	List tenant bookmarks.
`POST`	`/v1/catalogue/bookmarks`	Save or update a bookmark.
`DELETE`	`/v1/catalogue/bookmarks/:id`	Remove a bookmark.

Poll run results with POST /v1/jobs/get. See Jobs and logs for the response fields.

The bookmark save body uses this shape:

12345678{
  "workflow": "acme/check-eligibility",
  "alias": "eligibility",
  "notes": "Default west region",
  "default_params": {
    "region": "west"
  }
}

If a publisher stops sharing a workflow or disables sharing, the bookmark stays in the tenant's saved list and becomes unavailable. Libretto does not return the disabled publication's schemas and will not run it.