Change a Git connection; a new token is checked first.

PATCH

/api/v1/git/connections/{connection}

curl --request PATCH \
  --url https://example.com/api/v1/git/connections/example \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "baseUrl": "example", "token": "example", "defaultBranch": "example" }'

Parameters

Path Parameters

connection

required

string

Connection id

Request Body^required

Media typeapplication/json

Only the members given change.

object

name

string

baseUrl

string

token

A new token; write-only. The connection is checked again.

string

defaultBranch

Null clears it.

string | null

Example^generated

{
  "name": "example",
  "baseUrl": "example",
  "token": "example",
  "defaultBranch": "example"
}

Responses

200

Media typeapplication/json

An organization’s token connection to a Git provider. The token is never returned.

object

id

required

string

name

required

string

provider

required

github (a personal or fine-grained token; the GitHub App has its installations), gitlab, or gitea (Gitea and Forgejo).

string

Allowed values: github gitlab gitea

baseUrl

required

The provider’s API root: https://api.github.com, https://gitlab.com, a self-hosted URL.

string

authKind

required

token.

string

username

The account the token belongs to, as the provider named it at the last check.

string | null

defaultBranch

The branch new sources suggest when the repository names none.

string | null

hasToken

required

boolean

tokenHint

required

The last four characters of the token.

string

webhookUrl

Where the provider sends push events for this connection (/api/v1/webhooks/github/{id}, /api/v1/webhooks/gitlab/{id} or /api/v1/webhooks/gitea/{id}); absolute when server.public_url is set.

string | null

webhookSecret

The secret the provider’s push webhooks carry (GitHub: the webhook’s Secret, which signs the body with X-Hub-Signature-256; GitLab: the webhook’s Secret token; Gitea/Forgejo: its Secret, which signs the body). Present only in the answer of createGitConnection, never again: rotate it with POST /api/v1/git/connections/{connection}/webhook-secret.

string

createdAt

required

integer format: int64

updatedAt

required

integer format: int64

lastCheckedAt

integer | null format: int64

lastError

Why the last check failed.

string | null

Example

{
  "name": "gitlab-acme",
  "provider": "github",
  "baseUrl": "https://gitlab.com"
}

403

Media typeapplication/json

Problem Details body.

object

code

required

Stable machine-readable code, e.g. forbidden.

string

title

required

Short human readable title.

string

status

required

HTTP status.

integer format: int32

detail

Details, if safe to expose.

string | null

Example

{
  "code": "forbidden"
}

404

Media typeapplication/json

Problem Details body.

object

code

required

Stable machine-readable code, e.g. forbidden.

string

title

required

Short human readable title.

string

status

required

HTTP status.

integer format: int32

detail

Details, if safe to expose.

string | null

Example

{
  "code": "forbidden"
}

409

The name is taken

Media typeapplication/json

Problem Details body.

object

code

required

Stable machine-readable code, e.g. forbidden.

string

title

required

Short human readable title.

string

status

required

HTTP status.

integer format: int32

detail

Details, if safe to expose.

string | null

Example

{
  "code": "forbidden"
}

422

Media typeapplication/json

Problem Details body.

object

code

required

Stable machine-readable code, e.g. forbidden.

string

title

required

Short human readable title.

string

status

required

HTTP status.

integer format: int32

detail

Details, if safe to expose.

string | null

Example

{
  "code": "forbidden"
}

503

Media typeapplication/json

Problem Details body.

object

code

required

Stable machine-readable code, e.g. forbidden.

string

title

required

Short human readable title.

string

status

required

HTTP status.

integer format: int32

detail

Details, if safe to expose.

string | null

Example

{
  "code": "forbidden"
}