Integrations - Providers - SCM
Source control provider connections (GitHub, GitLab, Bitbucket, Gitea).
ποΈ Check SCM Integration Validity
Returns, for every supported SCM provider (GitHub, GitLab, Bitbucket, Gitea, Forgejo, Azure DevOps, TFVC), whether the authenticated client has a complete integration configured, based on the required credential keys stored for each provider.
ποΈ Get SCM Repository Branches
Lists the branches of a repository for the given SCM provider and repository identifier, with offset/limit pagination and optional custom_domain for self-hosted instances. Returns 400 when the provider is not supported.
ποΈ Test SCM Connection
Tests connectivity to the given SCM provider using the credentials stored for the authenticated client, with optional custom_domain for self-hosted instances. Succeeds only when the stored credentials can authenticate against the provider.
ποΈ Revoke SCM Connection Tokens
Revokes at the provider the OAuth access and refresh tokens stored for the authenticated client, before the connection is removed. The tokens are read server-side and never returned. Answers 409 when no token is stored for the provider and 502 when the provider refuses the revocation.
ποΈ SCM OAuth Callback
Handles the OAuth authorization callback from an SCM provider, exchanging the authorization code (plus optional state and installation_id) to store the integration for the authenticated client. Returns 400 for unsupported providers or failed exchanges.
ποΈ Get GitHub Installation Id
Returns the GitHub App installation id stored for the authenticated client, cross-checked against the installations visible to the GitHub App. Also reports whether the stored record has drifted and needs reconciliation.
ποΈ Reconcile GitHub Installation Id
Reconciles the stored GitHub App installation record with the current installation reported by GitHub, updating the client's saved installation id and metadata when they have drifted. Requires the SCM integrations write scope.
ποΈ Save GitHub Installation Id
Saves the GitHub App installation id for the authenticated client and enriches the stored record with installation details (target, app, and account metadata) fetched from GitHub.
ποΈ Delete GitHub Installation Id
Uninstalls the GitHub App for the authenticated client by deleting the installation via the GitHub API. Returns 404 when no installation id is stored for the client.