# GitLab — Issue Tracking API: overview

> Canonical URL: https://developers.apideck.com/apis/issue-tracking/gitlab/overview

“From project planning and source code management to CI/CD and monitoring, GitLab is a complete DevOps platform, delivered as a single application. Only GitLab enables Concurrent DevOps to make the software lifecycle 200% faster.”.
- Status: live
- Authentication: oauth2

- **costs:** No separate charge for API access.
- **account type required:** Any GitLab.com plan, the free one included.
- **difficulty:** straightforward
- **partnership note:** Anyone with a GitLab account, or a group they manage, registers the application in GitLab settings and gets the client ID and secret straight away.
- **apideck credentials note:** OAuth shows "Apideck" as the requesting application.
- **webhooks:** Virtual webhooks - ticket created and updated, detected by polling the group's issues.
- **authentication note:** Authorization Code flow.
- **partnership portal name:** GitLab OAuth application settings
- **important to know:** Each connection reaches one GitLab group, chosen by the Group ID entered when connecting, and all data comes from that group. A consumer with several groups needs a connection for each.
- **sandbox note:** Test in a separate free GitLab.com account with its own group. The free plan allows 5 users per top-level group.
- **responsibility matrix:**   - **customer:** ✓ Via the Apideck Dashboard
  - **area:** Enable the GitLab Connector
  - **customer:** ✓ User- or group-owned, in GitLab settings
  - **area:** Register a GitLab OAuth Application
  - **consumer:** ✓ In Vault
  - **area:** Authorise the Connection and Enter the Group ID
  - **area:** Store and Encrypt Credentials
  - **apideck:** ✓
  - **apideck:** ✓ Automatic
  - **area:** Keep the Connection Authenticated
  - **area:** Poll GitLab for Ticket Changes
  - **apideck:** ✓ Automatic
  - **area:** Monitor Connections
  - **apideck:** Logs and alerts
  - **customer:** ✓ Via the Apideck Dashboard
  - **consumer:** ✓ Can revoke the application's access in GitLab
- **external guides:**   - **source:** GitLab
  - **url:** https://docs.gitlab.com/api/oauth2/
  - **title:** GitLab OAuth 2.0 identity provider API
  - **source:** GitLab
  - **title:** GitLab.com rate limits
  - **url:** https://docs.gitlab.com/user/gitlab_com/rate_limits/
- **apideck credentials available:** true
- **sandbox available:** false
- **supported resource categories:**   - **name:** Tickets
  - **resources:** collection-tickets
collection-ticket-comments
group-issues
  - **name:** Collections
  - **resources:** groups
collections
  - **name:** Users and Tags
  - **resources:** collection-users
collection-tags
- **partnership required:** false
- **difficulty reason:** Self-Service OAuth App + Free GitLab.com Account Sufficient, No Partnership or Review
- **partnership url:** https://docs.gitlab.com/integration/oauth_provider/
- **environment notes:**   - **description:** Testing and production share credentials on gitlab.com.
  - **environment:** Single environment
- **rate limits:** 2,000 requests a minute for each authenticated user on GitLab.com.
- **consumer access level:** Any GitLab user with access to the group being connected. The connection reaches what that user can already see in it.
- **sandbox url:** https://gitlab.com/users/sign_up

## Supported resources

- **name:** Collections
- **id:** collections
- **downstream id:** projects
- **downstream name:** Projects
- **status:** live
- **custom field support:** false
- **id:** collection-users
- **name:** Users
- **downstream id:** project-members
- **downstream name:** Project Members
- **custom field support:** false
- **status:** live
- **id:** collection-tickets
- **downstream id:** project-issues
- **status:** live
- **custom field support:** false
- **name:** Tickets
- **downstream name:** Project Issues
- **downstream name:** Project Issue Notes
- **status:** live
- **name:** Comments
- **downstream id:** project-issue-notes
- **custom field support:** false
- **id:** collection-ticket-comments
- **downstream name:** Project Labels
- **status:** live
- **custom field support:** false
- **id:** collection-tags
- **name:** Tags
- **downstream id:** project-labels

An omitted operation list does not establish operation support. Verify the selected operation in the coverage matrix.

[API reference](https://developers.apideck.com/apis/issue-tracking/reference.md) · [Coverage matrix](https://developers.apideck.com/apis/issue-tracking/coverage)