# GitLab Issues API

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

GitLab Issues 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 Issues. 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 [issues](https://docs.gitlab.com/user/project/issues/), their [links to related issues](https://docs.gitlab.com/user/project/issues/related_issues/), and issue statistics. You can: - Create, update, and delete issues. - Manage issue metadata, like assignees, labels, milestones, and time tracking. - Cross-reference issues and merge requests. - Track issue movement and promotion between projects and epics. - Retrieve statistics about issues. If a user is not a member of a private project, a `GET` request on that project results in a `404` status code. > [!note] > The `references.relative` attribute is relative to the group or project of the issue being requested. > When an issue is fetched from its project, the `relative` format is the same as the `short` format. > When requested across groups or projects, it's expected to be the same as the `full` format.

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v4/issues_statistics` | Retrieve issues statistics for the currently authenticated user |
| GET | `/api/v4/issues` | List all issues for the currently authenticated user |
| GET | `/api/v4/issues/{id}` | Retrieve an issue |
| POST | `/api/v4/projects/{id}/issues/{issue_iid}/time_estimate` | Set the estimated time for an issue |
| POST | `/api/v4/projects/{id}/issues/{issue_iid}/reset_time_estimate` | Reset the estimated time for an issue |
| POST | `/api/v4/projects/{id}/issues/{issue_iid}/add_spent_time` | Add spent time for an issue |
| POST | `/api/v4/projects/{id}/issues/{issue_iid}/reset_spent_time` | Reset spent time for an issue |
| GET | `/api/v4/projects/{id}/issues/{issue_iid}/time_stats` | Retrieve time tracking stats for an issue |
| GET | `/api/v4/projects/{id}/issues/{issue_iid}/related_merge_requests` | List all merge requests related to an issue |
| GET | `/api/v4/projects/{id}/issues/{issue_iid}/participants` | List all participants in an issue |
| GET | `/api/v4/projects/{id}/issues/{issue_iid}/user_agent_detail` | Retrieve user agent details for an issue |
| GET | `/api/v4/projects/{id}/issues/{issue_iid}/links` | List all issue links |
| POST | `/api/v4/projects/{id}/issues/{issue_iid}/links` | Create an issue link |
| GET | `/api/v4/projects/{id}/issues/{issue_iid}/links/{issue_link_id}` | Retrieve an issue link |
| DELETE | `/api/v4/projects/{id}/issues/{issue_iid}/links/{issue_link_id}` | Delete an issue link |

## Machine-readable artifacts (65)

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

Issues

---

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