Sazabi
CLI

sazabi integrations

Command reference for sazabi integrations.

sazabi integrations — Connect and inspect integrations. Subcommands: providers, connect, disconnect, update-credentials, list, get, setup-instructions, details.

sazabi integrations

Connect and inspect integrations

sazabi integrations <subcommand>
sazabi integrations providers  # List providers
sazabi integrations list  # List connections
sazabi integrations connect <slug>  # Connect in the browser (OAuth or app install)
sazabi integrations connect <slug> --credentials '{...}'  # Connect with API-key credentials
sazabi integrations setup-instructions <slug>  # Setup instructions before anything exists
sazabi integrations setup-instructions <connection-id>  # Setup instructions with this connection's state
sazabi integrations get <connection-id>  # Inspect one connection
sazabi integrations update-credentials <connection-id> --credentials '{...}'  # Replace stored credentials
sazabi integrations disconnect <connection-id>  # Disconnect a connection

sazabi integrations providers

List supported integration providers

sazabi integrations providers [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi integrations providers  # List providers and connection counts
sazabi integrations providers --json  # Output as JSON

sazabi integrations connect

Connect an integration

An api_key provider takes its credentials with --credentials; a browser-flow provider opens the browser to connect.

sazabi integrations connect <slug> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--credentialsstringNoVendor credentials as JSON for api_key providers, e.g. '{"apiToken":"..."}' (see credentialFields in integrations providers --json)
--display-namestringNoOptional display name for the connection
--project-idstringNoProject the completed connection defaults its routing to (browser flows)
--no-waitbooleanNoPrint the browser link and exit without waiting
sazabi integrations connect <slug>  # Connect in the browser (OAuth or app install)
sazabi integrations connect <slug> --no-wait  # Print the browser link and exit
sazabi integrations connect <slug> --credentials '{...}'  # Connect with API-key credentials

sazabi integrations disconnect

Disconnect an integration connection

sazabi integrations disconnect <connection-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi integrations disconnect <connection-id>  # Disconnect a connection

sazabi integrations update-credentials

Replace an api_key connection's credentials

The reconnect path for an api_key connection whose stored credentials stopped working.

sazabi integrations update-credentials <connection-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--credentialsstringNoReplacement vendor credentials as JSON
sazabi integrations update-credentials <connection-id> --credentials '{...}'  # Replace stored credentials

sazabi integrations list

List integration connections for the organization

sazabi integrations list [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--providerstringNoFilter by provider (e.g. slack, github, pagerduty)
sazabi integrations list  # List connections
sazabi integrations list --provider <slug>  # Filter by provider

sazabi integrations get

Get one integration connection by ID

sazabi integrations get <connection-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi integrations get <connection-id>  # Inspect one connection

sazabi integrations setup-instructions

Print the setup instructions for a provider or a connection

A provider slug prints how to connect it: the credential fields an API-key provider takes and the connect command carrying them, or the browser flow. A connection ID prints the same instructions under that connection's own details.

sazabi integrations setup-instructions <slug | connection-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi integrations setup-instructions <slug>  # Setup instructions before anything exists
sazabi integrations setup-instructions <connection-id>  # Setup instructions with this connection's state

sazabi integrations details

Show details for one integration connection

sazabi integrations details <connection-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi integrations details <connection-id>  # Inspect one connection