Use the orchestrate tools import command with the --app-id argument to associate your connection with a tool.

Associating a Connection to an OpenAPI Tool

You can add a connection to an OpenAPI tool using the following. Note that only one connection can be associated and key_value connections are not supported by OpenAPI tools.

[BASH]
orchestrate tools import -k openapi -f <path to openapi spec> --app-id <my_app_id>

Associating a Connection to a Python Tool

You can add a connection to a Python tool using the following. Unlike OpenAPI tools, Python tools can support multiple connections.

[BASH]
orchestrate tools import -k python -f <path to file> --app-id my_app_id1 --app-id my_python_app_id=my_app_id2

In the above example we see a Python tool being imported with 2 app ids. The first is a simple app-id my_app_id1, importing this way means that your connection is named my_app_id1 and that your Python tool is looking for my_app_id1. In cases where you need the connection to have a different app id than what the Python tools uses you can use the second style of app id. In the above example, we can see my_python_app_id=my_app_id2 this will be accessible in the Python tool as my_python_app_id:

[Python]
conn = connections.basic_auth("my_python_app_id")

It exposes the content of the connection my_app_id2:

[BASH]
orchestrate connections add -a my_app_id2
orchestrate connections configure -a my_app_id2 --env draft --kind basic --type team
orchestrate connections configure -a my_app_id2 --env draft -u my_username -p my_password