v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-304917042.1 MB
integrations

Manually re-sync the tool list for this connection

Enqueue a tool-sync for an active connection.

Returns 202 + the current row; the frontend polls tools_status to see when the sync lands. Refusing non-active rows here keeps the Celery task's same precondition visible at the API surface so the client gets a clear 422 instead of a queued task that no-ops.

post/v1/integrations/connections/{connection_id}/refresh-tools

Path parameters

connection_idstring uuid required

Response

Successful Response

idstring uuid required
organization_idstring uuid required
integration_key'slack' | 'custom_mcp' | 'notion' | 'google_drive' | 'calcom' | 'twilio' | 'email' required

Stable identifier for each supported integration.

The string value must match the vendor's per-provider identifier (for Nango: provider_config_key). Persisted on integration_connections.integration_key and integration_connection_tools.integration_key.

Adding a new integration: append a member here, add an IntegrationSpec to INTEGRATIONS, register the provider in the vendor cloud via src/integrations/bootstrap.py (Step 3).

nickname_slugstring required
nicknamestring required
vendorstring required
vendor_connection_idstring nullable required
statusstring required
tools_statusstring required
tools_synced_atstring date-time nullable required
status_reasonstring nullable required
connected_atstring date-time nullable required
last_refreshed_atstring date-time nullable required
last_used_atstring date-time nullable required
metadataobject required
created_atstring date-time required
updated_atstring date-time required