# GitLab Resource events API

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

GitLab Resource events 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 Resource Events. 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 retrieve the events that track changes to issues, merge requests, and epics: - [Label](https://docs.gitlab.com/user/project/labels/) events record who added or removed a label, and when. - [Iteration](https://docs.gitlab.com/user/group/iterations/) events record iteration changes for issues. - Milestone events record milestone changes for issues and merge requests. - State events record state changes for issues, merge requests, and epics. - Weight events record weight changes for issues. State events do not track the initial state (`created` or `opened`) of a resource. For a resource that was never closed or reopened, an empty list is returned.

## Operations (20)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v4/projects/{id}/issues/{eventable_id}/resource_iteration_events` | List all issue iteration events |
| GET | `/api/v4/projects/{id}/issues/{eventable_id}/resource_iteration_events/{event_id}` | Retrieve an issue iteration event |
| GET | `/api/v4/projects/{id}/issues/{eventable_id}/resource_weight_events` | List all project issue weight events |
| GET | `/api/v4/projects/{id}/issues/{eventable_id}/resource_weight_events/{event_id}` | Retrieve single issue weight event |
| GET | `/api/v4/projects/{id}/issues/{eventable_id}/resource_state_events` | List all project issue state events |
| GET | `/api/v4/projects/{id}/issues/{eventable_id}/resource_state_events/{event_id}` | Retrieve an issue state event |
| GET | `/api/v4/projects/{id}/merge_requests/{eventable_id}/resource_state_events` | List all project merge request state events |
| GET | `/api/v4/projects/{id}/merge_requests/{eventable_id}/resource_state_events/{event_id}` | Retrieve a merge request state event |
| GET | `/api/v4/groups/{id}/epics/{eventable_id}/resource_state_events` | List all group epic state events |
| GET | `/api/v4/groups/{id}/epics/{eventable_id}/resource_state_events/{event_id}` | Retrieve an epic state event |
| GET | `/api/v4/projects/{id}/issues/{eventable_id}/resource_label_events` | List all project issue label events |
| GET | `/api/v4/projects/{id}/issues/{eventable_id}/resource_label_events/{event_id}` | Retrieve an issue label event |
| GET | `/api/v4/projects/{id}/merge_requests/{eventable_id}/resource_label_events` | List all project merge request label events |
| GET | `/api/v4/projects/{id}/merge_requests/{eventable_id}/resource_label_events/{event_id}` | Retrieve a merge request label event |
| GET | `/api/v4/groups/{id}/epics/{eventable_id}/resource_label_events` | List all group epic label events |
| GET | `/api/v4/groups/{id}/epics/{eventable_id}/resource_label_events/{event_id}` | Retrieve an epic label event |
| GET | `/api/v4/projects/{id}/issues/{eventable_id}/resource_milestone_events` | List all project issue milestone events |
| GET | `/api/v4/projects/{id}/issues/{eventable_id}/resource_milestone_events/{event_id}` | Retrieve an issue milestone event |
| GET | `/api/v4/projects/{id}/merge_requests/{eventable_id}/resource_milestone_events` | List all project merge request milestone events |
| GET | `/api/v4/projects/{id}/merge_requests/{eventable_id}/resource_milestone_events/{event_id}` | Retrieve a merge request milestone event |

## Machine-readable artifacts (65)

- **OpenAPI** — https://artifacts.apis.io/gitlab/openapi/gitlab-resource-events-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

Resource Events

---

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