> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# 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`](#gitlab_repository_compare_repository) | Compare two branches, tags, or commits |
| [`gitlab_repository_create_branch`](#gitlab_repository_create_branch) | Create a repository branch |
| [`gitlab_repository_get_branch`](#gitlab_repository_get_branch) | Retrieve a repository branch |
| [`gitlab_repository_get_commit`](#gitlab_repository_get_commit) | Retrieve a commit |
| [`gitlab_repository_get_commit_diff`](#gitlab_repository_get_commit_diff) | Retrieve a commit diff |
| [`gitlab_repository_get_file`](#gitlab_repository_get_file) | Retrieve a file from a repository |
| [`gitlab_repository_get_project`](#gitlab_repository_get_project) | Get a single project |
| [`gitlab_repository_get_tree`](#gitlab_repository_get_tree) | Get a project repository tree |
| [`gitlab_repository_list_branches`](#gitlab_repository_list_branches) | List all repository branches |
| [`gitlab_repository_list_commits`](#gitlab_repository_list_commits) | List all repository commits |
| [`gitlab_repository_list_projects`](#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 |
```json theme={null}
{
"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 |
```json theme={null}
{
"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 |
```json theme={null}
{
"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 |
```json theme={null}
{
"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 |
```json theme={null}
{
"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 |
```json theme={null}
{
"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 |
```json theme={null}
{
"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 |
```json theme={null}
{
"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 |
```json theme={null}
{
"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 |
```json theme={null}
{
"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 |
```json theme={null}
{
"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"
]
}
```