Skip to main content
Sharing controls who can access your apps and services. You can share directly with users, publish to your organization’s store, and manage who can publish new versions.

share

Share an app or service with a user or publish to your org store:
synthetiq share <entity-name> [options]

Share with a user

synthetiq share my-app --email colleague@acme.com --role contributor
FlagRequiredDescription
--email <email>Yes (for user sharing)Email of the user to share with
--role <role>NoAccess level: contributor or install (default: install)
RoleDescription
installCan install and use the entity
contributorCan install, use, and modify the entity’s source code

Share to organization store

synthetiq share my-app --store
Publishes the entity to your organization’s app store, making it available to all organization members.

share list

List all shares for an entity:
synthetiq share list <entity-name>
TYPE     TARGET                ROLE          DATE
User     colleague@acme.com    Contributor   Jun 10, 2024
User     dev@acme.com          Install       Jun 8, 2024
Store    acme-corp             —             Jun 5, 2024
FlagDescription
--jsonOutput as JSON

share remove

Remove a user’s access or remove from the org store:
synthetiq share remove <entity-name> --email <email>
synthetiq share remove <entity-name> --store
synthetiq share remove my-app --email dev@acme.com
synthetiq share remove my-app --store

publisher add

Add a user as a publisher for an entity:
synthetiq publisher add <entity-name> --email <email>
Publishers can push new versions of the entity. Only existing publishers can add new publishers.
synthetiq publisher add my-app --email co-developer@acme.com

publisher remove

Remove a user’s publisher access:
synthetiq publisher remove <entity-name> --email <email>
synthetiq publisher remove my-app --email co-developer@acme.com

publisher list

List all publishers for an entity:
synthetiq publisher list <entity-name>
EMAIL                     ADDED BY              DATE
you@acme.com              —                     Jun 1, 2024
co-developer@acme.com     you@acme.com          Jun 10, 2024
FlagDescription
--jsonOutput as JSON