Inspect, Pause, or Delete an Integration Connection
Copy an integration connection slug, check its recent events, pause it, or delete it safely.
Use this guide to work with an existing integration connection:
- Inspecting a connection changes nothing.
- While a connection is paused, Shipfox drops its events. It doesn't replay them later.
- Deleting a connection can't be undone.
Before you begin
You need an existing integration connection and permission to manage workspace integrations. If you do not have a connection, connect one from the integrations catalog.
Copy the integration connection slug
Open Settings → Integrations. Open the integration connection's menu and select Use this integration.
Copy the slug from the trigger example. Use the full value as a trigger
source. The same value works as connection on a tool step or an agent
integration entry.
Inspect recent events
Open the same menu and select View recent events. Shipfox opens the event journal with that integration connection selected.
Send one safe test event from the provider. Open the new event. Check that:
- The source equals the copied integration connection slug.
- The event name matches the provider action.
- The payload shows the test item you sent.
- The result shows if a workflow matched.
Use Troubleshoot event routing when delivery succeeds but no run appears.
Pause and resume an integration connection
Pause a connection to stop its events for a short time. The integration connection stays in the workspace.
Check which runs you will miss
Search your workflow files for the integration connection slug. The pause affects each workflow you find:
- If the slug is a trigger
source, the workflow doesn't start. - If the slug is used for checkout or for a tool, that step fails.
Pause the connection only if none of these workflows handles urgent work.
Disable the integration connection
Open the integration connection's menu and select Disable integration. Send a safe test event. Check that it does not appear in Settings → Events and that no workflow run starts from it.
Enable and verify the integration connection
Open the menu again and select Enable integration. Send a new test event from the provider. Check that it appears in the event journal with a final routing result.
If the fresh event does not arrive, repeat the setup check on the provider's setup page in the integrations catalog.
Delete an integration connection
Delete a connection only when no project should use its external account or installation. Set up a replacement first if its events, checkout, or tools must continue.
Check every dependency
Search .shipfox/workflows/ in each project repository for the slug. Check
trigger source values, and tool step and agent connection values. Open
each project's settings and check whether this is its source integration
connection. Identify active runs whose listening jobs still expect events
from it.
Point workflow files and project settings to a replacement where needed, then wait for every changed workflow to sync successfully. Do not delete the connection while a project needs it for checkout or an active listener needs its events.
Delete the integration connection
Open the integration connection's menu, select Delete integration, and confirm the workspace and integration connection shown in the dialog.
The action cannot be undone. Shipfox stops receiving its new events. A workflow that still uses the slug may fail to sync or run.
Verify the removal
Confirm that the integration connection no longer appears in integration settings. If it was a custom webhook, confirm that every sender has retired its old ingest URL. Check the affected projects for sync errors. Start one workflow through the replacement and check that checkout, events, or tools still work.
Use Fix workflow sync for a definition that still references the deleted integration connection.