---
title: "Upload a metric image for an incident"
method: POST
path: "/api/v4/projects/{id}/issues/{issue_iid}/metric_images"
tags: ["metric_images"]
---

# Upload a metric image for an incident

`POST /api/v4/projects/{id}/issues/{issue_iid}/metric_images`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/projects/{id}/issues/{issue_iid}/metric_images`
- Auth: none declared

Uploads a screenshot of metric charts for an incident. Available only for incidents.

## Path parameters

- `id` string, required
- `issue_iid` integer, required

## Request body

- PostApiV4ProjectsIdIssuesIssueIidMetricImages: Upload a metric image for an incident
  - `file` string, binary, required: The image file to be uploaded
  - `url` string: The url to view more metric info
  - `url_text` string: A description of the image or URL

## Response `201`

Upload a metric image for an incident

- APIEntitiesIssuableMetricImage: API_Entities_IssuableMetricImage model
  - `id` integer, required
  - `created_at` string, date-time, required
  - `filename` string, required
  - `file_path` string, required
  - `url` string, required
  - `url_text` string, required

---

[API](https://skmtc.dev/gitlab/apis/gitlab-api.md) - [All operations](https://skmtc.dev/gitlab/apis/gitlab-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitlab/apis/gitlab-api/revisions/b234947ef3f2?raw)