---
title: "Delete a Marker"
method: DELETE
path: "/1/markers/{datasetSlug}/{markerId}"
tags: ["Markers"]
---

# Delete a Marker

`DELETE /1/markers/{datasetSlug}/{markerId}`

## Response `200`

Success
The deleted Marker will be in the body of the response.

- Marker
  - `start_time` integer — Indicates the time the Marker should be placed. If missing, defaults to the time the request arrives. Expressed in Unix Time.
  - `end_time` integer — Specifies end time, and allows a Marker to be recorded as representing a time range, such as a 5 minute deploy. Expressed in Unix Time.
  - `message` string — A message to describe this specific Marker.
  - `type` string — Groups similar Markers. For example, `deploys`. All Markers of the same type appear with the same color on the graph. Refer to the [Marker Settings](/api/marker-settings/) API for altering the color of each type.
  - `url` string — A target for the marker. Clicking the marker text will take you to this URL.
  - `id` string — A 6 character hexadecimal string assigned on Marker creation.
  - `created_at` string — The ISO8601-formatted time when the Marker was created.
  - `updated_at` string — The ISO8601-formatted time when the Marker was updated.
  - `color` string — Color can be assigned to Markers using the Marker Settings endpoint. This field will be populated when List All Markers is called.

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `429` — Rate Limit Exceeded
- `default` — Error

---

[API](https://skmtc.net/honeycomb/apis/honeycomb-api.md) · [All operations](https://skmtc.net/honeycomb/apis/honeycomb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/honeycomb/honeycomb-api/revisions/117619fac2a5/schema)