Once you've added a connector, you'll occasionally need to update it: you might want to rotate a key, fix a URL, change who can use it, or remove one you no longer need. This article covers editing a connector's settings, retesting the connection, managing access, and deleting a connector when you're done with it.
If you haven't created a connector yet, read our article on creating one here, then come back to manage it.
Open a connector to manage it
Every connector you've added lives in the Connectors section. From there you can open one in two ways:
Select the connector's row to open it directly.
Select the more menu on the row, then choose Edit.
Both open the connector in a panel with up to three tabs: Settings, Access, and Usage.
Edit a connector's settings
The Settings tab holds everything about how the connector works: its name, the URL pattern it applies to, the credential, the authentication method, and the optional test URL.
Editing here is immediate. As you change a field and move off it, the change saves on its own, so there's no separate save button for an existing connector. When you're finished, select Done to close the panel.
A few things worth knowing:
Credentials stay hidden. A saved secret, like an API key, shows as masked dots rather than its value. To replace it, type the new value over the field and it saves right away. This is how you rotate a key when it changes on the provider's side.
The URL pattern controls where the credential is sent. If a provider moves to a new host, update the pattern so requests to the new address are authenticated.
The guide toggle in the panel header shows inline setup instructions next to the fields, which is handy when you're reworking a connection.
A failed test usually points to an expired or revoked key, the wrong authentication method, or a URL that the credential's pattern doesn't cover. Fix the field, then test again.
Manage who can use it
The Access tab controls who can use and manage the connector. Add members, groups, or a whole space, and choose the role each one gets. The access map at the top of the tab shows how access reaches this connector, so you can see at a glance who it's shared with. Managing access needs sharing permission for the connector.
Read our article on giving access to a connector here.
See where it's used
The Usage tab shows where the connector is doing work, including the workflows and steps that reference it. Check this before you make a disruptive change, like deleting the connector or narrowing its URL pattern, so you know what depends on it.
Test the connection
Next to the status label is a refresh icon. Select it to send a test request and confirm the credential still works. The status updates to reflect the result:
Draft. Not yet configured enough to use.
Untested. Saved but not checked yet.
Active. The last test succeeded.
Error. The last test failed. Hover the status to see the error message.
Delete a connector
You can delete a connector two ways:
From the connectors list, open the row's more menu and choose Delete.
From the connector's Settings tab, scroll to the Delete connector section and select Delete connector.
Either way, a confirmation appears first. If the connector is in use, it lists how many workflows and branches reference it and warns that any steps using it will need a replacement.
Note: Deleting is permanent: it removes the connector and its stored configuration, including the credential. Steps that relied on it will fail until you point them at another connector, so it's worth checking the Usage tab first.
To confirm, select Delete connector. To back out, select Cancel.