> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chronosphere.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ReadTraceBehaviorConfig



## OpenAPI

````yaml openapi/api_v1_config_openapi3_DOCUMENTATION_ONLY.json GET /api/v1/config/trace-behavior-config
openapi: 3.0.3
info:
  description: >

    The Config API provides standard HTTP/JSON REST endpoints for creating,
    reading,

    updating, deleting, and listing configurable Chronosphere resources.


    Use this link to download the raw Swagger specification:

    <a href="/api/v1/config/swagger.json">/api/v1/config/swagger.json</a>
  title: Config V1 API
  version: v1
servers:
  - url: https://{tenant}.chronosphere.io
    variables:
      tenant:
        default: tenant
        description: tenant ID assigned by the service provider
security:
  - ApiKeyAuth: []
tags:
  - name: ConfigV1
paths:
  /api/v1/config/trace-behavior-config:
    get:
      tags:
        - TraceBehaviorConfig
      operationId: ReadTraceBehaviorConfig
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/configv1ReadTraceBehaviorConfigResponse'
          description: A successful response.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
          description: >-
            Cannot read the TraceBehaviorConfig because TraceBehaviorConfig has
            not been created.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
          description: An unexpected error response.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/genericError'
          description: An undefined error response.
components:
  schemas:
    configv1ReadTraceBehaviorConfigResponse:
      properties:
        trace_behavior_config:
          $ref: '#/components/schemas/configv1TraceBehaviorConfig'
      type: object
    apiError:
      properties:
        message:
          description: An error message describing what went wrong.
          type: string
      type: object
    genericError:
      additionalProperties: true
      type: object
    configv1TraceBehaviorConfig:
      description: >-
        TraceBehaviorConfig is a singleton configuration object that specifies
        the

        configuration for trace behaviors.
      properties:
        baseline_behavior_slug:
          description: >-
            The baseline behavior to use for behavior assignments and base head
            sampling rates.
          type: string
        created_at:
          description: >-
            Timestamp of when the TraceBehaviorConfig was created. Cannot be set
            by clients.
          format: date-time
          readOnly: true
          type: string
        dataset_priorities:
          description: >-
            List of dataset priorities. This list specifies the order in which
            datasets are

            considered when determining the behavior to follow for a trace.
            Dataset

            priorities are used to break ties when a trace matches more than one
            dataset

            with an active behavior.

            * Each entry in this list must refer to the slug of an existing
            dataset.

            * The order of the list is the order in which the datasets are
            considered.

            * The list must contain all datasets referenced in either
              `main_behavior_assignments` or `override_behavior_assignments`.
            * The list can contain datasets that are not referenced in either of
            these
              assignments.
          items:
            type: string
          type: array
        main_behavior_assignments:
          description: >-
            List of assignments for the main behavior. The referenced datasets
            will be

            enrolled in behaviors. The referenced behaviors are the active
            behaviors for the

            dataset when there is no active override. Only one main behavior can
            be assigned

            to a dataset. See the documentation for

            [customizing your sampling

            strategy](https://docs.chronosphere.io/control/sampling/behaviors#customize-your-sampling-strategy)

            for more information.
          items:
            $ref: '#/components/schemas/TraceBehaviorConfigMainBehaviorAssignment'
          type: array
        override_behavior_assignments:
          description: >-
            List of assignments for the override behavior. These assignments
            specify the

            active behavior for a dataset over a specific time range. Only one
            override

            behavior can be assigned to a dataset.
          items:
            $ref: '#/components/schemas/TraceBehaviorConfigOverrideBehaviorAssignment'
          type: array
        preview_behavior_assignments:
          description: >-
            List of assignments for the preview behavior. The referenced
            behaviors are in

            preview mode for the assigned dataset. You can assign only one
            preview behavior

            to a dataset.
          items:
            $ref: '#/components/schemas/TraceBehaviorConfigOverrideBehaviorAssignment'
          type: array
        updated_at:
          description: >-
            Timestamp of when the TraceBehaviorConfig was last updated. Cannot
            be set by clients.
          format: date-time
          readOnly: true
          type: string
      type: object
    TraceBehaviorConfigMainBehaviorAssignment:
      properties:
        behavior_slug:
          description: The slug reference of a trace behavior.
          type: string
        created_at:
          description: The timestamp of when the trace behavior was created.
          format: date-time
          type: string
        created_by:
          description: The author or creator of the behavior assignment.
          type: string
        dataset_slug:
          description: The slug reference of a trace dataset.
          type: string
        description:
          description: A description of the behavior assignment.
          type: string
        updated_at:
          description: The timestamp of when the trace behavior was updated.
          format: date-time
          type: string
      type: object
    TraceBehaviorConfigOverrideBehaviorAssignment:
      properties:
        behavior_slug:
          description: The slug reference of a trace behavior.
          type: string
        created_at:
          description: The timestamp of when the override behavior assignment was created.
          format: date-time
          type: string
        created_by:
          description: The author or creator of the override.
          type: string
        dataset_slug:
          description: The slug reference of a trace dataset.
          type: string
        description:
          description: A description of the override.
          type: string
        end_time:
          description: The ending time of the override.
          format: date-time
          type: string
        start_time:
          description: The starting time of the override.
          format: date-time
          type: string
        updated_at:
          description: The timestamp of when the override behavior assignment was updated.
          format: date-time
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: Chronosphere API token
      in: header
      name: API-Token
      type: apiKey

````