---
title: "Create a Marker"
method: POST
path: "/1/markers/{datasetSlug}"
tags: ["Markers"]
---

# Create a Marker

`POST /1/markers/{datasetSlug}`

Create a Marker in the specified dataset. To create an environment marker, use the `__all__` keyword and an API key associated with the desired environment.

## Request body

- 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.

## Response `201`

Created

- 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)