Honeycomb

Honeycomb Markers API

The Honeycomb Markers API enables developers to create and manage markers that indicate points in time on graphs where notable events occurred, such as deploys, configuration changes, or outages. Marker Settings allow grouping similar markers together with consistent visual styling. The API supports listing, creating, updating, and deleting both markers and marker settings, making it straightforward to integrate deployment pipelines and incident workflows with Honeycomb visualizations.

Documentation GitHub OpenAPI

Operations 4

GET /1/markers/{datasetSlug} List all markers #

POST /1/markers/{datasetSlug} Create a marker #

PUT /1/markers/{datasetSlug}/{markerId} Update a marker #

DELETE /1/markers/{datasetSlug}/{markerId} Delete a marker #

Documentation

📖

Documentation

https://api-docs.honeycomb.io/api/marker-settings

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/honeycomb/refs/heads/main/openapi/honeycomb-markers-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/markers-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Honeycomb Auth Markers API
  description: The Honeycomb API is a REST API that provides programmatic access to the Honeycomb observability platform. It enables developers to manage datasets and columns, configure SLOs and burn alerts, set up triggers and recipients, manage boards and markers, administer environments, API keys, and access auth, query annotations, calculated fields, marker settings, reporting, dataset definitions, and service maps.
  version: '1.0'
  contact:
    name: Honeycomb Support
    url: https://support.honeycomb.io
  termsOfService: https://www.honeycomb.io/terms-of-service
servers:
- url: https://api.honeycomb.io
  description: Honeycomb Production API
security:
- ApiKeyAuth: []
tags:
- name: Markers
  description: Manage markers that indicate points in time on graphs where notable events occurred such as deploys or outages.
paths:
  /1/markers/{datasetSlug}:
    get:
      operationId: listMarkers
      summary: List all markers
      description: Returns a list of all markers for the specified dataset.
      tags:
      - Markers
      parameters:
      - $ref: '#/components/parameters/datasetSlug'
      responses:
        '200':
          description: A list of markers
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Marker'
        '401':
          description: Unauthorized
    post:
      operationId: createMarker
      summary: Create a marker
      description: Creates a new marker on the specified dataset to indicate a point in time where a notable event occurred.
      tags:
      - Markers
      parameters:
      - $ref: '#/components/parameters/datasetSlug'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MarkerCreateRequest'
      responses:
        '201':
          description: Marker created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Marker'
        '401':
          description: Unauthorized
  /1/markers/{datasetSlug}/{markerId}:
    put:
      operationId: updateMarker
      summary: Update a marker
      description: Updates a marker's properties.
      tags:
      - Markers
      parameters:
      - $ref: '#/components/parameters/datasetSlug'
      - $ref: '#/components/parameters/markerId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MarkerUpdateRequest'
      responses:
        '200':
          description: Marker updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Marker'
        '401':
          description: Unauthorized
        '404':
          description: Marker not found
    delete:
      operationId: deleteMarker
      summary: Delete a marker
      description: Deletes a marker from the specified dataset.
      tags:
      - Markers
      parameters:
      - $ref: '#/components/parameters/datasetSlug'
      - $ref: '#/components/parameters/markerId'
      responses:
        '204':
          description: Marker deleted
        '401':
          description: Unauthorized
        '404':
          description: Marker not found
components:
  parameters:
    datasetSlug:
      name: datasetSlug
      in: path
      required: true
      description: The slug identifier for the dataset. Dataset names are case insensitive.
      schema:
        type: string
    markerId:
      name: markerId
      in: path
      required: true
      description: The unique identifier for the marker.
      schema:
        type: string
  schemas:
    Marker:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the marker.
        start_time:
          type: integer
          description: Unix timestamp in seconds for when the marker starts.
        end_time:
          type: integer
          description: Unix timestamp in seconds for when the marker ends. If omitted, the marker represents a single point in time.
        message:
          type: string
          description: A message describing the marker event.
        type:
          type: string
          description: The type of the marker, used to group related markers.
        url:
          type: string
          format: uri
          description: A URL associated with the marker event.
        created_at:
          type: string
          format: date-time
          description: ISO8601 formatted time the marker was created.
        updated_at:
          type: string
          format: date-time
          description: ISO8601 formatted time the marker was last updated.
    MarkerUpdateRequest:
      type: object
      properties:
        start_time:
          type: integer
          description: Updated Unix timestamp in seconds for the marker start.
        end_time:
          type: integer
          description: Updated Unix timestamp in seconds for the marker end.
        message:
          type: string
          description: An updated message describing the marker event.
        type:
          type: string
          description: An updated type for the marker.
        url:
          type: string
          format: uri
          description: An updated URL associated with the marker event.
    MarkerCreateRequest:
      type: object
      properties:
        start_time:
          type: integer
          description: Unix timestamp in seconds for the marker start. Defaults to current time if not provided.
        end_time:
          type: integer
          description: Unix timestamp in seconds for the marker end.
        message:
          type: string
          description: A message describing the marker event.
        type:
          type: string
          description: The type of the marker, used to group related markers.
        url:
          type: string
          format: uri
          description: A URL associated with the marker event.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Honeycomb-Team
      description: Honeycomb Configuration API key. Must have appropriate permissions for the endpoint being called.
externalDocs:
  description: Honeycomb API Documentation
  url: https://api-docs.honeycomb.io/api