# GitLab Integrations API

**Canonical:** https://apis.io/apis/gitlab/gitlab-integrations-api/  
**Provider:** GitLab — https://apis.io/providers/gitlab/  
**Base URL:** https://gitlab.com/api/v4  
**Documentation:** https://docs.gitlab.com/api/rest/

GitLab Integrations API is one of 189 APIs that [GitLab](https://apis.io/providers/gitlab/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. This API exposes 16 JSON Schema definitions. Tagged areas include Integration. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, an API reference, rate-limit docs, an AsyncAPI specification, and 16 JSON Schemas.

Use this API to manage [integrations](https://docs.gitlab.com/user/project/integrations/) for a project, or for a group and its subgroups. Managing integrations requires the Maintainer or Owner role for the project or group.

## Operations (60 of 168)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v4/integrations/slack/options` | Get Slack interactive component options |
| POST | `/api/v4/integrations/slack/interactions` | Process Slack interaction events |
| POST | `/api/v4/integrations/slack/events` | Receive Slack events |
| GET | `/api/v4/projects/{id}/services` | List all active integrations |
| PUT | `/api/v4/projects/{id}/services/apple-app-store` | Create or update the Apple App Store integration |
| PUT | `/api/v4/projects/{id}/services/asana` | Create or update the Asana integration |
| PUT | `/api/v4/projects/{id}/services/assembla` | Create or update the Assembla integration |
| PUT | `/api/v4/projects/{id}/services/bamboo` | Create or update the Bamboo integration |
| PUT | `/api/v4/projects/{id}/services/bugzilla` | Create or update the Bugzilla integration |
| PUT | `/api/v4/projects/{id}/services/buildkite` | Create or update the Buildkite integration |
| PUT | `/api/v4/projects/{id}/services/campfire` | Create or update the Campfire integration |
| PUT | `/api/v4/projects/{id}/services/confluence` | Create or update the Confluence integration |
| PUT | `/api/v4/projects/{id}/services/custom-issue-tracker` | Create or update the Custom Issue Tracker integration |
| PUT | `/api/v4/projects/{id}/services/datadog` | Create or update the Datadog integration |
| PUT | `/api/v4/projects/{id}/services/diffblue-cover` | Create or update the Diffblue Cover integration |
| PUT | `/api/v4/projects/{id}/services/discord` | Create or update the Discord integration |
| PUT | `/api/v4/projects/{id}/services/drone-ci` | Create or update the Drone Ci integration |
| PUT | `/api/v4/projects/{id}/services/emails-on-push` | Create or update the Emails On Push integration |
| PUT | `/api/v4/projects/{id}/services/external-wiki` | Create or update the External Wiki integration |
| PUT | `/api/v4/projects/{id}/services/gitlab-slack-application` | Create or update the Gitlab Slack Application integration |
| PUT | `/api/v4/projects/{id}/services/google-play` | Create or update the Google Play integration |
| PUT | `/api/v4/projects/{id}/services/hangouts-chat` | Create or update the Hangouts Chat integration |
| PUT | `/api/v4/projects/{id}/services/harbor` | Create or update the Harbor integration |
| PUT | `/api/v4/projects/{id}/services/irker` | Create or update the Irker integration |
| PUT | `/api/v4/projects/{id}/services/jenkins` | Create or update the Jenkins integration |
| PUT | `/api/v4/projects/{id}/services/jira` | Create or update the Jira integration |
| PUT | `/api/v4/projects/{id}/services/jira-cloud-app` | Create or update the Jira Cloud App integration |
| PUT | `/api/v4/projects/{id}/services/linear` | Create or update the Linear integration |
| PUT | `/api/v4/projects/{id}/services/matrix` | Create or update the Matrix integration |
| PUT | `/api/v4/projects/{id}/services/mattermost-slash-commands` | Create or update the Mattermost Slash Commands integration |
| PUT | `/api/v4/projects/{id}/services/packagist` | Create or update the Packagist integration |
| PUT | `/api/v4/projects/{id}/services/phorge` | Create or update the Phorge integration |
| PUT | `/api/v4/projects/{id}/services/pipelines-email` | Create or update the Pipelines Email integration |
| PUT | `/api/v4/projects/{id}/services/pivotaltracker` | Create or update the Pivotaltracker integration |
| PUT | `/api/v4/projects/{id}/services/pumble` | Create or update the Pumble integration |
| PUT | `/api/v4/projects/{id}/services/pushover` | Create or update the Pushover integration |
| PUT | `/api/v4/projects/{id}/services/redmine` | Create or update the Redmine integration |
| PUT | `/api/v4/projects/{id}/services/ewm` | Create or update the Ewm integration |
| PUT | `/api/v4/projects/{id}/services/youtrack` | Create or update the Youtrack integration |
| PUT | `/api/v4/projects/{id}/services/clickup` | Create or update the Clickup integration |
| PUT | `/api/v4/projects/{id}/services/slack` | Create or update the Slack integration |
| PUT | `/api/v4/projects/{id}/services/microsoft-teams` | Create or update the Microsoft Teams integration |
| PUT | `/api/v4/projects/{id}/services/mattermost` | Create or update the Mattermost integration |
| PUT | `/api/v4/projects/{id}/services/teamcity` | Create or update the Teamcity integration |
| PUT | `/api/v4/projects/{id}/services/telegram` | Create or update the Telegram integration |
| PUT | `/api/v4/projects/{id}/services/unify-circuit` | Create or update the Unify Circuit integration |
| PUT | `/api/v4/projects/{id}/services/webex-teams` | Create or update the Webex Teams integration |
| PUT | `/api/v4/projects/{id}/services/zentao` | Create or update the Zentao integration |
| PUT | `/api/v4/projects/{id}/services/squash-tm` | Create or update the Squash Tm integration |
| PUT | `/api/v4/projects/{id}/services/github` | Create or update the Github integration |
| PUT | `/api/v4/projects/{id}/services/git-guardian` | Create or update the Git Guardian integration |
| PUT | `/api/v4/projects/{id}/services/google-cloud-platform-artifact-registry` | Create or update the Google Cloud Platform Artifact Registry integration |
| PUT | `/api/v4/projects/{id}/services/google-cloud-platform-workload-identity-federation` | Create or update the Google Cloud Platform Workload Identity Federation… |
| PUT | `/api/v4/projects/{id}/services/mock-ci` | Create or update the Mock Ci integration |
| PUT | `/api/v4/projects/{id}/services/mock-monitoring` | Create or update the Mock Monitoring integration |
| DELETE | `/api/v4/projects/{id}/services/{slug}` | Disable an integration |
| GET | `/api/v4/projects/{id}/services/{slug}` | Retrieve integration settings |
| POST | `/api/v4/projects/{id}/services/mattermost_slash_commands/trigger` | Trigger a slash command for mattermost-slash-commands |
| GET | `/api/v4/projects/{id}/integrations` | List all active integrations |
| PUT | `/api/v4/projects/{id}/integrations/apple-app-store` | Create or update the Apple App Store integration |

…and 108 more operations. They are listed in full on the page.

## Machine-readable artifacts (65)

- **OpenAPI** — https://artifacts.apis.io/gitlab/openapi/gitlab-integrations-api-openapi.yml
- **Documentation** — https://docs.gitlab.com/api/openapi/
- **Documentation** — https://docs.gitlab.com/api/issues/
- **Authentication** — https://docs.gitlab.com/api/rest/authentication/
- **JSONSchema** — https://artifacts.apis.io/gitlab/json-schema/gitlab-put-api-v4-application-settings-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/gitlab/json-schema/gitlab-apientities-geo-node-status-schema.json
- **JSONSchema** — https://artifacts.apis.io/gitlab/json-schema/gitlab-apientities-geo-site-status-schema.json
- **JSONSchema** — https://artifacts.apis.io/gitlab/json-schema/gitlab-apientities-application-setting-schema.json
- **JSONSchema** — https://artifacts.apis.io/gitlab/json-schema/gitlab-post-api-v4-geo-status-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/gitlab/json-schema/gitlab-put-api-v4-projects-id-request-schema.json
- **Documentation** — https://docs.gitlab.com/api/merge_requests/
- **Documentation** — https://docs.gitlab.com/api/pipelines/
- **Documentation** — https://docs.gitlab.com/api/jobs/
- **Documentation** — https://docs.gitlab.com/api/runners/
- **Documentation** — https://docs.gitlab.com/api/users/
- **Documentation** — https://docs.gitlab.com/api/repositories/
- **Documentation** — https://docs.gitlab.com/api/commits/
- **Documentation** — https://docs.gitlab.com/api/branches/
- **Documentation** — https://docs.gitlab.com/api/tags/
- **Documentation** — https://docs.gitlab.com/api/releases/
- **Documentation** — https://docs.gitlab.com/api/environments/
- **Documentation** — https://docs.gitlab.com/api/deployments/
- **Documentation** — https://docs.gitlab.com/api/pipeline_schedules/
- **Documentation** — https://docs.gitlab.com/api/labels/
- **Documentation** — https://docs.gitlab.com/api/milestones/
- **Documentation** — https://docs.gitlab.com/api/notes/
- **Documentation** — https://docs.gitlab.com/api/snippets/
- **Documentation** — https://docs.gitlab.com/api/packages/
- **Documentation** — https://docs.gitlab.com/api/container_registry/
- **Documentation** — https://docs.gitlab.com/api/vulnerabilities/
- **Documentation** — https://docs.gitlab.com/api/deploy_keys/
- **Documentation** — https://docs.gitlab.com/api/protected_branches/
- **Documentation** — https://docs.gitlab.com/api/wikis/
- **Documentation** — https://docs.gitlab.com/api/events/
- **Documentation** — https://docs.gitlab.com/api/search/
- **Documentation** — https://docs.gitlab.com/api/namespaces/
- **Documentation** — https://docs.gitlab.com/api/groups/
- **Documentation** — https://docs.gitlab.com/api/projects/
- **Documentation** — https://docs.gitlab.com/api/applications/
- **Documentation** — https://docs.gitlab.com/api/avatar/
- …and 25 more, listed in full on the page.

## Other GitLab APIs (12)

- [GitLab Orbit gRPC API](https://apis.io/apis/gitlab/gitlab-orbit-api/)
- [GitLab GraphQL API](https://apis.io/apis/gitlab/gitlab-graphql-api/)
- [GitLab Applications API](https://apis.io/apis/gitlab/gitlab-applications-api/)
- [GitLab Authorization API](https://apis.io/apis/gitlab/gitlab-authorization-api/)
- [GitLab Broadcast Messages API](https://apis.io/apis/gitlab/gitlab-broadcast-messages-api/)
- [GitLab Groups API](https://apis.io/apis/gitlab/gitlab-groups-api/)
- [GitLab Metadata API](https://apis.io/apis/gitlab/gitlab-metadata-api/)
- [GitLab Project Webhooks API](https://apis.io/apis/gitlab/gitlab-project-webhooks-api/)
- [GitLab Projects API](https://apis.io/apis/gitlab/gitlab-projects-api/)
- [GitLab Tokens API](https://apis.io/apis/gitlab/gitlab-tokens-api/)
- [GitLab User Info API](https://apis.io/apis/gitlab/gitlab-user-info-api/)
- [GitLab Webhook Configuration API](https://apis.io/apis/gitlab/gitlab-webhook-configuration-api/)

## Tags

Integration

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gitlab/gitlab-integrations-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gitlab/.