# Create a Marker

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


Endpoint: POST /1/markers/{datasetSlug}
Version: 1.0.0
Security: configuration_key

## Path parameters:

  - `datasetSlug` (string, required)
    The dataset slug or use  for endpoints that support environment-wide operations.

## Request fields (application/json):

  - `start_time` (integer)
    Indicates the time the Marker should be placed. If missing, defaults to the time the request arrives. Expressed in Unix Time.
    Example: 1471040808

  - `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.
    Example: 1668453920

  - `message` (string)
    A message to describe this specific Marker.
    Example: "backend deploy #123"

  - `type` (string)
    Groups similar Markers. For example, . 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.
    Example: "deploy"

  - `url` (string)
    A target for the marker. Clicking the marker text will take you to this URL.
    Example: "http://link-to-build.here"

## Response 201 fields (application/json):

  - `start_time` (integer)
    Indicates the time the Marker should be placed. If missing, defaults to the time the request arrives. Expressed in Unix Time.
    Example: 1471040808

  - `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.
    Example: 1668453920

  - `message` (string)
    A message to describe this specific Marker.
    Example: "backend deploy #123"

  - `type` (string)
    Groups similar Markers. For example, . 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.
    Example: "deploy"

  - `url` (string)
    A target for the marker. Clicking the marker text will take you to this URL.
    Example: "http://link-to-build.here"

  - `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 401 fields (application/json):

  - `error` (string)

## Response 404 fields (application/json):

  - `error` (string)

## Response 429 fields (application/json):

  - `error` (string)

## Response default fields (application/json):

  - `error` (string)