Verify git credentials
Validate a personal access token against the provider before creating a connection. Admin-only. Requires git integration to be enabled.
Verify git credentials › Request Body
vendorpatbase_urlVerify git credentials › Responses
Verification result (valid flag; login/message when applicable)
validloginAuthenticated account/login
messageBrowse accessible repositories
List repositories the token can access, for the connection setup picker. Admin-only. Requires git integration to be enabled.
query Parameters
vendorpatPersonal access token
base_urlAPI base URL for self-hosted GitLab/Gitea
pageBrowse accessible repositories › Responses
Repositories retrieved
ownernamefull_namedefault_branchprivateweb_urlList git connections
List all git connections (PATs masked). Admin-only.
List git connections › Responses
Connections retrieved
idvendorbase_urlrepo_ownerrepo_namepat_maskedMasked token, e.g. '••••abcd'
access_levelbranchdefault_branchinclude_globsexclude_globswiki_enabledcollection_idsync_interval_minuteslast_synced_shalast_synced_atnext_sync_duesync_statuscreated_atCreate git connection
Create a git connection. Verifies the PAT and resolves the default branch before persisting. Admin-only.
Create git connection › Request Body
vendorGit hosting provider
repo_ownerRepo owner / org / group (or GitLab namespace path)
repo_namepatPersonal access token used for clone + API
base_urlAPI base URL for self-hosted GitLab/Gitea (omit for github.com/gitlab.com)
access_levelbranchBranch to sync (defaults to repo default branch)
include_globsgitignore-style include patterns (empty = all files)
exclude_globsgitignore-style exclude patterns
wiki_enabledAlso ingest the repo wiki
collection_idTarget collection for ingested documents
sync_interval_minutesScheduled-sync interval in minutes (0 = manual only)
Create git connection › Responses
Connection created
idvendorbase_urlrepo_ownerrepo_namepat_maskedMasked token, e.g. '••••abcd'
access_levelbranchdefault_branchinclude_globsexclude_globswiki_enabledcollection_idsync_interval_minuteslast_synced_shalast_synced_atnext_sync_duesync_statuscreated_atGet git connection
Get a single git connection (PAT masked). Admin-only.
path Parameters
connection_idGet git connection › Responses
Connection retrieved
idvendorbase_urlrepo_ownerrepo_namepat_maskedMasked token, e.g. '••••abcd'
access_levelbranchdefault_branchinclude_globsexclude_globswiki_enabledcollection_idsync_interval_minuteslast_synced_shalast_synced_atnext_sync_duesync_statuscreated_atDelete git connection
Delete a git connection. With purge_documents=true, also removes all documents ingested from this connection. Admin-only.
path Parameters
connection_idquery Parameters
purge_documentsAlso delete all documents ingested from this connection
Delete git connection › Responses
Connection deleted
messageconnection_iddocuments_purgedUpdate git connection
Partially update a git connection. The PAT is rotated only when provided. Admin-only.
path Parameters
connection_idUpdate git connection › Request Body
patNew PAT (rotation); omit to keep existing
access_levelbranchinclude_globsexclude_globswiki_enabledcollection_idsync_interval_minutesUpdate git connection › Responses
Connection updated
idvendorbase_urlrepo_ownerrepo_namepat_maskedMasked token, e.g. '••••abcd'
access_levelbranchdefault_branchinclude_globsexclude_globswiki_enabledcollection_idsync_interval_minuteslast_synced_shalast_synced_atnext_sync_duesync_statuscreated_atTrigger a git sync
Trigger an incremental sync for a connection. Returns a task id to poll via GET /api/tasks/{task_id}. Admin-only. Returns 409 if a sync is already running for this connection.
path Parameters
connection_idTrigger a git sync › Responses
Sync started
task_idconnection_idmessage