---
title: "Get all Dataset Definitions"
method: GET
path: "/1/dataset_definitions/{datasetSlug}"
tags: ["Dataset Definitions"]
---

# Get all Dataset Definitions

`GET /1/dataset_definitions/{datasetSlug}`

Get all definitions for a Dataset.
The response returns an object with a Dataset Definition for each set Dataset Definition type.

## Response `200`

Success

- DatasetDefinitions — Dataset Definitions describe the fields with special meaning in the Dataset.
  - `span_id` DatasetDefinition, nullable
    - `name` string, required — The name of the Column or of the Calculated Field (also called Derived Column) to map to this Dataset Definition Type. An empty string clears the mapping, potentially reverting to a default mapping.
    - `column_type` 'column' | 'derived_column' — Optional: `column` for regular columns and `derived_column` for Calculated Fields (also called Derived Columns) when setting Dataset Definitions. Honeycomb does not use this field when updating Dataset definitions.
  - `trace_id` DatasetDefinition, nullable
    - `name` string, required — The name of the Column or of the Calculated Field (also called Derived Column) to map to this Dataset Definition Type. An empty string clears the mapping, potentially reverting to a default mapping.
    - `column_type` 'column' | 'derived_column' — Optional: `column` for regular columns and `derived_column` for Calculated Fields (also called Derived Columns) when setting Dataset Definitions. Honeycomb does not use this field when updating Dataset definitions.
  - `parent_id` DatasetDefinition, nullable
    - `name` string, required — The name of the Column or of the Calculated Field (also called Derived Column) to map to this Dataset Definition Type. An empty string clears the mapping, potentially reverting to a default mapping.
    - `column_type` 'column' | 'derived_column' — Optional: `column` for regular columns and `derived_column` for Calculated Fields (also called Derived Columns) when setting Dataset Definitions. Honeycomb does not use this field when updating Dataset definitions.
  - `name` DatasetDefinition, nullable
    - `name` string, required — The name of the Column or of the Calculated Field (also called Derived Column) to map to this Dataset Definition Type. An empty string clears the mapping, potentially reverting to a default mapping.
    - `column_type` 'column' | 'derived_column' — Optional: `column` for regular columns and `derived_column` for Calculated Fields (also called Derived Columns) when setting Dataset Definitions. Honeycomb does not use this field when updating Dataset definitions.
  - `service_name` DatasetDefinition, nullable
    - `name` string, required — The name of the Column or of the Calculated Field (also called Derived Column) to map to this Dataset Definition Type. An empty string clears the mapping, potentially reverting to a default mapping.
    - `column_type` 'column' | 'derived_column' — Optional: `column` for regular columns and `derived_column` for Calculated Fields (also called Derived Columns) when setting Dataset Definitions. Honeycomb does not use this field when updating Dataset definitions.
  - `duration_ms` DatasetDefinition, nullable
    - `name` string, required — The name of the Column or of the Calculated Field (also called Derived Column) to map to this Dataset Definition Type. An empty string clears the mapping, potentially reverting to a default mapping.
    - `column_type` 'column' | 'derived_column' — Optional: `column` for regular columns and `derived_column` for Calculated Fields (also called Derived Columns) when setting Dataset Definitions. Honeycomb does not use this field when updating Dataset definitions.
  - `span_kind` DatasetDefinition, nullable
    - `name` string, required — The name of the Column or of the Calculated Field (also called Derived Column) to map to this Dataset Definition Type. An empty string clears the mapping, potentially reverting to a default mapping.
    - `column_type` 'column' | 'derived_column' — Optional: `column` for regular columns and `derived_column` for Calculated Fields (also called Derived Columns) when setting Dataset Definitions. Honeycomb does not use this field when updating Dataset definitions.
  - `annotation_type` DatasetDefinition, nullable
    - `name` string, required — The name of the Column or of the Calculated Field (also called Derived Column) to map to this Dataset Definition Type. An empty string clears the mapping, potentially reverting to a default mapping.
    - `column_type` 'column' | 'derived_column' — Optional: `column` for regular columns and `derived_column` for Calculated Fields (also called Derived Columns) when setting Dataset Definitions. Honeycomb does not use this field when updating Dataset definitions.
  - `link_span_id` DatasetDefinition, nullable
    - `name` string, required — The name of the Column or of the Calculated Field (also called Derived Column) to map to this Dataset Definition Type. An empty string clears the mapping, potentially reverting to a default mapping.
    - `column_type` 'column' | 'derived_column' — Optional: `column` for regular columns and `derived_column` for Calculated Fields (also called Derived Columns) when setting Dataset Definitions. Honeycomb does not use this field when updating Dataset definitions.
  - `link_trace_id` DatasetDefinition, nullable
    - `name` string, required — The name of the Column or of the Calculated Field (also called Derived Column) to map to this Dataset Definition Type. An empty string clears the mapping, potentially reverting to a default mapping.
    - `column_type` 'column' | 'derived_column' — Optional: `column` for regular columns and `derived_column` for Calculated Fields (also called Derived Columns) when setting Dataset Definitions. Honeycomb does not use this field when updating Dataset definitions.
  - `error` DatasetDefinition, nullable
    - `name` string, required — The name of the Column or of the Calculated Field (also called Derived Column) to map to this Dataset Definition Type. An empty string clears the mapping, potentially reverting to a default mapping.
    - `column_type` 'column' | 'derived_column' — Optional: `column` for regular columns and `derived_column` for Calculated Fields (also called Derived Columns) when setting Dataset Definitions. Honeycomb does not use this field when updating Dataset definitions.
  - `status` DatasetDefinition, nullable
    - `name` string, required — The name of the Column or of the Calculated Field (also called Derived Column) to map to this Dataset Definition Type. An empty string clears the mapping, potentially reverting to a default mapping.
    - `column_type` 'column' | 'derived_column' — Optional: `column` for regular columns and `derived_column` for Calculated Fields (also called Derived Columns) when setting Dataset Definitions. Honeycomb does not use this field when updating Dataset definitions.
  - `route` DatasetDefinition, nullable
    - `name` string, required — The name of the Column or of the Calculated Field (also called Derived Column) to map to this Dataset Definition Type. An empty string clears the mapping, potentially reverting to a default mapping.
    - `column_type` 'column' | 'derived_column' — Optional: `column` for regular columns and `derived_column` for Calculated Fields (also called Derived Columns) when setting Dataset Definitions. Honeycomb does not use this field when updating Dataset definitions.
  - `user` DatasetDefinition, nullable
    - `name` string, required — The name of the Column or of the Calculated Field (also called Derived Column) to map to this Dataset Definition Type. An empty string clears the mapping, potentially reverting to a default mapping.
    - `column_type` 'column' | 'derived_column' — Optional: `column` for regular columns and `derived_column` for Calculated Fields (also called Derived Columns) when setting Dataset Definitions. Honeycomb does not use this field when updating Dataset definitions.
  - `log_severity` DatasetDefinition, nullable
    - `name` string, required — The name of the Column or of the Calculated Field (also called Derived Column) to map to this Dataset Definition Type. An empty string clears the mapping, potentially reverting to a default mapping.
    - `column_type` 'column' | 'derived_column' — Optional: `column` for regular columns and `derived_column` for Calculated Fields (also called Derived Columns) when setting Dataset Definitions. Honeycomb does not use this field when updating Dataset definitions.
  - `log_message` DatasetDefinition, nullable
    - `name` string, required — The name of the Column or of the Calculated Field (also called Derived Column) to map to this Dataset Definition Type. An empty string clears the mapping, potentially reverting to a default mapping.
    - `column_type` 'column' | 'derived_column' — Optional: `column` for regular columns and `derived_column` for Calculated Fields (also called Derived Columns) when setting Dataset Definitions. Honeycomb does not use this field when updating Dataset definitions.

## Other responses

- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/honeycomb/apis/honeycomb-api.md) · [All operations](https://skmtc.net/honeycomb/apis/honeycomb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/honeycomb/honeycomb-api/revisions/117619fac2a5/schema)
