Manage Services

Overview

Services are Sym's representation of external systems, both for control (e.g. Slack) and for execution (e.g. AWS SSO). Each Service is represented as:

  • Service Type: the Sym-defined service_type, e.g. slack
  • External ID: the external ID of the specific Service, e.g. Slack Workspace ID
  • Label: a User-supplied string for each external Service, e.g. slack-test

While Services do not need to be configured in order to add Users, they do need to be configured for Users to do anything meaningful.

📘

Don't forget the help command!

When in doubt, -h or --help will tell you everything you need to know.

Commands

CommandWhat it doesExample
listLists currently installed Services.symflow services list
deleteDeletes a single Service configuration.symflow services delete slack

Usage details

list

$ symflow services list
Service Type   External ID                        Label
-------------  ---------------------------------  -------------------
sym            cloud                              Sym
aws_sso        arn:aws:sso:::instance/1234567890  AWS SSO:Sym test
slack          T234567890                         Slack: Healthy-Health

delete

Use this command to delete a Service. Note that if a Service has User identities associated with it, you will not be able to delete it directly, and will receive a warning. In that case, run symflow users update, delete all IDs associated with the Service you're trying to delete, and try again.

If you don't provide the --force boolean flag, you will be prompted to re-confirm as this is a destructive action.

OptionWhat it doesExample value(s)
--forceBypasses the confirmation prompt and force deletes the service.

What’s Next