Honeycomb

honeycomb Marker Settings API

Manage marker settings that group similar markers together with consistent visual styling.

GitHub OpenAPI

Operations 4

GET /1/marker_settings/{datasetSlug} List all marker settings #
POST /1/marker_settings/{datasetSlug} Create a marker setting #
PUT /1/marker_settings/{datasetSlug}/{markerSettingId} Update a marker setting #
DELETE /1/marker_settings/{datasetSlug}/{markerSettingId} Delete a marker setting #

Documentation

📖
Documentation
https://api-docs.honeycomb.io/api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/honeycomb/refs/heads/main/openapi/honeycomb-marker-settings-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/honeycomb/refs/heads/main/json-schema/honeycomb-marker-setting-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/honeycomb/refs/heads/main/json-schema/honeycomb-marker-setting-create-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/honeycomb/refs/heads/main/json-schema/honeycomb-marker-setting-update-request-schema.json

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/honeycomb:honeycomb-marker-settings-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

honeycomb-marker-settings-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Honeycomb Marker Settings 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: Marker Settings
  description: Manage marker settings that group similar markers together with consistent visual styling.
paths:
  /1/marker_settings/{datasetSlug}:
    get:
      operationId: listMarkerSettings
      summary: List all marker settings
      description: Returns a list of all marker settings for the specified dataset.
      tags:
      - Marker Settings
      parameters:
      - $ref: '#/components/parameters/datasetSlug'
      responses:
        '200':
          description: A list of marker settings
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MarkerSetting'
        '401':
          description: Unauthorized
    post:
      operationId: createMarkerSetting
      summary: Create a marker setting
      description: Creates a new marker setting that groups similar markers together with consistent visual styling.
      tags:
      - Marker Settings
      parameters:
      - $ref: '#/components/parameters/datasetSlug'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MarkerSettingCreateRequest'
      responses:
        '201':
          description: Marker setting created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarkerSetting'
        '401':
          description: Unauthorized
  /1/marker_settings/{datasetSlug}/{markerSettingId}:
    put:
      operationId: updateMarkerSetting
      summary: Update a marker setting
      description: Updates a marker setting's properties.
      tags:
      - Marker Settings
      parameters:
      - $ref: '#/components/parameters/datasetSlug'
      - $ref: '#/components/parameters/markerSettingId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MarkerSettingUpdateRequest'
      responses:
        '200':
          description: Marker setting updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarkerSetting'
        '401':
          description: Unauthorized
        '404':
          description: Marker setting not found
    delete:
      operationId: deleteMarkerSetting
      summary: Delete a marker setting
      description: Deletes a marker setting from the specified dataset.
      tags:
      - Marker Settings
      parameters:
      - $ref: '#/components/parameters/datasetSlug'
      - $ref: '#/components/parameters/markerSettingId'
      responses:
        '204':
          description: Marker setting deleted
        '401':
          description: Unauthorized
        '404':
          description: Marker setting not found
components:
  schemas:
    MarkerSettingUpdateRequest:
      type: object
      properties:
        type:
          type: string
          description: An updated marker type.
        color:
          type: string
          description: An updated color for the marker setting.
    MarkerSettingCreateRequest:
      type: object
      required:
      - type
      properties:
        type:
          type: string
          description: The marker type this setting applies to.
        color:
          type: string
          description: The color used to display markers of this type.
    MarkerSetting:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the marker setting.
        type:
          type: string
          description: The marker type this setting applies to.
        color:
          type: string
          description: The color used to display markers of this type.
        created_at:
          type: string
          format: date-time
          description: ISO8601 formatted time the marker setting was created.
        updated_at:
          type: string
          format: date-time
          description: ISO8601 formatted time the marker setting was last updated.
  parameters:
    datasetSlug:
      name: datasetSlug
      in: path
      required: true
      description: The slug identifier for the dataset. Dataset names are case insensitive.
      schema:
        type: string
    markerSettingId:
      name: markerSettingId
      in: path
      required: true
      description: The unique identifier for the marker setting.
      schema:
        type: string
  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