Integrations /
Generate VCS token
Generate a token for a specific VCS link.
Required permission
Account > Git > Tokens > Read
Path parameters
customVCSId
string requiredID of the custom VCSvcsLinkId
string requiredID of the version control link
Query parameters
force_refresh
boolean
Response body
- {object}Response object.
data
{object} requiredResult data.vcsService
string requiredVCS provider the token belongs to.one ofbitbucket, gitlab, github, self-hosted, azureinstallationId
integerInstallation ID of the GitHub installation the token belongs to (GitHub only)installationToken
stringInstallation token (GitHub only).token
string requiredOAuth token.
API
CLI
JS Client
POST /v1/integrations/vcs/custom/{customVCSId}/token/{vcsLinkId}
Example response
200 OK
A version control access token for the provided link.
JSON
{
"data": {
"vcsService": "github",
"installationId": 1234567,
"installationToken": "ghs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"token": "ghu_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}