{"openapi":"3.1.0","info":{"title":"Honeycomb (BYOK) API","version":"0.1.0","description":"Honeycomb (BYOK) lets an AI assistant read your own Honeycomb data through the Honeycomb API with a key you supply (Honeycomb configuration API key (US data center)). Read-only: 9 tools (get_key_info, list_datasets, get_dataset, list_columns, list_markers, list_triggers, list_slos, list_boards, list_calculated_fields). The BYOK key travels with each request, is used for that one call only and is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-honeycomb.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-honeycomb/docs"},"termsOfService":"https://connectorbay.com/byok-honeycomb/terms"},"servers":[{"url":"https://byok-honeycomb.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-honeycomb/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_key_info":{"post":{"operationId":"get_key_info","summary":"Show what the API key is: its type, the environment and team it belongs to, and which permissions (events, markers, trig","description":"Show what the API key is: its type, the environment and team it belongs to, and which permissions (events, markers, triggers, boards, queries, columns, SLOs) it has. Use for \"What can my Honeycomb API key do and which environment is it for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_key_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_datasets":{"post":{"operationId":"list_datasets","summary":"List the datasets of the key's environment with name, slug, description, column count and last write time. Use for \"Whic","description":"List the datasets of the key's environment with name, slug, description, column count and last write time. Use for \"Which Honeycomb datasets do I have and when was each last written to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_datasetsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_dataset":{"post":{"operationId":"get_dataset","summary":"Get one dataset by slug: name, description, column count, last write time and delete protection. Use for \"When did Honey","description":"Get one dataset by slug: name, description, column count, last write time and delete protection. Use for \"When did Honeycomb dataset my-service last receive events\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dataset_slug":{"description":"Slug of the dataset (see list_datasets), for example 'my-service'; '__all__' means all datasets of the environment where the API allows it.","maxLength":100,"title":"Dataset Slug","type":"string"}},"required":["dataset_slug"],"title":"get_datasetArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_columns":{"post":{"operationId":"list_columns","summary":"List the columns (fields) of a dataset with key name, type, description, hidden flag and last written time. Use for \"Whi","description":"List the columns (fields) of a dataset with key name, type, description, hidden flag and last written time. Use for \"Which columns does Honeycomb dataset my-service have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dataset_slug":{"description":"Slug of the dataset (see list_datasets), for example 'my-service'; '__all__' means all datasets of the environment where the API allows it.","maxLength":100,"title":"Dataset Slug","type":"string"},"key_name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only the column with exactly this key name.","title":"Key Name"}},"required":["dataset_slug"],"title":"list_columnsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_markers":{"post":{"operationId":"list_markers","summary":"List markers (deploys, incidents and other annotations on the timeline) of a dataset with start and end time (Unix secon","description":"List markers (deploys, incidents and other annotations on the timeline) of a dataset with start and end time (Unix seconds), message, type and URL. Use for \"Which deploy markers does Honeycomb dataset my-service have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dataset_slug":{"description":"Slug of the dataset (see list_datasets), for example 'my-service'; '__all__' means all datasets of the environment where the API allows it.","maxLength":100,"title":"Dataset Slug","type":"string"}},"required":["dataset_slug"],"title":"list_markersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_triggers":{"post":{"operationId":"list_triggers","summary":"List the triggers (alerts) of a dataset with name, description, threshold, frequency, alert type, and whether each is di","description":"List the triggers (alerts) of a dataset with name, description, threshold, frequency, alert type, and whether each is disabled or currently triggered. Recipients are not returned. Use for \"Which Honeycomb triggers are currently firing on my-service\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dataset_slug":{"description":"Slug of the dataset (see list_datasets), for example 'my-service'; '__all__' means all datasets of the environment where the API allows it.","maxLength":100,"title":"Dataset Slug","type":"string"}},"required":["dataset_slug"],"title":"list_triggersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_slos":{"post":{"operationId":"list_slos","summary":"List the service level objectives (SLOs) of a dataset with name, description, time period in days, target per million an","description":"List the service level objectives (SLOs) of a dataset with name, description, time period in days, target per million and tags. Use for \"Which SLOs are defined on Honeycomb dataset my-service\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dataset_slug":{"description":"Slug of the dataset (see list_datasets), for example 'my-service'; '__all__' means all datasets of the environment where the API allows it.","maxLength":100,"title":"Dataset Slug","type":"string"}},"required":["dataset_slug"],"title":"list_slosArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_boards":{"post":{"operationId":"list_boards","summary":"List the boards of the environment with name, description, type and tags. Panel contents are not returned. Use for \"Whic","description":"List the boards of the environment with name, description, type and tags. Panel contents are not returned. Use for \"Which Honeycomb boards exist in my environment\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_boardsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_calculated_fields":{"post":{"operationId":"list_calculated_fields","summary":"List the calculated fields (derived columns) of a dataset with alias, expression and description. Use for \"Which calcula","description":"List the calculated fields (derived columns) of a dataset with alias, expression and description. Use for \"Which calculated fields does Honeycomb dataset my-service define\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dataset_slug":{"description":"Slug of the dataset (see list_datasets), for example 'my-service'; '__all__' means all datasets of the environment where the API allows it.","maxLength":100,"title":"Dataset Slug","type":"string"},"alias":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only the calculated field with exactly this alias.","title":"Alias"}},"required":["dataset_slug"],"title":"list_calculated_fieldsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}