Skip to content

Git Repositories REST API

Published: 2026-08-28

Last Updated: 2026-08-28

List Git Repositories defined in MDCMS.

GET /git-repositories

JSON payloads

All MDCMS REST API response bodies use JSON.

Authorization

Header Type Required Description
Authorization string Yes Bearer token for the MDSEC user. See Authenticate requests to the MDCMS REST API server.

A missing or invalid token returns HTTP 401 Unauthorized.

Query parameters

Parameter Type Required Description
repoId string No Repository ID defined in MDCMS. Omit to return all repositories.
repoURL string No Substring to match against the repository URL. Any repository whose URL contains this value is returned. Matching is case-insensitive. Omit to return repositories regardless of URL.
gitType string No Git server type. Allowed values: azure, github, gitlab, bitbucket. bitbucket matches both Bitbucket Cloud and Bitbucket Data Center. Omit to return all types.

Example

Replace {endpoint} with the URL endpoint defined for the MDCMS HTTP server.

curl -H "Authorization: Bearer {token}" \
  "https://{endpoint}/git-repositories?gitType=github&repoURL=techcorp"

GET /git-repositories?gitType=github&repoURL=techcorp HTTP/1.1
Host: {endpoint}
Authorization: Bearer {token}

Response body

Schema

Property Type Description
repos array List of repository objects.

Repository object

Property Type Description
repoId string Repository ID.
repoURL string Repository URL.
description string Repository description.
gitType string Git server type. One of azure, github, gitlab, or bitbucket. Other Git types defined in MDCMS are returned as their stored code.

Example

{
  "repos": [
    {
      "repoId": "CRMDEMO",
      "repoURL": "git@github.com:techcorp/crmdemo.git",
      "description": "CRM demo application",
      "gitType": "github"
    },
    {
      "repoId": "WEBAPP",
      "repoURL": "https://github.com/techcorp/webapp.git",
      "description": "Customer web application",
      "gitType": "github"
    }
  ]
}
Resource Description
Attributes REST API List attributes, including mapping from a Git repository, path, and file
Pipeline Request Trigger REST API Trigger a Git checkout when a push webhook is not used