Scm Integrations

CreateSCMIntegration

POST/gitpod.v1.RunnerConfigurationService/CreateSCMIntegration

DeleteSCMIntegration

POST/gitpod.v1.RunnerConfigurationService/DeleteSCMIntegration

ListSCMIntegrations

POST/gitpod.v1.RunnerConfigurationService/ListSCMIntegrations

GetSCMIntegration

POST/gitpod.v1.RunnerConfigurationService/GetSCMIntegration

UpdateSCMIntegration

POST/gitpod.v1.RunnerConfigurationService/UpdateSCMIntegration

ModelsExpand Collapse

ScmIntegration object { id, host, oauth, 4 more }

id: optional string

id is the unique identifier of the SCM integration

host: optional string

oauth: optional ScmIntegrationOAuthConfig { clientId, encryptedClientSecret, issuerUrl }

clientId: optional string

client_id is the OAuth app’s client ID in clear text.

encryptedClientSecret: optional string

encrypted_client_secret is the OAuth app’s secret encrypted with the runner’s public key.

formatbyte

issuerUrl: optional string

issuer_url is used to override the authentication provider URL, if it doesn’t match the SCM host.

+optional if not set, this account is owned by the installation.

pat: optional boolean

runnerId: optional string

scmId: optional string

scm_id references the scm_id in the runner’s configuration schema that this integration is for

virtualDirectory: optional string

virtual_directory is the virtual directory path for Azure DevOps Server (e.g., “/tfs”). This field is only used for Azure DevOps Server SCM integrations and should be empty for other SCM types. Azure DevOps Server APIs work without collection when PAT scope is ‘All accessible organizations’.

ScmIntegrationOAuthConfig object { clientId, encryptedClientSecret, issuerUrl }

clientId: optional string

client_id is the OAuth app’s client ID in clear text.

encryptedClientSecret: optional string

encrypted_client_secret is the OAuth app’s secret encrypted with the runner’s public key.

formatbyte

issuerUrl: optional string

issuer_url is used to override the authentication provider URL, if it doesn’t match the SCM host.

+optional if not set, this account is owned by the installation.

ScmIntegrationCreateResponse object { id }

id: optional string

id is a uniquely generated identifier for the SCM integration

formatuuid

ScmIntegrationDeleteResponse = unknown

ScmIntegrationRetrieveResponse object { integration }

integration: optional ScmIntegration { id, host, oauth, 4 more }

id: optional string

id is the unique identifier of the SCM integration

host: optional string

oauth: optional ScmIntegrationOAuthConfig { clientId, encryptedClientSecret, issuerUrl }

clientId: optional string

client_id is the OAuth app’s client ID in clear text.

encryptedClientSecret: optional string

encrypted_client_secret is the OAuth app’s secret encrypted with the runner’s public key.

formatbyte

issuerUrl: optional string

issuer_url is used to override the authentication provider URL, if it doesn’t match the SCM host.

+optional if not set, this account is owned by the installation.

pat: optional boolean

runnerId: optional string

scmId: optional string

scm_id references the scm_id in the runner’s configuration schema that this integration is for

virtualDirectory: optional string

ScmIntegrationUpdateResponse = unknown