gitlab-repository

GitLab Repository - browse projects, branches, commits, files, and repository tree

Server path: /gitlab-repository | Type: Application | PCID required: Yes

Tools

Tool	Description
gitlab_repository_compare_repository	Compare two branches, tags, or commits
gitlab_repository_create_branch	Create a repository branch
gitlab_repository_get_branch	Retrieve a repository branch
gitlab_repository_get_commit	Retrieve a commit
gitlab_repository_get_commit_diff	Retrieve a commit diff
gitlab_repository_get_file	Retrieve a file from a repository
gitlab_repository_get_project	Get a single project
gitlab_repository_get_tree	Get a project repository tree
gitlab_repository_list_branches	List all repository branches
gitlab_repository_list_commits	List all repository commits
gitlab_repository_list_projects	List all projects

---

gitlab_repository_compare_repository

Compare two branches, tags, or commits

Parameters:

Parameter	Type	Required	Default	Description
id	string	Yes	—	The ID or URL-encoded path of the project
from	string	Yes	—	The commit, branch name, or tag name to start comparison
to	string	Yes	—	The commit, branch name, or tag name to stop comparison
from_project_id	integer	No	—	The project to compare from
straight	boolean	No	—	Comparison method, true for direct comparison between from and to (from..to), false to compare using merge base (from…to)
unidiff	boolean	No	—	A diff in a Unified diff format

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "The ID or URL-encoded path of the project"
    },
    "from": {
      "type": "string",
      "description": "The commit, branch name, or tag name to start comparison"
    },
    "to": {
      "type": "string",
      "description": "The commit, branch name, or tag name to stop comparison"
    },
    "from_project_id": {
      "type": "integer",
      "description": "The project to compare from"
    },
    "straight": {
      "type": "boolean",
      "description": "Comparison method, `true` for direct comparison between `from` and `to` (`from`..`to`), `false` to compare using merge base (`from`...`to`)"
    },
    "unidiff": {
      "type": "boolean",
      "description": "A diff in a Unified diff format"
    }
  },
  "required": [
    "PCID",
    "id",
    "from",
    "to"
  ]
}

---

gitlab_repository_create_branch

Create a repository branch

Parameters:

Parameter	Type	Required	Default	Description
id	string	Yes	—	The ID or URL-encoded path of the project
branch	string	Yes	—	The name of the branch
ref	string	Yes	—	Create branch from commit sha or existing branch

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "The ID or URL-encoded path of the project"
    },
    "branch": {
      "type": "string",
      "description": "The name of the branch"
    },
    "ref": {
      "type": "string",
      "description": "Create branch from commit sha or existing branch"
    }
  },
  "required": [
    "PCID",
    "id",
    "branch",
    "ref"
  ]
}

---

gitlab_repository_get_branch

Retrieve a repository branch

Parameters:

Parameter	Type	Required	Default	Description
id	string	Yes	—	The ID or URL-encoded path of the project
branch	string	Yes	—	The branch value

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "The ID or URL-encoded path of the project"
    },
    "branch": {
      "type": "string",
      "description": "The branch value"
    }
  },
  "required": [
    "PCID",
    "id",
    "branch"
  ]
}

---

gitlab_repository_get_commit

Retrieve a commit

Parameters:

Parameter	Type	Required	Default	Description
id	string	Yes	—	The ID or URL-encoded path of the project
sha	string	Yes	—	A commit sha, or the name of a branch or tag
stats	boolean	No	—	Include commit stats

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "The ID or URL-encoded path of the project"
    },
    "sha": {
      "type": "string",
      "description": "A commit sha, or the name of a branch or tag"
    },
    "stats": {
      "type": "boolean",
      "description": "Include commit stats"
    }
  },
  "required": [
    "PCID",
    "id",
    "sha"
  ]
}

---

gitlab_repository_get_commit_diff

Retrieve a commit diff

Parameters:

Parameter	Type	Required	Default	Description
id	string	Yes	—	The ID or URL-encoded path of the project
sha	string	Yes	—	A commit sha, or the name of a branch or tag
page	integer	No	—	Current page number
per_page	integer	No	—	Number of items per page
unidiff	boolean	No	—	A diff in a Unified diff format

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "The ID or URL-encoded path of the project"
    },
    "sha": {
      "type": "string",
      "description": "A commit sha, or the name of a branch or tag"
    },
    "page": {
      "type": "integer",
      "description": "Current page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Number of items per page"
    },
    "unidiff": {
      "type": "boolean",
      "description": "A diff in a Unified diff format"
    }
  },
  "required": [
    "PCID",
    "id",
    "sha"
  ]
}

---

gitlab_repository_get_file

Retrieve a file from a repository

Parameters:

Parameter	Type	Required	Default	Description
id	string	Yes	—	The project ID
file_path	string	Yes	—	The URL-encoded path to the file.
ref	string	Yes	—	The name of branch, tag or commit

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "The project ID"
    },
    "file_path": {
      "type": "string",
      "description": "The URL-encoded path to the file."
    },
    "ref": {
      "type": "string",
      "description": "The name of branch, tag or commit"
    }
  },
  "required": [
    "PCID",
    "id",
    "file_path",
    "ref"
  ]
}

---

gitlab_repository_get_project

Get a single project

Parameters:

Parameter	Type	Required	Default	Description
id	string	Yes	—	The ID or URL-encoded path of the project
statistics	boolean	No	—	Include project statistics
with_custom_attributes	boolean	No	—	Include custom attributes in the response
license	boolean	No	—	Include project license data

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "The ID or URL-encoded path of the project"
    },
    "statistics": {
      "type": "boolean",
      "description": "Include project statistics"
    },
    "with_custom_attributes": {
      "type": "boolean",
      "description": "Include custom attributes in the response"
    },
    "license": {
      "type": "boolean",
      "description": "Include project license data"
    }
  },
  "required": [
    "PCID",
    "id"
  ]
}

---

gitlab_repository_get_tree

Get a project repository tree

Parameters:

Parameter	Type	Required	Default	Description
id	string	Yes	—	The ID or URL-encoded path of the project
ref	string	No	—	The name of a repository branch or tag, if not given the default branch is used
path	string	No	—	The path of the tree
recursive	boolean	No	—	Used to get a recursive tree
page	integer	No	—	Current page number
per_page	integer	No	—	Number of items per page
pagination	string	No	—	Specify the pagination method (“none” is only valid if “recursive” is true)
page_token	string	No	—	Record from which to start the keyset pagination

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "The ID or URL-encoded path of the project"
    },
    "ref": {
      "type": "string",
      "description": "The name of a repository branch or tag, if not given the default branch is used"
    },
    "path": {
      "type": "string",
      "description": "The path of the tree"
    },
    "recursive": {
      "type": "boolean",
      "description": "Used to get a recursive tree"
    },
    "page": {
      "type": "integer",
      "description": "Current page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Number of items per page"
    },
    "pagination": {
      "type": "string",
      "description": "Specify the pagination method (\"none\" is only valid if \"recursive\" is true)",
      "enum": [
        "legacy",
        "keyset",
        "none"
      ]
    },
    "page_token": {
      "type": "string",
      "description": "Record from which to start the keyset pagination"
    }
  },
  "required": [
    "PCID",
    "id"
  ]
}

---

gitlab_repository_list_branches

List all repository branches

Parameters:

Parameter	Type	Required	Default	Description
id	string	Yes	—	The ID or URL-encoded path of the project
page	integer	No	—	Current page number
per_page	integer	No	—	Number of items per page
search	string	No	—	Return list of branches matching the search criteria
regex	string	No	—	Return list of branches matching the regex
sort	string	No	—	Return list of branches sorted by the given field
page_token	string	No	—	Name of branch to start the pagination from

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "The ID or URL-encoded path of the project"
    },
    "page": {
      "type": "integer",
      "description": "Current page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Number of items per page"
    },
    "search": {
      "type": "string",
      "description": "Return list of branches matching the search criteria"
    },
    "regex": {
      "type": "string",
      "description": "Return list of branches matching the regex"
    },
    "sort": {
      "type": "string",
      "description": "Return list of branches sorted by the given field",
      "enum": [
        "name_asc",
        "updated_asc",
        "updated_desc"
      ]
    },
    "page_token": {
      "type": "string",
      "description": "Name of branch to start the pagination from"
    }
  },
  "required": [
    "PCID",
    "id"
  ]
}

---

gitlab_repository_list_commits

List all repository commits

Parameters:

Parameter	Type	Required	Default	Description
id	string	Yes	—	The ID or URL-encoded path of the project
ref_name	string	No	—	The name of a repository branch or tag, if not given the default branch is used
since	string	No	—	Only commits after or on this date will be returned
until	string	No	—	Only commits before or on this date will be returned
path	string	No	—	The file path
follow	boolean	No	—	Follow file renames when filtering by path
author	string	No	—	Search commits by commit author
all	boolean	No	—	Every commit will be returned
with_stats	boolean	No	—	Stats about each commit will be added to the response
first_parent	boolean	No	—	Only include the first parent of merges
order	string	No	—	List commits in order
trailers	boolean	No	—	Parse and include Git trailers for every commit
page	integer	No	—	Current page number
per_page	integer	No	—	Number of items per page

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "The ID or URL-encoded path of the project"
    },
    "ref_name": {
      "type": "string",
      "description": "The name of a repository branch or tag, if not given the default branch is used"
    },
    "since": {
      "type": "string",
      "description": "Only commits after or on this date will be returned"
    },
    "until": {
      "type": "string",
      "description": "Only commits before or on this date will be returned"
    },
    "path": {
      "type": "string",
      "description": "The file path"
    },
    "follow": {
      "type": "boolean",
      "description": "Follow file renames when filtering by path"
    },
    "author": {
      "type": "string",
      "description": "Search commits by commit author"
    },
    "all": {
      "type": "boolean",
      "description": "Every commit will be returned"
    },
    "with_stats": {
      "type": "boolean",
      "description": "Stats about each commit will be added to the response"
    },
    "first_parent": {
      "type": "boolean",
      "description": "Only include the first parent of merges"
    },
    "order": {
      "type": "string",
      "description": "List commits in order",
      "enum": [
        "default",
        "topo"
      ]
    },
    "trailers": {
      "type": "boolean",
      "description": "Parse and include Git trailers for every commit"
    },
    "page": {
      "type": "integer",
      "description": "Current page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Number of items per page"
    }
  },
  "required": [
    "PCID",
    "id"
  ]
}

---

gitlab_repository_list_projects

List all projects

Parameters:

Parameter	Type	Required	Default	Description
order_by	string	No	—	Return projects ordered by field. storage_size, repository_size, wiki_size, packages_size are only available to admins. Similarity is available when searching and is limited to projects the user has access to.
sort	string	No	—	Return projects sorted in ascending and descending order
archived	boolean	No	—	Limit by archived status
visibility	string	No	—	Limit by visibility
search	string	No	—	Return list of projects matching the search criteria
search_namespaces	boolean	No	—	Include ancestor namespaces when matching search criteria
owned	boolean	No	—	Limit by owned by authenticated user
starred	boolean	No	—	Limit by starred status
imported	boolean	No	—	Limit by imported by authenticated user
membership	boolean	No	—	Limit by projects that the current user is a member of
with_issues_enabled	boolean	No	—	Limit by enabled issues feature
with_merge_requests_enabled	boolean	No	—	Limit by enabled merge requests feature
with_programming_language	string	No	—	Limit to repositories which use the given programming language
min_access_level	integer	No	—	Limit by minimum access level of authenticated user
id_after	integer	No	—	Limit results to projects with IDs greater than the specified ID
id_before	integer	No	—	Limit results to projects with IDs less than the specified ID
last_activity_after	string	No	—	Limit results to projects with last_activity after specified time. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ
last_activity_before	string	No	—	Limit results to projects with last_activity before specified time. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ
repository_storage	string	No	—	Which storage shard the repository is on. Available only to admins
topic	string[]	No	—	Comma-separated list of topics. Limit results to projects having all topics
topic_id	integer	No	—	Limit results to projects with the assigned topic given by the topic ID
updated_before	string	No	—	Return projects updated before the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ
updated_after	string	No	—	Return projects updated after the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ
include_pending_delete	boolean	No	—	Include projects in pending delete state. Can only be set by admins
marked_for_deletion_on	string	No	—	Date when the project was marked for deletion
active	boolean	No	—	Limit by projects that are not archived and not marked for deletion
wiki_checksum_failed	boolean	No	—	Limit by projects where wiki checksum is failed
repository_checksum_failed	boolean	No	—	Limit by projects where repository checksum is failed
include_hidden	boolean	No	—	Include hidden projects. Can only be set by admins
page	integer	No	—	Current page number
per_page	integer	No	—	Number of items per page
simple	boolean	No	—	Return only the ID, URL, name, and path of each project
statistics	boolean	No	—	Include project statistics
with_custom_attributes	boolean	No	—	Include custom attributes in the response

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "order_by": {
      "type": "string",
      "description": "Return projects ordered by field. storage_size, repository_size, wiki_size, packages_size are only available to admins. Similarity is available when searching and is limited to projects the user has access to.",
      "enum": [
        "id",
        "name",
        "path",
        "created_at",
        "updated_at",
        "last_activity_at",
        "similarity",
        "star_count",
        "storage_size",
        "repository_size",
        "wiki_size",
        "packages_size"
      ]
    },
    "sort": {
      "type": "string",
      "description": "Return projects sorted in ascending and descending order",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "archived": {
      "type": "boolean",
      "description": "Limit by archived status"
    },
    "visibility": {
      "type": "string",
      "description": "Limit by visibility",
      "enum": [
        "private",
        "internal",
        "public"
      ]
    },
    "search": {
      "type": "string",
      "description": "Return list of projects matching the search criteria"
    },
    "search_namespaces": {
      "type": "boolean",
      "description": "Include ancestor namespaces when matching search criteria"
    },
    "owned": {
      "type": "boolean",
      "description": "Limit by owned by authenticated user"
    },
    "starred": {
      "type": "boolean",
      "description": "Limit by starred status"
    },
    "imported": {
      "type": "boolean",
      "description": "Limit by imported by authenticated user"
    },
    "membership": {
      "type": "boolean",
      "description": "Limit by projects that the current user is a member of"
    },
    "with_issues_enabled": {
      "type": "boolean",
      "description": "Limit by enabled issues feature"
    },
    "with_merge_requests_enabled": {
      "type": "boolean",
      "description": "Limit by enabled merge requests feature"
    },
    "with_programming_language": {
      "type": "string",
      "description": "Limit to repositories which use the given programming language"
    },
    "min_access_level": {
      "type": "integer",
      "description": "Limit by minimum access level of authenticated user",
      "enum": [
        10,
        15,
        20,
        30,
        40,
        50
      ]
    },
    "id_after": {
      "type": "integer",
      "description": "Limit results to projects with IDs greater than the specified ID"
    },
    "id_before": {
      "type": "integer",
      "description": "Limit results to projects with IDs less than the specified ID"
    },
    "last_activity_after": {
      "type": "string",
      "description": "Limit results to projects with last_activity after specified time. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ"
    },
    "last_activity_before": {
      "type": "string",
      "description": "Limit results to projects with last_activity before specified time. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ"
    },
    "repository_storage": {
      "type": "string",
      "description": "Which storage shard the repository is on. Available only to admins"
    },
    "topic": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Comma-separated list of topics. Limit results to projects having all topics"
    },
    "topic_id": {
      "type": "integer",
      "description": "Limit results to projects with the assigned topic given by the topic ID"
    },
    "updated_before": {
      "type": "string",
      "description": "Return projects updated before the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ"
    },
    "updated_after": {
      "type": "string",
      "description": "Return projects updated after the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ"
    },
    "include_pending_delete": {
      "type": "boolean",
      "description": "Include projects in pending delete state. Can only be set by admins"
    },
    "marked_for_deletion_on": {
      "type": "string",
      "description": "Date when the project was marked for deletion"
    },
    "active": {
      "type": "boolean",
      "description": "Limit by projects that are not archived and not marked for deletion"
    },
    "wiki_checksum_failed": {
      "type": "boolean",
      "description": "Limit by projects where wiki checksum is failed"
    },
    "repository_checksum_failed": {
      "type": "boolean",
      "description": "Limit by projects where repository checksum is failed"
    },
    "include_hidden": {
      "type": "boolean",
      "description": "Include hidden projects. Can only be set by admins"
    },
    "page": {
      "type": "integer",
      "description": "Current page number"
    },
    "per_page": {
      "type": "integer",
      "description": "Number of items per page"
    },
    "simple": {
      "type": "boolean",
      "description": "Return only the ID, URL, name, and path of each project"
    },
    "statistics": {
      "type": "boolean",
      "description": "Include project statistics"
    },
    "with_custom_attributes": {
      "type": "boolean",
      "description": "Include custom attributes in the response"
    }
  },
  "required": [
    "PCID"
  ]
}