Managing Source Connections

Viewing your connections

All active source connections appear in Settings → Sources. Each connection card displays:

• Source type — The platform (Google Drive, SharePoint, OneDrive, Dropbox, or GitHub)
• Status indicator — Green (healthy), yellow (warning), or red (disconnected)
• Last synced — Timestamp of the most recent completed sync
• Pages synced — Total number of pages imported from this source
• Folders/repos — A summary of what is selected for sync

Click any connection card to view detailed information including sync history, selected folders, and error logs.

Connection health statuses

Status	Meaning	Action needed
Healthy	Syncing on schedule with no errors	None
Syncing	A sync is currently in progress	None — wait for completion
Warning	Partial sync failures or approaching limits	Review the warning details
Disconnected	Authentication expired or was revoked	Reconnect the source
Error	Sync failed due to an unrecoverable issue	Check error details and troubleshoot

Checking sync status

To see detailed sync information for a connection:

1. Go to Settings → Sources.
2. Click the connection card.
3. The Sync History tab shows recent sync runs with timestamps, pages processed, and any errors.

Each sync entry shows:

• Number of pages added, updated, or removed
• Duration of the sync
• Any files that failed to process (with reasons)

Reconnecting after token expiry

OAuth tokens from third-party platforms expire periodically. When this happens, the connection status changes to Disconnected and syncing pauses.

To reconnect:

1. Go to Settings → Sources.
2. Find the connection with a Disconnected or Warning status.
3. Click Reconnect.
4. Complete the OAuth sign-in flow for the platform.
5. Syncing resumes automatically with your existing folder selections preserved.

You do not need to re-select folders or reconfigure the connection. All previous settings remain intact.

Editing a connection

To change which folders or repositories are synced:

1. Go to Settings → Sources and click the connection card.
2. Click Edit Folders (or Edit Repositories for GitHub).
3. Add or remove folders from the selection.
4. Click Save Changes.
5. A sync runs to import content from newly added folders and mark removed folders' content accordingly.

Disconnecting a source

To remove a source connection entirely:

1. Go to Settings → Sources and click the connection card.
2. Click Disconnect Source.
3. Confirm the disconnection in the dialog.

What happens to synced pages

When you disconnect a source:

• Pages previously imported from that source remain in your wiki as archived pages.
• Archived pages are no longer updated from the source.
• Archived pages remain searchable and accessible to your team.
• You can delete archived pages manually from Pages if you no longer need them.

Disconnecting does not automatically delete any content from your wiki. This prevents accidental data loss.

Revoking platform access

Disconnecting in Kowiki removes Kowiki's stored credentials. To fully revoke access:

• Google Drive — Visit Google Account → Security → Third-party apps
• Microsoft (SharePoint/OneDrive) — Visit Microsoft Account → App permissions
• Dropbox — Visit Dropbox Settings → Connected apps
• GitHub — Visit GitHub Settings → Applications → Installed GitHub Apps

Troubleshooting connection health

Connection cycles between Healthy and Warning

This often indicates intermittent permission issues with specific files. Check the sync history for files that repeatedly fail and verify your access to those files on the source platform.

Sync completes but page count seems low

• Verify you have selected the correct folders in the connection settings.
• Unsupported file types are skipped — only documents, PDFs, Markdown, and text files are imported.
• Check if files are restricted by platform-level permissions.

Multiple connections to the same platform

You can connect multiple accounts from the same platform (for example, a personal Google Drive and a work Google Drive). Each connection operates independently with its own authentication and folder selections.

For additional help, see Source Sync Issues.