User Plugins

User-facing plugin management, OAuth, and configuration

📄️ List user's plugins (enabled and available)

Returns both plugins the user has enabled and plugins available for them to enable.

📄️ Handle OAuth callback from external provider

This endpoint receives the callback after the user authenticates with the

📄️ Get a single user plugin instance

Returns detailed status for a plugin the user has enabled.

📄️ Disconnect a plugin (remove data and credentials)

Disconnect a plugin (remove data and credentials)

📄️ Update user plugin configuration

Allows the user to set per-user configuration overrides for their plugin instance.

📄️ Set user credentials (personal access token) for a plugin

Allows users to authenticate by pasting a personal access token

📄️ Disable a plugin for the current user

Disable a plugin for the current user

📄️ Enable a plugin for the current user

Enable a plugin for the current user

📄️ Set a connection's metadata-enrichment opt-ins (tags/genres/metadata/custom).

Writes the host-only `config._codex.send*` flags (the plugin never reads

📄️ Start OAuth flow for a user plugin

Generates an authorization URL and returns it to the client.

📄️ Trigger a sync operation for a user plugin

Enqueues a background sync task that will push/pull reading progress

📄️ Set a connection's automatic-sync preference (manual vs auto)

Writes the host-only `config._codex.autoSync` flag (the plugin never sees

📄️ Get sync status for a user plugin

Returns the current sync status including last sync time, health, and failure count.

📄️ Get the latest task for a user plugin

Returns the most recent background task for this user+plugin combination.