List GitLab connectors

GET

/api/integrations/gitlab/connectors

curl --request GET \
  --url https://gateway.example.com/api/integrations/gitlab/connectors \
  --header 'Authorization: Bearer <token>'

• Your Gateway instance

Lists configured GitLab connectors. PATs are never returned; token metadata is masked as ****last4.

Authorizations

• bearerAuth

Parameters

Query Parameters

enabled

boolean | null

Responses

200

Successful response

Media typeapplication/json

object

data

required

Array<object>

object

id

required

string format: uuid

provider

required

string

Allowed values: gitlab

name

required

string

baseUrl

required

string

enabled

required

boolean

allowlistMode

required

string

Allowed values: selected all_visible

settings

required

object

autoSyncEnabled

required

boolean

autoSyncIntervalSeconds

required

number

cloneShallow

required

boolean

cloneDepth

required

number

cloneLfs

required

boolean

cloneSubmodules

required

boolean

cloneMaxSizeMb

required

number

cloneTimeoutSeconds

required

number

capabilities

required

object

key

additional properties

boolean

syncStatus

required

string

Allowed values: never idle running success error

syncLastError

string | null

syncFailureCount

required

number

syncStartedAt

string | null

syncFinishedAt

string | null

syncLastOverlapAt

string | null

syncNextRetryAt

string | null

testedAt

string | null

createdAt

required

string

updatedAt

required

string

hasToken

required

boolean

tokenMasked

required

string | null

Example

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Example resource",
      "createdAt": "2024-01-01T12:00:00.000Z",
      "updatedAt": "2024-01-01T12:30:00.000Z"
    }
  ]
}

400

Bad request

Media typeapplication/json

object

code

required

Error code

string

message

required

Human-readable error message

string

details

Additional error details

Example

{
  "code": "VALIDATION_ERROR",
  "message": "Request validation failed",
  "details": [
    {
      "path": [
        "name"
      ],
      "message": "Required"
    }
  ]
}

401

Authentication required

Media typeapplication/json

object

code

required

Error code

string

message

required

Human-readable error message

string

details

Additional error details

Example

{
  "code": "UNAUTHORIZED",
  "message": "Authentication required"
}

403

Forbidden

Media typeapplication/json

object

code

required

Error code

string

message

required

Human-readable error message

string

details

Additional error details

Example

{
  "code": "FORBIDDEN",
  "message": "Insufficient permissions"
}

404

Not found

Media typeapplication/json

object

code

required

Error code

string

message

required

Human-readable error message

string

details

Additional error details

Example

{
  "code": "NOT_FOUND",
  "message": "Resource not found"
}

409

Conflict

Media typeapplication/json

object

code

required

Error code

string

message

required

Human-readable error message

string

details

Additional error details

Example

{
  "code": "CONFLICT",
  "message": "Resource already exists"
}

422

Unprocessable entity

Media typeapplication/json

object

code

required

Error code

string

message

required

Human-readable error message

string

details

Additional error details

Example

{
  "code": "UNPROCESSABLE_ENTITY",
  "message": "Request could not be processed"
}

500

Internal server error

Media typeapplication/json

object

code

required

Error code

string

message

required

Human-readable error message

string

details

Additional error details

Example

{
  "code": "INTERNAL_ERROR",
  "message": "Internal server error"
}