> ## 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. # UpdateDataset ## OpenAPI ````yaml openapi/api_v1_config_openapi3_DOCUMENTATION_ONLY.json PUT /api/v1/config/datasets/{slug} 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: /api/v1/config/swagger.json 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/datasets/{slug}: put: tags: - Dataset operationId: UpdateDataset parameters: - in: path name: slug required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ConfigV1UpdateDatasetBody' required: true x-originalParamName: body responses: '200': content: application/json: schema: $ref: '#/components/schemas/configv1UpdateDatasetResponse' description: A successful response containing the updated Dataset. '400': content: application/json: schema: $ref: '#/components/schemas/apiError' description: Cannot update the Dataset because the request is invalid. '404': content: application/json: schema: $ref: '#/components/schemas/apiError' description: Cannot update the Dataset because the slug does not exist. '409': content: application/json: schema: $ref: '#/components/schemas/apiError' description: >- Cannot update the Dataset because there is a conflict with an existing Dataset. '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: ConfigV1UpdateDatasetBody: properties: create_if_missing: description: >- If `true`, the Dataset will be created if it does not already exist, identified by `slug`. If `false`, an error will be returned if the Dataset does not already exist. type: boolean dataset: allOf: - $ref: '#/components/schemas/configv1Dataset' description: The Dataset to update. dry_run: description: >- If `true`, validates the specified configuration without creating or updating the Dataset. If the specified configuration is valid, the endpoint returns a partial response without the Dataset. If the specified configuration is invalid, the endpoint returns an error. type: boolean type: object configv1UpdateDatasetResponse: properties: dataset: $ref: '#/components/schemas/configv1Dataset' type: object apiError: properties: message: description: An error message describing what went wrong. type: string type: object genericError: additionalProperties: true type: object configv1Dataset: properties: configuration: allOf: - $ref: '#/components/schemas/DatasetDatasetConfiguration' description: Required. Defines the configuration of the dataset. created_at: description: Timestamp of when the Dataset was created. Cannot be set by clients. format: date-time readOnly: true type: string description: description: Required. Description of the dataset. type: string name: description: >- The name of the Dataset. You can modify this value after the Dataset is created. type: string slug: description: >- The unique identifier of the Dataset. If a `slug` isn't provided, one is generated based on the `name` field. You can't modify this field after the Dataset is created. type: string updated_at: description: >- Timestamp of when the Dataset was last updated. Cannot be set by clients. format: date-time readOnly: true type: string required: - name type: object DatasetDatasetConfiguration: properties: log_dataset: allOf: - $ref: '#/components/schemas/configv1LogDataset' description: >- If the dataset type is `LOGS`, this configuration defines the semantics for the log dataset. trace_dataset: allOf: - $ref: '#/components/schemas/configv1TraceDataset' description: >- If the dataset type is `TRACES`, this configuration defines the semantics for the trace dataset. type: allOf: - $ref: '#/components/schemas/DatasetDatasetType' description: The type of dataset. type: object configv1LogDataset: properties: match_criteria: allOf: - $ref: '#/components/schemas/configv1LogSearchFilter' description: Required. Defines the criteria to match logs to a dataset. type: object configv1TraceDataset: properties: match_criteria: allOf: - $ref: '#/components/schemas/configv1TraceSearchFilter' description: Required. Defines the criteria to match traces to a dataset. type: object DatasetDatasetType: enum: - TRACES - LOGS type: string configv1LogSearchFilter: properties: query: description: >- Returns logs that match this query. The query can include only top-level operations. Nested clauses aren't supported. Only one type of `AND` or `OR` operator is allowed. type: string type: object configv1TraceSearchFilter: properties: scope_filter: allOf: - $ref: '#/components/schemas/TraceSearchFilterScopeFilter' description: >- Scope filter that defines which spans within matching traces contribute to metrics calculation. span: description: >- Specifies the span conditions to match on. All conditions must be true in a single span for the span to be considered a match. If `span_count` is specified, the number of spans within the trace that match span conditions must be within `[min, max]`. You can specify multiple span conditions, and each can be satisfied by any number of spans within the trace. items: $ref: '#/components/schemas/TraceSearchFilterSpanFilter' type: array trace: allOf: - $ref: '#/components/schemas/TraceSearchFilterTraceFilter' description: Trace-level filter criteria (effectively matching the root span). type: object TraceSearchFilterScopeFilter: properties: span_scopes: description: >- Specifies the span filters that define which spans contribute to the metrics calculation. Only spans matching these filters will be included in the metrics aggregation. items: $ref: '#/components/schemas/TraceSearchFilterSpanFilter' type: array type: object TraceSearchFilterSpanFilter: properties: duration: allOf: - $ref: '#/components/schemas/TraceSearchFilterDurationFilter' description: Matches the duration of the candidate span. error: allOf: - $ref: '#/components/schemas/TraceSearchFilterBoolFilter' description: Matches the error status of the candidate span. is_root_span: allOf: - $ref: '#/components/schemas/TraceSearchFilterBoolFilter' description: >- Matches the root span of a trace. For example, if the parent span has no child spans. match_type: allOf: - $ref: '#/components/schemas/SpanFilterSpanFilterMatchType' description: >- If `INCLUDE`, includes all traces that have at least one (or `span_count`) spans matching the query. If `EXCLUDE`, excludes all traces that have at least one (or `span_count`) spans matching the query. operation: allOf: - $ref: '#/components/schemas/TraceSearchFilterStringFilter' description: Matches the operation of the candidate span. parent_operation: allOf: - $ref: '#/components/schemas/TraceSearchFilterStringFilter' description: >- If not a root span, matches the operation of the candidate span's parent span parent_service: allOf: - $ref: '#/components/schemas/TraceSearchFilterStringFilter' description: >- If not a root span, matches the service of the candidate span's parent span. service: allOf: - $ref: '#/components/schemas/TraceSearchFilterStringFilter' description: Matches the service of the candidate span. span_count: allOf: - $ref: '#/components/schemas/TraceSearchFilterCountFilter' description: >- Defines the number of spans that must match the criteria defined by the span query. Defaults to requiring that at least one span matches the span query. tags: description: Matches the tags of the candidate span. items: $ref: '#/components/schemas/TraceSearchFilterTagFilter' type: array type: object TraceSearchFilterTraceFilter: properties: duration: allOf: - $ref: '#/components/schemas/TraceSearchFilterDurationFilter' description: Matches traces based on the duration of the entire trace. error: allOf: - $ref: '#/components/schemas/TraceSearchFilterBoolFilter' description: Matches traces based on the top-level error status. type: object TraceSearchFilterDurationFilter: properties: max_secs: description: Maximum duration, in seconds, required for a span or trace to match. format: double type: number min_secs: description: Minimum duration, in seconds, required for a span or trace to match. format: double type: number type: object TraceSearchFilterBoolFilter: properties: value: description: The value of the filter compared to the target trace or span field. type: boolean type: object SpanFilterSpanFilterMatchType: enum: - INCLUDE - EXCLUDE type: string TraceSearchFilterStringFilter: properties: in_values: description: >- Values the filter tests against when using `IN` or `NOT_IN` match type. items: type: string type: array match: allOf: - $ref: '#/components/schemas/StringFilterStringFilterMatchType' description: >- Specifies the comparison operator for the query. If `EXACT`, compared strings must have the exact value of the query value. value: description: The value of the filter compared to the target trace or span field. type: string type: object TraceSearchFilterCountFilter: properties: max: description: Maximum number of spans that must match a span query, inclusive. format: int32 type: integer min: description: Minimum number of spans that must match a span query, inclusive. format: int32 type: integer type: object TraceSearchFilterTagFilter: properties: key: description: The key or name of the span tag that this filter inspects. type: string numeric_value: allOf: - $ref: '#/components/schemas/TraceSearchFilterNumericFilter' description: >- If the query matches the tag with the specified key, and the value type is `numeric`, specifies the matcher used to evaluate the span tag value. value: allOf: - $ref: '#/components/schemas/TraceSearchFilterStringFilter' description: >- If the query matches the tag with the specified key, and the value type is a `string`, specifies the matcher used to evaluate the span tag value. type: object StringFilterStringFilterMatchType: enum: - EXACT - REGEX - EXACT_NEGATION - REGEX_NEGATION - IN - NOT_IN type: string TraceSearchFilterNumericFilter: properties: comparison: allOf: - $ref: '#/components/schemas/NumericFilterComparisonType' description: >- The comparison operation to apply to an input against the given query value. value: description: The filter value used in comparison against match candidates. format: double type: number type: object NumericFilterComparisonType: enum: - EQUAL - NOT_EQUAL - GREATER_THAN - GREATER_THAN_OR_EQUAL - LESS_THAN - LESS_THAN_OR_EQUAL type: string securitySchemes: ApiKeyAuth: description: Chronosphere API token in: header name: API-Token type: apiKey ````