Guide

GitLab Endpoint

Source

GitLab endpoints connect Gateway to GitLab projects, repositories, issues, merge requests, and CI/CD APIs.

Endpoint Kind

Use gitlab as the endpoint kind when creating this endpoint through the API or dashboard.

What Gateway Uses This Endpoint For

Allow approved tools and agents to inspect GitLab projects.
Centralize token storage and audit around GitLab API access.
Support GitLab.com and self-managed GitLab instances.
Build workflows that connect repository, issue, and pipeline data.

Basic Endpoint Shape

json

{
  "endpoint": "gitlab-prod",
  "kind": "gitlab",
  "config": {
    "read_conn": {
      "token": "secret",
      "base_url": "https://gitlab.com"
    }
  }
}

Create it with the endpoint API:

bash

curl -sS -X POST "$EDEN/endpoints" \
  -H "$AUTH_HEADER" \
  -H "Content-Type: application/json" \
  -d '{
  "endpoint": "gitlab-prod",
  "kind": "gitlab",
  "config": {
    "read_conn": {
      "token": "secret",
      "base_url": "https://gitlab.com"
    }
  }
}'

Configuration Fields

Field	Purpose
`token`	Personal access token or project/group token
`base_url`	Optional GitLab base URL for self-managed instances

Operating Notes

Use project or group access tokens when possible.
Separate read-only inspection endpoints from endpoints with merge or pipeline write access.
Document the namespace scope covered by each endpoint.