Refreshes locally configured providers from the Nango catalog.

Usage

mix tango.providers.sync [options]

Options

--only PROVIDERS      Sync only specified providers (comma-separated slugs)
--dry-run, -n         Preview changes without applying them
--force, -f           Merge catalog endpoints (auth_url, token_url, auth_mode)
                      into existing provider configs
--update-metadata     Update display names and catalog metadata

Examples

mix tango.providers.sync
mix tango.providers.sync --only github,slack
mix tango.providers.sync --dry-run --force
mix tango.providers.sync --force --update-metadata

Behaviour

Local providers are matched to catalog entries by slug (the catalog key), including inactive providers. Sync never creates providers: a provider is only usable with OAuth credentials, so catalog entries that are not yet configured are listed with a hint to run mix tango.providers.create.

Without --force or --update-metadata nothing is written. --force merges the catalog's endpoint fields into the existing config, keeping client_id, any custom keys, and client_secret untouched; catalog values that are missing or templated (${...} placeholders, including a || b fallbacks) are skipped so resolved or overridden local URLs are not replaced. alias: entries are resolved through their parent first. --update-metadata sets name from the catalog display name and merges catalog metadata into metadata. Neither option changes active, default_scopes, or credentials.