Prismatic CLI Command Reference

The Prismatic CLI tool allows you to interact with the Prismatic API programmatically so you can build, deploy, and support integrations from the command line. This page lists the subcommands of prism that you can invoke. For an introduction on using the Prismatic CLI tool, see the CLI usage page.

---

Alerts CLI Commands

alerts:events:list

List Alert Events for an Alert Monitor

prism alerts:events:list <alertMonitorId> [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
alertMonitorId		ID of an alert monitor	true
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

alerts:groups:create

Create an Alert Group

prism alerts:groups:create [--print-requests] [--quiet] --name <string> [--users <string>] [--webhooks <string>]

Flag	Shorthand	Description	Required
--name	-n	name of the group to be created	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--users	-u	JSON-formatted list of Prismatic user IDs to alert	false
--webhooks	-w	JSON-formatted list of Alert Webhook IDs to alert	false

# Create an group for "DevOps"
prism alerts:groups:create \
    --name DevOps \
    --users "[\"$(prism organization:users:list \
                    --columns id \
                    --filter 'Name=John Doe' \
                    --no-header)\"]"

alerts:groups:delete

Delete an Alert Group

prism alerts:groups:delete <group> [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
group		ID of the group to delete	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

alerts:groups:list

List Alert Groups in your Organization

prism alerts:groups:list [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

# Fetch the ID and Name of all alert groups in JSON format, sorted descending by name
prism alerts:groups:list --columns "id,name" --output json --sort name

alerts:monitors:clear

Clear an Alert Monitor

prism alerts:monitors:clear <monitor> [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
monitor		ID of the monitor to clear	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

alerts:monitors:create

Create an Alert Monitor by attaching an Alert Trigger and a set of users and webhooks to an Instance

prism alerts:monitors:create [--print-requests] [--quiet] --name <string> --instance <string> --triggers <string> [--duration <string>] [--log-severity <string>] [--groups <string>] [--users <string>]

Flag	Shorthand	Description	Required
--duration	-d	greatest time allowed (in seconds) for time-based triggers	false
--groups	-g	JSON-formatted list of group IDs to alert	false
--instance	-i	ID of the instance to monitor	true
--log-severity	-s	greatest log level (debug, info, warn, error) allowed for log-based triggers	false
--name	-n	name of the alert monitor to be created	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--triggers	-t	JSON-formatted list of trigger IDs that should trigger this monitor	true
--users	-u	JSON-formatted list of Prismatic user IDs alert	false

Alert Monitors and Alert Groups

While individual users and webhooks can be tied to alert monitors, it is recommended that you create alert groups and attach alert groups to alert monitors. This helps in the case that you need to add a user to a set of monitors: it's simpler to edit a single alert group than to edit dozens of alert monitors.

# Create an alert monitor for an instance named "My Instance"
# and alert the "DevOps" group in the event that an
# instance execution takes longer than 10 seconds.
prism alerts:monitors:create \
    --name "Alert Devops of slow execution" \
    --instance $(prism instances:list \
                    --columns id \
                    --filter 'name=^My Instance$' \
                    --no-header) \
    --triggers "[\"$(prism alerts:triggers:list \
                    --columns id \
                    --filter 'name=^Execution Duration Matched or Exceeded$' \
                    --no-header)\"]" \
    --duration 10 \
    --groups "[\"$(prism alerts:groups:list \
                    --columns id \
                    --filter 'name=^DevOps$' \
                    --no-header)\"]"

alerts:monitors:delete

Delete an Alert Monitor

prism alerts:monitors:delete <monitor> [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
monitor		ID of the monitor to delete	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

alerts:monitors:list

List Alert Monitors for Customer Instances

prism alerts:monitors:list [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

alerts:triggers:list

List Alert Triggers

prism alerts:triggers:list [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

alerts:webhooks:create

Create an Alert Webhook

prism alerts:webhooks:create [--print-requests] [--quiet] --name <string> --url <string> [--headers <string>] --payloadTemplate <string>

Flag	Shorthand	Description	Required
--headers	-h	JSON-formatted object of key/value pairs to include in the request header	false
--name	-n	name of the webhook to be created	true
--payloadTemplate	-p	template string that will be used as the request body, see documentation for details	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--url	-u	URL that will receive a POST request for an alert	true

alerts:webhooks:delete

Delete an Alert Webhook

prism alerts:webhooks:delete <webhook> [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
webhook		ID of the webhook to delete	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

alerts:webhooks:list

List Alert Webhooks

prism alerts:webhooks:list [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

---

Components CLI Commands

components:actions:list

List Actions that Components implement

prism components:actions:list <componentKey> [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>] [--public] [--private]

Flag	Shorthand	Description	Required
componentKey		The key of the component to show actions for (e.g. 'salesforce')	true
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--private		Show actions for the private component with the given key. Use this flag when you have a private component with the same key as a public component.	false
--public		Show actions for the public component with the given key. Use this flag when you have a private component with the same key as a public component.	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

# Get the ID of the GET action of the HTTP component by action key
prism components:actions:list --columns id --filter 'key=^httpGet$' --no-header http

# Get actions related to the SFTP component
prism components:actions:list sftp

components:data-sources:list

List Data Sources that Components implement

prism components:data-sources:list <componentKey> [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>] [--public] [--private]

Flag	Shorthand	Description	Required
componentKey		The key of the component to show data sources for (e.g. 'salesforce')	true
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--private		Show data sources for the private component with the given key. Use this flag when you have a private component with the same key as a public component.	false
--public		Show data sources for the public component with the given key. Use this flag when you have a private component with the same key as a public component.	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

# Get data sources related to the Salesforce component
prism components:datasources:list salesforce

components:delete

Delete a Component

prism components:delete <component> [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
component		ID of the component to delete	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

components:dev:run

Fetch an integration's active connection and execute a CLI command with that connection's fields as an environment variable.

prism components:dev:run -i <value> -c <value> -- /command/to/run

Flag	Shorthand	Description	Required
--connectionKey	-c	Key of the connection config variable to fetch meta/state for	true
--instanceId		Instance ID.	false
--integrationId	-i	Integration ID	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

After specifying an integration ID and connection config variable name, this command executes a CLI command with that connection's fields saved as a config variable named PRISMATIC_CONNECTION_VALUE.

components:dev:run Examples

To simply print an integration's basic auth config variable named "My Credentials" and pipe the resulting JSON to jq, run:

$ prism components:dev:run
    --integrationId SW50ZWexample
    --connectionKey "My Connection" --
    printenv PRISMATIC_CONNECTION_VALUE | jq

If one of your integrations has an authenticated OAuth 2.0 config variable "Slack Connection", you could run your component's unit tests with that environment variable:

$ prism components:dev:run -i SW50ZWexample -c "Slack Connection" -- yarn run test

If you would like to fetch a connection from an instance deployed to one of your customers, specify the --instanceId flag instead

$ prism components:dev:run --instanceId SW50ZWexample -c "Slack Connection" -- yarn run test

components:dev:test

Run an action of a component within a test integration in the integration runner

prism components:dev:test [--print-requests] [--quiet] [--envPath <string>] [--[no-]build] [--output-file <string>] [--print-results] [--clean-up]

Flag	Shorthand	Description	Required
--[no-]build	-b	Build the component prior to testing	false
--clean-up		Clean up the integration and temporary component after running the action	false
--envPath	-e	Path to dotenv file to load for supplying testing values	false
--output-file	-o	Output the results of the action to a specified file	false
--print-requests		Print all GraphQL requests that are issued	false
--print-results		Print the results of the action to stdout	false
--quiet		Reduce helpful notes and text	false

components:init

Initialize a new Component

prism components:init <name> [--wsdl-path <string>] [--open-api-path <string>] [--verbose]

Flag	Shorthand	Description	Required
name		Name of the new component to create (alphanumeric characters, hyphens, and underscores)	true
--open-api-path		The path to an OpenAPI Specification file (JSON or YAML) used to generate a Component	false
--verbose		Output more verbose logging from Component generation	false
--wsdl-path		Path to the WSDL definition file used to generate a Component	false

# Initialize a new component directory for a component named "send-customer-invoices"
prism components:init send-customer-invoices

By providing a path to a local WSDL definition file, Prism is able to generate a component that translates the API methods available into Component Actions. First run the init command and provide a path to the WSDL file.

prism components:init --wsdl-path ./example.wsdl Example WSDL
# Next navigate into the created directory and install/build the Component with NPM or Yarn
yarn install && yarn build
# Finally publish your WSDL Component
prism components:publish

components:init:component

Initialize a new Component

prism components:init:component [--name <string>] [--description <string>]

Flag	Shorthand	Description	Required
--description	-d	Description for the component	false
--name	-n	Name of the component	false

components:list

List available Components

prism components:list [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>] [--showAllVersions]

Flag	Shorthand	Description	Required
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--showAllVersions	-a	If specified this command returns all versions of all components rather than only the latest version	false
--sort		property to sort by (prepend '-' for descending)	false

components:publish

Publish a Component to Prismatic

prism components:publish [--print-requests] [--quiet] [--comment <string>] [--[no-]confirm] [--[no-]check-signature] [--skip-on-signature-match] [--customer <string>] [--commitHash <string>] [--commitUrl <string>] [--repoUrl <string>] [--pullRequestUrl <string>]

Flag	Shorthand	Description	Required
--[no-]check-signature		Check signature of existing component and confirm publish if matched	false
--comment	-c	Comment about changes in this Publish	false
--commitHash		Commit hash corresponding to the component version being published	false
--commitUrl		URL to the commit details for this component version	false
--[no-]confirm		Interactively confirm publish	false
--customer		ID of customer with which to associate the component	false
--print-requests		Print all GraphQL requests that are issued	false
--pullRequestUrl		URL to the pull request that modified this component version	false
--quiet		Reduce helpful notes and text	false
--repoUrl		URL to the repository containing the component definition	false
--skip-on-signature-match		Skips component publish if the new signature matches the existing signature	false

Building Components

See writing custom connectors for information on building components with webpack.

# Build and publish a component
npx webpack
prism components:publish

components:signature

Generate a Component signature

prism components:signature [--print-requests] [--quiet] [--skip-signature-verify]

Flag	Shorthand	Description	Required
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--skip-signature-verify		This consistently returns a signature, regardless of whether the corresponding component has been published to the platform or not.	false

components:triggers:list

List Triggers that Components implement

prism components:triggers:list <componentKey> [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>] [--public] [--private]

Flag	Shorthand	Description	Required
componentKey		The key of the component to show triggers for (e.g. 'salesforce')	true
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--private		Show actions for the private component with the given key. Use this flag when you have a private component with the same key as a public component.	false
--public		Show actions for the public component with the given key. Use this flag when you have a private component with the same key as a public component.	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

# Get the ID of the Webhook trigger of the Webhook Triggers component by key
prism components:triggers:list --columns id --filter 'key=^webhook$' --no-header webhook-triggers

# Get triggers related to the Management Triggers component
prism components:triggers:list management-triggers

---

Customers CLI Commands

customers:create

Create a new Customer

prism customers:create [--print-requests] [--quiet] --name <string> [--description <string>] [--externalId <string>] [--label <string>]

Flag	Shorthand	Description	Required
--description	-d	longer description of the customer	false
--externalId	-e	external ID of the customer from your system	false
--label	-l	a label to apply to the customer	false
--name	-n	short name of the new customer	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

customers:create Examples

Apply multiple labels to a customer

prism customers:create --name "Widgets Inc" --externalId "abc-123" --label "Prod Customers" --label "Beta Testers"

customers:credentials:create

Create a set of Customer-specific Credentials for use by Instance Actions

prism customers:credentials:create [--print-requests] [--quiet] --customer <string> --label <string> --authorization-method <string> [--fields <string>]

Flag	Shorthand	Description	Required
--authorization-method	-a	ID of the authorization method	true
--customer	-c	ID of the customer	true
--fields	-f	username, password, etc., in JSON format	false
--label	-l	name to give the new credentials	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

# Save a JWT token for "Our First Customer"
prism customers:credentials:create \
    --label 'JWT to website.com' \
    --authorization-method $(prism authorization-methods:list --output json --extended | jq -r '.[] | select(.key == "api_key").id') \
    --fields '{"api_key": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJuYW1lIjoiUHJpc21hdGljIiwiaXNCZXN0Ijp0cnVlfQ.vZVPo0uF4OBlZWKTuXipCDS4tsfq74aQTs3wRROqM_M"}' \
    --customer $(prism customers:list \
                    --columns=id \
                    --filter 'name=^Our First Customer$' \
                    --no-header)

customers:credentials:delete

Delete a Customer Credential

prism customers:credentials:delete <credential> [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
credential		ID of the credential to delete	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

customers:credentials:list

List Credentials for a Customer

prism customers:credentials:list [--print-requests] [--quiet] --customer <string> [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--customer	-c	ID of a customer	true
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

customers:credentials:update

Update a Customer-specific Credential for use by Instance Actions

prism customers:credentials:update <credential> [--print-requests] [--quiet] --label <string> --fields <string>

Flag	Shorthand	Description	Required
credential		ID of a credential	true
--fields	-f	username, password, etc., in JSON format	true
--label	-l	new name to give the credential	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

customers:delete

Delete a Customer

prism customers:delete <customer> [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
customer		ID of the customer to delete	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

customers:list

List your Customers

prism customers:list [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

customers:update

Update a Customer

prism customers:update <customer> [--print-requests] [--quiet] [--name <string>] [--description <string>] [--externalId <string>] [--label <string>]

Flag	Shorthand	Description	Required
customer		ID of a customer	true
--description	-d	description of the customer	false
--externalId	-e	external ID of the customer from your system	false
--label	-l	a label to apply to the customer	false
--name	-n	name of the customer	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

customers:update Examples

Apply multiple labels to a customer (note: previously set labels will be overwritten)

prism customers:update Q3VzdG9tZXI6MmUzZDllOTUtMWIyMy00N2FjLTk3MjUtMzU1OTA2YzgyZWZj --label "Prod Customers" --label "Beta Testers"

customers:users:create

Create a User for the specified Customer

prism customers:users:create [--print-requests] [--quiet] --email <string> --role <string> --customer <string> [--name <string>]

Flag	Shorthand	Description	Required
--customer	-c	ID of the customer this user is associated with	true
--email	-e	email address	true
--name	-n	name of the new user	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--role	-r	ID of the role to assign the user	true

# Add a new 'Member' user for customer 'My First Customer'
prism customers:users:create \
    --email 'bar@email.com' \
    --name 'Thomas Bar' \
    --customer $(prism customers:list \
                    --columns id \
                    --no-header \
                    --filter 'name=^My First Customer$') \
    --role $(prism customers:users:roles \
                --columns id \
                --no-header \
                --filter 'name=^Member$')

customers:users:delete

Delete a Customer User

prism customers:users:delete <user> [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
user		ID of the user to delete	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

customers:users:list

List Customer Users

prism customers:users:list <customer> [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
customer		ID of the customer	true
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

customers:users:roles

List Roles you can grant to Customer Users

prism customers:users:roles [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

Customer User Roles

Click here for descriptions of roles that can be assigned to customer users

customers:users:update

Update a User

prism customers:users:update <user> [--print-requests] [--quiet] [--name <string>] [--phone <string>] [--dark-mode <string>] [--dark-mode-os-sync <string>]

Flag	Shorthand	Description	Required
user		ID of a user	true
--dark-mode	-d	whether the user should have dark mode enabled	false
--dark-mode-os-sync	-o	whether dark mode should sync with OS settings	false
--name	-n	name of the user	false
--phone	-p	phone number of the user	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

---

Executions CLI Commands

executions:step-result:get

Gets the Result of a specified Step in an Instance Execution

prism executions:step-result:get [--print-requests] [--quiet] --executionId <string> --stepName <string> [--outputPath <string>]

Flag	Shorthand	Description	Required
--executionId	-e	ID of an Execution	true
--outputPath	-p	Output result to a file. Output will be printed to stdout if this is omitted	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--stepName	-s	Name of an Integration Step	true

This command can be used to pull down step results for both integration tests and instance executions. For example, you can run a test of a flow of an integration and then pull down specific step results like this:

$ prism integrations:flows:test ${FLOW_ID}
Execution ID: SW5zdGFuY2VFeGVjdXRpb25SZXN1bHQ6MWFkZTYwMGQtMjg2Ni00ZTljLWI2N2EtYmUxNzgwOWY4ODI4

$ prism executions:step-result:get \
    --executionId SW5zdGFuY2VFeGVjdXRpb25SZXN1bHQ6MWFkZTYwMGQtMjg2Ni00ZTljLWI2N2EtYmUxNzgwOWY4ODI4 \
    --stepName "Fetch Invoice Info"

{"invoiceId":"3EB14053-D836-4BDC-8C8F-5E52A2F01C29","customerId":"E2B76A06-5FB6-4CF8-B296-B4000485471E","total":124.61}

---

Instances CLI Commands

instances:config-vars:list

List Config Variables used on an Instance

prism instances:config-vars:list <instance> [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
instance		ID of an instance	true
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

instances:create

Create an Instance

prism instances:create [--print-requests] [--quiet] --name <string> --integration <string> --customer <string> [--description <string>] [--config-vars <string>] [--label <string>]

Flag	Shorthand	Description	Required
--config-vars	-v	config variables to bind to steps of your instance	false
--customer	-c	ID of customer to deploy to	true
--description	-d	longer description of the instance	false
--integration	-i	ID of the integration or a specific integration version ID this is an instance of	true
--label	-l	a label or set of labels to apply to the instance	false
--name	-n	name of your new instance.	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

# Find the ID of the integration you want to deploy
INTEGRATION_ID=$(prism integrations:list --columns id --no-header --filter 'name=Acme Inc')

# Find the version ID of the latest available published version
VERSION_ID=$(prism integrations:versions ${INTEGRATION_ID} --latest-available --columns id --no-header)

# Connection config variables must be escaped
CREDENTIALS='[{\"name\":\"username\",\"type\":\"value\",\"value\":\"my.username\"},{\"name\":\"password\",\"type\":\"value\",\"value\":\"Pa$$W0Rd\"}]'

# Create an instance given a specific $VERSION_ID,
# a customer $CUSTOMER_ID and required config variables
# ("My Endpoint", "Do Thing?" and "Acme Basic Auth"):
prism instances:create \
    --name 'Acme Inc' \
    --description 'Acme Inc instance for Smith Rocket Co' \
    --integration ${VERSION_ID} \
    --customer ${CUSTOMER_ID} \
    --config-vars "[
        {
            \"key\": \"My Endpoint\",
            \"value\": \"https://example.com/api\"
        },
        {
            \"key\": \"Do Thing?\",
            \"value\": \"true\"
        },
        {
            \"key\": \"Acme Basic Auth\",
            \"values\": \"${CREDENTIALS}\"
        }
    ]" \
    --label 'Production' \
    --label 'Paid'

instances:delete

Delete an Instance

prism instances:delete <instance> [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
instance		ID of the instance to delete	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

instances:deploy

Deploy an Instance

prism instances:deploy <instance> [--print-requests] [--quiet] [--force]

Flag	Shorthand	Description	Required
instance		ID of an instance	true
--force	-f	Force deployment even when there are certain conditions that would normally prevent it	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

instances:disable

Disable an Instance

prism instances:disable <instance> [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
instance		ID of an instance	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

instances:enable

Enable an Instance

prism instances:enable <instance> [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
instance		ID of an instance	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

instances:flow-configs:list

List Instance Flow Configs

prism instances:flow-configs:list <instance> [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
instance		ID of an Instance	true
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

instances:flow-configs:test

Test a Flow Config of an Instance

prism instances:flow-configs:test <flowConfig> [--print-requests] [--quiet] [--extended] [--columns <string>] [--tail] [--payload <string>] [--contentType <string>]

Flag	Shorthand	Description	Required
flowConfig		ID of a Flow Config to test	true
--columns		only show provided columns (comma-separated)	false
--contentType	-c	Optional content-type for the test payload	false
--extended	-x	show extra columns	false
--payload	-p	Optional JSON-formatted data payload to submit with the test	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--tail	-t	Tail logs of the flow config test run	false

instances:list

List Instances

prism instances:list [--print-requests] [--quiet] [--customer <string>] [--integration <string>] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--customer	-c	ID of a customer	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--integration	-i	ID of an integration	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

instances:update

Update an Instance

prism instances:update <instance> [--print-requests] [--quiet] [--name <string>] [--description <string>] [--version <string>] [--deploy] [--label <string>]

Flag	Shorthand	Description	Required
instance		ID of an instance	true
--deploy		Deploy the instance after updating	false
--description	-d	Description for the instance	false
--label	-l	a label or set of labels to apply to the instance	false
--name	-n	Name of the instance	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--version	-v	ID of integration version	false

---

Integrations CLI Commands

integrations:available

Mark an Integration version as available or unavailable

prism integrations:available <integration> [--print-requests] [--quiet] --[no-]available

Flag	Shorthand	Description	Required
integration		ID of an integration version	true
--[no-]available	-a	Version is available or unavailable	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

integrations:convert

Convert a Low-Code Integration's YAML file into a Code Native Integration

prism integrations:convert --yamlFile <string> [--folder <string>] [--registryPrefix <string>]

Flag	Shorthand	Description	Required
--folder	-f	Optional: Folder name to install the integration into (kebab-cased integration name by default)	false
--registryPrefix	-r	Optional: Your custom NPM registry prefix	false
--yamlFile	-y	Filepath to a Low-Code Integration's YAML	true

integrations:create

Create an Integration

prism integrations:create [--print-requests] [--quiet] --name <string> --description <string> [--customer <string>]

Flag	Shorthand	Description	Required
--customer	-c	ID of customer with which to associate the integration	false
--description	-d	longer description of the integration	true
--name	-n	name of the integration to create	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

integrations:delete

Delete an Integration

prism integrations:delete <integration> [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
integration		ID of the integration to delete	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

integrations:export

Export an integration to YAML definition

prism integrations:export <integration> [--print-requests] [--quiet] [--latest-components] [--version <string>]

Flag	Shorthand	Description	Required
integration		ID of an integration to export	true
--latest-components	-l	Use the latest available version of each Component upon import	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--version	-v	Define the definition version to export.	false

integrations:flows:list

List Integration Flows

prism integrations:flows:list <integration> [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
integration		ID of an Integration	true
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

integrations:flows:test

Run a test execution of a flow

prism integrations:flows:test [--print-requests] [--quiet] [--flow-url <string>] [--integration-id <string>] [--payload <string>] [--payload-content-type <string>] [--sync] [--tail-results] [--tail-logs] [--cni-auto-end] [--timeout <string>] [--result-file <string>] [--debug]

Flag	Shorthand	Description	Required
--cni-auto-end		Automatically stop polling activity once an CNI flow execution completes. Some logs & results may not be returned this way. DOES NOT WORK FOR LOW-CODE FLOWS.	false
--debug		Enables debug mode on the test execution.	false
--flow-url	-u	Invocation URL of the flow to run.	false
--integration-id	-i	ID of the integration containing the flow to test.	false
--payload	-p	Optional file containing a payload to run the flow with.	false
--payload-content-type		Optional content-type for the test payload.	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--result-file	-r	Optional file to append tailed execution result data to. Results are saved as comma-separated values.	false
--sync		Forces the flow to run synchronously.	false
--tail-logs		Tail logs from the test execution until user interrupt or timeout.	false
--tail-results		Tail step results from the test execution until user interrupt or timeout.	false
--timeout		Optionally set a timeout (in seconds) to stop tail activity. Compatible with both low-code and CNI flows.	false

# Test an integration flow named 'My Integration Flow' and tail log output
prism integrations:flows:test \
    --tail \
    $(prism integrations:flows:list \
        --columns id \
        --no-header \
        --filter 'name=^My Integration Flow$')

integrations:fork

Fork an Integration

prism integrations:fork <parent> [--print-requests] [--quiet] --name <string> --description <string>

Flag	Shorthand	Description	Required
parent		ID of the Integration to fork	true
--description	-d	longer description of the forked integration	true
--name	-n	name of the forked integration	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

integrations:import

Import an Integration using a YAML definition file or a Code Native Integration

prism integrations:import [--print-requests] [--quiet] [--path <string>] [--integrationId <string>] [--icon-path <string>] [--open]

Flag	Shorthand	Description	Required
--icon-path		If supplied, the path to the PNG icon for the integration. Not applicable for Code Native Integrations.	false
--integrationId	-i	The ID of the integration being imported	false
--open	-o	If supplied, open the Designer for the imported integration	false
--path	-p	If supplied, the path to the YAML definition of the integration to import. Not applicable for Code Native Integrations.	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

integrations:init

Initialize a new Code Native Integration

prism integrations:init <name>

Flag	Shorthand	Description	Required
name		Name of the new integration to create (alphanumeric characters, hyphens, and underscores)	true

# Initialize a new directory for a Code Native Integration named "acme-integration"
prism integrations:init acme-integration
# Next navigate into the created directory and install/build the Integration with NPM or Yarn
yarn install && yarn build
# Finally import your Code Native Integration
prism integrations:import

integrations:list

List Integrations

prism integrations:list [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>] [--showAllVersions] [--customer <string>] [--org-only]

Flag	Shorthand	Description	Required
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--customer	-c	If specified this command returns only integrations that are available to the specified customer ID	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--org-only	-o	If specified this command returns only org integrations	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--showAllVersions	-a	If specified this command returns all versions of all integrations rather than only the latest version	false
--sort		property to sort by (prepend '-' for descending)	false

integrations:marketplace

Make a version of an Integration available in the Marketplace

prism integrations:marketplace <integration> [--print-requests] [--quiet] --[no-]available [--[no-]deployable] [--[no-]allow-multiple-instances] --overview <string>

Flag	Shorthand	Description	Required
integration		ID of an integration version to make marketplace available	true
--[no-]allow-multiple-instances	-m	Allow a customer to deploy multiple instances of this integration	false
--[no-]available	-a	Mark this Integration version available in the marketplace	true
--[no-]deployable	-d	Mark this Integration version as deployable in the marketplace; does not apply if not also marked available	false
--overview	-o	Overview to describe the purpose of the integration	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

integrations:open

Open the Designer for the specified Integration

prism integrations:open <integrationId>

Flag	Shorthand	Description	Required
integrationId		ID of the integration to open	true

integrations:publish

Publish a version of an Integration for use in Instances

prism integrations:publish <integration> [--print-requests] [--quiet] [--comment <string>] [--commitHash <string>] [--commitUrl <string>] [--repoUrl <string>] [--pullRequestUrl <string>]

Flag	Shorthand	Description	Required
integration		ID of an integration to publish	true
--comment	-c	comment about changes in this publication	false
--commitHash		Commit hash corresponding to the integration version being published	false
--commitUrl		URL to the commit details corresponding to this integration version	false
--print-requests		Print all GraphQL requests that are issued	false
--pullRequestUrl		URL to the pull request that modified this integration version	false
--quiet		Reduce helpful notes and text	false
--repoUrl		URL to the repository containing the definition for this integration	false

integrations:set-debug

Set debug mode on or off for an integration's test instance.

prism integrations:set-debug <debug> [--print-requests] [--quiet] [--integration-id <string>]

Flag	Shorthand	Description	Required
debug		Boolean value to set whether globalDebug should be enabled for the given integration	true
--integration-id	-i	ID of the integration containing the flow to test.	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

integrations:update

Update an Integration's name or description

prism integrations:update <integration> [--print-requests] [--quiet] [--name <string>] [--description <string>] [--customer <string>] [--test-config-vars <string>]

Flag	Shorthand	Description	Required
integration		ID of an integration	true
--customer	-c	ID of customer with which to associate the integration	false
--description	-d	new description to give the integration	false
--name	-n	new name to give the integration	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--test-config-vars		JSON-formatted config variables to be used for testing	false

integrations:versions

List Integration versions

prism integrations:versions <integration> [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>] [--latest-available]

Flag	Shorthand	Description	Required
integration		ID of an integration	true
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--latest-available	-l	Show only the latest available version	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

---

Login CLI Commands

login

Log in to your Prismatic account

prism login [--force] [--url]

Flag	Shorthand	Description	Required
--force	-f	re-authenticate, even if you are already logged in	false
--url	-u	returns a challenge url without automatically opening a browser	false

---

Logout CLI Commands

logout

Log out of your Prismatic account

prism logout [--browser]

Flag	Shorthand	Description	Required
--browser	-b	additionally log out of your default browser's session	false

---

Logs CLI Commands

logs:severities:list

List Log Severities for use by Alert Triggers

prism logs:severities:list [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

---

Me CLI Commands

me

Print your user profile information

prism me

me:token

Print your authorization tokens

prism me:token [--type {access,refresh}]

Flag	Shorthand	Description	Required
--type access,refresh	-t	Which token type to print	false

me:token:revoke

Revoke all refresh tokens for your user

prism me:token:revoke

---

On-prem-resources CLI Commands

on-prem-resources:delete

Delete an On-Premise Resource

prism on-prem-resources:delete <resource> [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
resource		ID of the On-Premise Resource to delete	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

on-prem-resources:list

List On-Premise Resources

prism on-prem-resources:list [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>] [--customer <string>]

Flag	Shorthand	Description	Required
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--customer	-c	If specified this command returns only On-Premise Resources that are available to the specified customer ID	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

on-prem-resources:registration-jwt

Create a JWT that may be used to register an On-Premise Resource.

prism on-prem-resources:registration-jwt [--print-requests] [--quiet] [--customerId <string>] [--orgOnly] [--resourceId <string>] [--rotate]

Flag	Shorthand	Description	Required
--customerId	-c	The ID of the customer for which to create the JWT. Only valid for Organization users.	false
--orgOnly		Register a Resource available to Organization users only. Only valid for Organization users.	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--resourceId	-r	An optional ID of an existing On-Premise Resource for which to generate a new JWT.	false
--rotate		Invalidate all JWTs for the On-Premise Resource and get a new JWT.	false

---

Organization CLI Commands

organization:credentials:create

Create a set of Organization-level Credentials for use by Instance Actions

prism organization:credentials:create [--print-requests] [--quiet] --label <string> --authorization-method <string> [--fields <string>]

Flag	Shorthand	Description	Required
--authorization-method	-a	ID of the authorization method	true
--fields	-f	username, password, etc., in JSON format	false
--label	-l	name to give the new credentials	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

# Create basic auth for REST resource at website.com/resource
prism organization:credentials:create \
    --label 'User/pass for website.com/resource' \
    --authorization-method $(prism authorization-methods:list --output json --extended | jq -r '.[] | select(.key == "basic").id') \
    --fields '{"username": "myuser", "password": "MyP@$sW0Rd!"}'

organization:credentials:delete

Delete an Organization Credential

prism organization:credentials:delete <credential> [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
credential		ID of the credential to delete	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

organization:credentials:list

List Credentials available to the entire Organization

prism organization:credentials:list [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

organization:credentials:update

Update a Customer-specific Credential for use by Instance Actions

prism organization:credentials:update <credential> [--print-requests] [--quiet] --label <string> --fields <string>

Flag	Shorthand	Description	Required
credential		ID of a credential	true
--fields	-f	username, password, etc., in JSON format	true
--label	-l	new name to give the credential	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

organization:signing-keys:delete

Delete an embedded marketplace signing key

prism organization:signing-keys:delete <signingKeyId> [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
signingKeyId		ID of the signing key to delete	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

organization:signing-keys:generate

Generate an embedded marketplace signing key

prism organization:signing-keys:generate [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

organization:signingkeys:generate will generate a new embedded marketplace signing key. The RSA public key is saved in Prismatic, and the private key is returned and immediately removed from Prismatic. Once the private key is returned, it cannot be retrieved again.

organization:signing-keys:import

Import a RSA public key for use with embedded marketplace

prism organization:signing-keys:import [--print-requests] [--quiet] --public-key-file <string>

Flag	Shorthand	Description	Required
--print-requests		Print all GraphQL requests that are issued	false
--public-key-file	-p	public key file	true
--quiet		Reduce helpful notes and text	false

organization:signingkeys:import allows you import your own RSA public key. You can use openssl to generate a new RSA key pair:

First, run openssl genrsa -out my-private-key.pem 4096 to generate an RSA private key.

Next, run openssl rsa -in my-private-key.pem -pubout > my-public-key.pub to generate the associated RSA public key. It should look something like this:

-----BEGIN PUBLIC KEY-----
EXAMPLE
-----END PUBLIC KEY-----

Finally, import the public key:

prism organization:signingkeys:import -p my-public-key.pub

organization:signing-keys:list

List embedded signing keys for embedded marketplace

prism organization:signing-keys:list [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

organization:update

Update your Organization

prism organization:update [--print-requests] [--quiet] [--name <string>]

Flag	Shorthand	Description	Required
--name	-n	name of the organization	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

organization:updateAvatarUrl

Update your Organization Avatar URL

prism organization:updateAvatarUrl [--print-requests] [--quiet] --organizationId <string> [--avatarUrl <string>]

Flag	Shorthand	Description	Required
--avatarUrl	-n	Url of the organization avatar	false
--organizationId		ID of an organization	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

organization:users:create

Create a User for your Organization

prism organization:users:create [--print-requests] [--quiet] [--name <string>] --email <string> --role <string>

Flag	Shorthand	Description	Required
--email	-e	email address of the user	true
--name	-n	name of the user	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--role	-r	role the user should assume	true

Organization Roles

See the users page for information on roles that users can assume

# Create an organization user for Susan and grant her the 'Integrator' role
prism organization:users:create \
    --email 'foo@email.com' \
    --name 'Susan Foo' \
    --role $(prism organization:users:roles \
                --columns id \
                --no-header \
                --filter 'name=^Integrator$')

organization:users:delete

Delete an Organization User

prism organization:users:delete <user> [--print-requests] [--quiet]

Flag	Shorthand	Description	Required
user		ID of the user to delete	true
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

organization:users:list

List Users of your Organization

prism organization:users:list [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

organization:users:roles

List Roles you can grant to other users in your Organization

prism organization:users:roles [--print-requests] [--quiet] [--columns <string>] [--csv] [--extended] [--filter <string>] [--no-header] [--no-truncate] [--output {csv,json,yaml}] [--sort <string>]

Flag	Shorthand	Description	Required
--columns		only show provided columns (comma-separated)	false
--csv		output is csv format [alias: --output=csv]	false
--extended	-x	show extra columns	false
--filter		filter property by partial string matching, ex: name=foo	false
--no-header		hide table header from output	false
--no-truncate		do not truncate output to fit screen	false
--output csv,json,yaml		output in a more machine friendly format	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false
--sort		property to sort by (prepend '-' for descending)	false

organization:users:update

Update a User

prism organization:users:update <user> [--print-requests] [--quiet] [--name <string>] [--phone <string>] [--dark-mode <string>] [--dark-mode-os-sync <string>]

Flag	Shorthand	Description	Required
user		ID of a user	true
--dark-mode	-d	whether the user should have dark mode enabled	false
--dark-mode-os-sync	-o	whether dark mode should sync with OS settings	false
--name	-n	name of the user	false
--phone	-p	phone number of the user	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false

---

Translations CLI Commands

translations:list

Generate Dynamic Phrases for Embedded Marketplace

prism translations:list [--print-requests] [--quiet] [--output-file <string>]

Flag	Shorthand	Description	Required
--output-file	-o	Output the results of the action to a specified file	false
--print-requests		Print all GraphQL requests that are issued	false
--quiet		Reduce helpful notes and text	false