# GitLab

Manage GitLab: projects, merge requests, issues, pipelines, files, branches. Exposes **59 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `gitlab_projects_list` | List projects - GET /projects. |
| `gitlab_project_get` | Get one project - GET /projects/{id}. |
| `gitlab_project_create` | Create a new project - POST /projects. |
| `gitlab_project_update` | Update a project - PUT /projects/{id}. |
| `gitlab_project_delete` | Delete a project - DELETE /projects/{id}. |
| `gitlab_file_get` | Get a file - GET /projects/{id}/repository/files/{path}. |
| `gitlab_file_create` | Create a file - POST /projects/{id}/repository/files/{path}. |
| `gitlab_file_update` | Update a file - PUT /projects/{id}/repository/files/{path}. |
| `gitlab_file_delete` | Delete a file - DELETE /projects/{id}/repository/files/{path}. |
| `gitlab_branches_list` | List branches - GET /projects/{id}/repository/branches. |
| `gitlab_branch_get` | Get one branch - GET /projects/{id}/repository/branches/{branch}. |
| `gitlab_branch_create` | Create a branch - POST /projects/{id}/repository/branches. |
| `gitlab_branch_delete` | Delete a branch - DELETE /projects/{id}/repository/branches/{branch}. |
| `gitlab_commits_list` | List commits - GET /projects/{id}/repository/commits. |
| `gitlab_commit_get` | Get one commit - GET /projects/{id}/repository/commits/{sha}. |
| `gitlab_merge_requests_list` | List merge requests - GET /projects/{id}/merge_requests. |
| `gitlab_merge_request_get` | Get one merge request - GET /projects/{id}/merge_requests/{iid}. |
| `gitlab_merge_request_create` | Create a merge request - POST /projects/{id}/merge_requests. |
| `gitlab_merge_request_update` | Update a merge request - PUT /projects/{id}/merge_requests/{iid}. |
| `gitlab_merge_request_merge` | Merge a merge request - PUT /projects/{id}/merge_requests/{iid}/merge. |
| `gitlab_merge_request_close` | Close a merge request - PUT /projects/{id}/merge_requests/{iid}?state_event=close. |
| `gitlab_issues_list` | List issues - GET /projects/{id}/issues. |
| `gitlab_issue_get` | Get one issue - GET /projects/{id}/issues/{iid}. |
| `gitlab_issue_create` | Create an issue - POST /projects/{id}/issues. |
| `gitlab_issue_update` | Update an issue - PUT /projects/{id}/issues/{iid}. |
| `gitlab_issue_close` | Close an issue - PUT /projects/{id}/issues/{iid}?state_event=close. |
| `gitlab_notes_list` | List notes (comments) - GET /projects/{id}/{noteable_type}/{iid}/notes. |
| `gitlab_note_get` | Get one note (comment) - GET /projects/{id}/{noteable_type}/{iid}/notes/{note_id}. |
| `gitlab_note_create` | Create a note (comment) - POST /projects/{id}/{noteable_type}/{iid}/notes. |
| `gitlab_note_update` | Update a note (comment) - PUT /projects/{id}/{noteable_type}/{iid}/notes/{note_id}. |
| `gitlab_note_delete` | Delete a note (comment) - DELETE /projects/{id}/{noteable_type}/{iid}/notes/{note_id}. |
| `gitlab_pipelines_list` | List pipelines - GET /projects/{id}/pipelines. |
| `gitlab_pipeline_get` | Get one pipeline - GET /projects/{id}/pipelines/{pipeline_id}. |
| `gitlab_jobs_list` | List jobs (CI/CD) - GET /projects/{id}/jobs. |
| `gitlab_job_get` | Get one job - GET /projects/{id}/jobs/{job_id}. |
| `gitlab_members_list` | List project members - GET /projects/{id}/members. |
| `gitlab_member_get` | Get one member - GET /projects/{id}/members/{user_id}. |
| `gitlab_member_add` | Add a member to project - POST /projects/{id}/members. |
| `gitlab_member_update` | Update member access level - PUT /projects/{id}/members/{user_id}. |
| `gitlab_member_remove` | Remove a member from project - DELETE /projects/{id}/members/{user_id}. |
| `gitlab_users_list` | List users (global) - GET /users. |
| `gitlab_user_get` | Get one user - GET /users/{id}. |
| `gitlab_milestones_list` | List milestones - GET /projects/{id}/milestones. |
| `gitlab_milestone_get` | Get one milestone - GET /projects/{id}/milestones/{milestone_id}. |
| `gitlab_milestone_create` | Create a milestone - POST /projects/{id}/milestones. |
| `gitlab_milestone_update` | Update a milestone - PUT /projects/{id}/milestones/{milestone_id}. |
| `gitlab_labels_list` | List labels - GET /projects/{id}/labels. |
| `gitlab_label_get` | Get one label - GET /projects/{id}/labels/{label_id}. |
| `gitlab_label_create` | Create a label - POST /projects/{id}/labels. |
| `gitlab_label_update` | Update a label - PUT /projects/{id}/labels/{label_id}. |
| `gitlab_label_delete` | Delete a label - DELETE /projects/{id}/labels/{label_id}. |
| `gitlab_groups_list` | List groups - GET /groups. |
| `gitlab_group_get` | Get one group - GET /groups/{id}. |
| `gitlab_group_create` | Create a group - POST /groups. |
| `gitlab_group_update` | Update a group - PUT /groups/{id}. |
| `gitlab_group_delete` | Delete a group - DELETE /groups/{id}. |
| `gitlab_group_projects_list` | List projects in a group - GET /groups/{id}/projects. |
| `gitlab_group_members_list` | List group members - GET /groups/{id}/members. |
| `gitlab_search` | Search GitLab - GET /search. |

## How to get credentials

This connector uses **OAuth 2.0**. In FlyMyAI, open the tool and click
**Connect** - you'll be redirected to GitLab to authorize, then back to
FlyMyAI. There is no API key to paste.

> The OAuth app must be registered by FlyMyAI for this provider. If you see
> *"connection not configured"*, the provider's client credentials are still
> being set up - check back shortly.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| _(none)_ | Connect via OAuth - nothing to paste. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the OAuth connection expired or was revoked - reconnect.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [GitLab API documentation](https://docs.gitlab.com/ee/api/)