# Create a Marker Setting

Endpoint: POST /1/marker_settings/{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):

  - `type` (string, required)
    Groups similar Markers. For example, 'deploys'. All Markers of the same type appears with the same color on the graph.
    Example: "deploy"

  - `color` (string, required)
    Color to use for display of this marker type. Specified as hexadecimal RGB. For example, "#F96E11".
    Example: "#7b1fa2"

## Response 201 fields (application/json):

  - `type` (string, required)
    Groups similar Markers. For example, 'deploys'. All Markers of the same type appears with the same color on the graph.
    Example: "deploy"

  - `color` (string, required)
    Color to use for display of this marker type. Specified as hexadecimal RGB. For example, "#F96E11".
    Example: "#7b1fa2"

  - `id` (string)
    The unique identifier (ID) for the Marker Setting.
    Example: "gwAHiE5TS4j"

  - `created_at` (string)
    The ISO8601-formatted time when the Marker Setting was created.
    Example: "2022-09-15T05:39:42Z"

  - `updated_at` (null,string)
    The ISO8601-formatted time when the Marker Setting was updated.
    Example: "2022-12-15T04:25:14Z"

## Response 404 fields (application/json):

  - `error` (string)

## Response 422 fields (application/problem+json):

  - `error` (string, required)

  - `status` (number, required)
    The HTTP status code of the error.

  - `type` (string, required)
    Type is a URI used to uniquely identify the type of error.

  - `title` (string, required)
    Title is a human-readable summary that explains the  of the problem.

  - `detail` (string)
    The general, human-readable error message.

  - `instance` (string)
    The unique identifier (ID) for this specific error.

  - `type_detail` (array)

  - `type_detail.field` (string)

  - `type_detail.code` (string)
    Enum: "invalid", "missing", "incorrect_type", "already_exists"

  - `type_detail.description` (string)

## Response 429 fields (application/json):

  - `error` (string)