Managing Integrations

Guide

Editing an Integration

1. On the Integrations page, locate the desired integration
2. Click the settings button (gear icon) on the card
3. The configuration dialog is displayed with all editable fields:
   • Name — the display name of this integration instance
   • Settings and Authentication — configuration and credential fields
   • Permissions — switch between Local (this workspace only) and Global (all workspaces)
4. Update the necessary fields
5. Click Update to save changes

Caution

For security, credentials are never pre-populated when editing an integration. You must re-enter authentication credentials whenever you edit.

---

Validating the Connection

To verify that an integration is working correctly:

• The system records the last validation date displayed on the integration card
• The integration status is automatically updated (Active, Connected, Failed, etc.)
• Check the status indicator on the card to identify issues

---

Removing an Integration

1. On the Integrations page, locate the desired integration
2. Click the delete button (trash icon) on the card
3. A confirmation dialog is displayed with the warning: “This action cannot be undone. All settings and credentials will be permanently lost.”
4. Click Confirm Remove

Dependency Check

Before allowing removal, the system checks if the integration is being used by:

• Organizations that depend on it
• Agents that use it to execute tasks
• Secrets that reference it

Caution

If dependencies exist, removal will be blocked. You must remove the dependencies (agents, workflows) before deleting the integration.

---

Blocked Integrations

Some integrations may be marked as blocked by the system administrator:

• They appear in the list but without edit or delete buttons
• They cannot be uninstalled by users
• They are managed exclusively by the administrator