Skip to main content
POST
Create GitLab integration

Authorizations

Authorization
string
header
required

API key or session token (Bearer)

Path Parameters

projectId
string
required

Body

application/json
baseUrl
string<uri>
required
projectPath
string
required
Minimum string length: 1
accessToken
string

Omit to keep the stored token only when the GitLab base URL is unchanged. A changed URL requires a new token.

tokenType
enum<string>

private sends the token in PRIVATE-TOKEN, which is what personal, project and group access tokens expect. bearer sends it in Authorization, for an OAuth2 token you already hold. Defaults to private.

Available options:
private,
bearer

Response

object | null

The stored integration

id
string
required
projectId
string
required
baseUrl
string
required

Root URL of the GitLab instance.

projectPath
string
required

Full path of the linked project, nested groups included.

tokenType
enum<string>
required
Available options:
private,
bearer
maskedAccessToken
string
required

First and last characters of the stored token, only returned to callers with workspace:manage_settings.

isActive
boolean | null
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
webhookUrl
string

Where GitLab should POST events for this project.

webhookSecret
string

Only returned to callers with workspace:manage_settings, so the value can be pasted into GitLab.

branchPattern
string

When on, Kaneo comments a link back to the task on each issue opened in GitLab. Issues Kaneo creates from tasks are not commented on.