---
title: "Removes the TimelineAnalysis with the given ID if it exists"
method: DELETE
path: "/timelineAnalysis/{timeline_analysis_id}"
tags: ["timelineAnalysis"]
---

# Removes the TimelineAnalysis with the given ID if it exists

`DELETE /timelineAnalysis/{timeline_analysis_id}`

## Path parameters

- `timeline_analysis_id` integer, required

## Response `200`

Successful Response

- TimelineAnalysisRead
  - `name` string, required — Name of the TimelineAnalysis
  - `timeline_analysis_type` 'document' | 'sentence_annotation' | 'span_annotation' | 'bbox_annotation', required
  - `id` integer, required — ID of the TimelineAnalysis
  - `project_id` integer, required — Project the TimelineAnalysis belongs to
  - `settings` TimelineAnalysisSettings, required
    - `group_by` 'YEAR' | 'MONTH' | 'DAY'
    - `annotation_aggregation_type` 'unit' | 'annotation' | 'document'
    - `date_metadata_id` integer, nullable — ID of the Project Date Metadata that is used for the TimelineAnalysis
  - `concepts` TimelineAnalysisConcept[], required — List of Concepts that are part of the TimelineAnalysis
    - `timeline_analysis_type` 'document' | 'sentence_annotation' | 'span_annotation' | 'bbox_annotation', required
    - `id` string, required — ID of the Concept
    - `name` string, required — Name of the Concept
    - `description` string, required — Description of the Concept
    - `color` string, required — Color of the Concept
    - `visible` boolean, required — Visibility of the Concept
    - `ta_specific_filter` union, required — List of Concepts that are part of the TimelineAnalysis
      - SdocTimelineAnalysisFilterOutput
        - `timeline_analysis_type` 'document', required
        - `filter` FilterSdocColumnsOutput, required
          - `id` string, required — Unique id of this node within the filter tree
          - `items` union[], required — Child expressions and/or nested filter nodes
            - union
              - …
          - `logic_operator` 'or' | 'and', required — This tells our filter how to combine multiple column expressions.
      - SentAnnoTimelineAnalysisFilterOutput
        - `timeline_analysis_type` 'sentence_annotation', required
        - `filter` FilterSentAnnoColumnsOutput, required
          - `id` string, required — Unique id of this node within the filter tree
          - `items` union[], required — Child expressions and/or nested filter nodes
            - union
              - …
          - `logic_operator` 'or' | 'and', required — This tells our filter how to combine multiple column expressions.
      - SpanAnnoTimelineAnalysisFilterOutput
        - `timeline_analysis_type` 'span_annotation', required
        - `filter` FilterSpanColumnsOutput, required
          - `id` string, required — Unique id of this node within the filter tree
          - `items` union[], required — Child expressions and/or nested filter nodes
            - union
              - …
          - `logic_operator` 'or' | 'and', required — This tells our filter how to combine multiple column expressions.
      - BBoxAnnoTimelineAnalysisFilterOutput
        - `timeline_analysis_type` 'bbox_annotation', required
        - `filter` FilterBBoxColumnsOutput, required
          - `id` string, required — Unique id of this node within the filter tree
          - `items` union[], required — Child expressions and/or nested filter nodes
            - union
              - …
          - `logic_operator` 'or' | 'and', required — This tells our filter how to combine multiple column expressions.
    - `filter_hash` integer, required — Hash of the filter to identify changes
    - `results` TimelineAnalysisResult[], required — List of Results of the TimelineAnalysis
      - `date` string, required — The date.
      - `data_ids` integer[], required — The data IDs used for provenance.
      - `count` integer, required — The count / value used for plotting.
  - `created` string, date-time, required — Created timestamp of the TimelineAnalysis
  - `updated` string, date-time, required — Updated timestamp of the TimelineAnalysis

## Other responses

- `422` — Validation Error

## Changes

> 73 revisions in range; 22 could not be searched.

- **2026-07-21** `ebfa22e4da0a` — 4 warning
  - added the new `BB_FOLDER_ID_LIST_RECURSIVE` enum value to the `concepts/items/ta_specific_filter/oneOf[subschema #4: BBoxAnnoTimelineAnalysisFilter]/filter/items/items/anyOf[subschema #1: FilterExpression[BBoxColumns]]/column/anyOf[subschema #1: BBoxColumns]/` response property for the response status `200`
  - added the new `SD_FOLDER_ID_LIST_RECURSIVE` enum value to the `concepts/items/ta_specific_filter/oneOf[subschema #1: SdocTimelineAnalysisFilter]/filter/items/items/anyOf[subschema #1: FilterExpression[SdocColumns]]/column/anyOf[subschema #1: SdocColumns]/` response property for the response status `200`
  - added the new `SP_FOLDER_ID_LIST_RECURSIVE` enum value to the `concepts/items/ta_specific_filter/oneOf[subschema #3: SpanAnnoTimelineAnalysisFilter]/filter/items/items/anyOf[subschema #1: FilterExpression[SpanColumns]]/column/anyOf[subschema #1: SpanColumns]/` response property for the response status `200`
  - added the new `SentAnno_FOLDER_ID_LIST_RECURSIVE` enum value to the `concepts/items/ta_specific_filter/oneOf[subschema #2: SentAnnoTimelineAnalysisFilter]/filter/items/items/anyOf[subschema #1: FilterExpression[SentAnnoColumns]]/column/anyOf[subschema #1: SentAnnoColumns]/` response property for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/uhh-lt/apis/discourse-analysis-tool-suite-api/changes/timelineAnalysis/:timeline_analysis_id/delete.md)

---

[API](https://skmtc.dev/uhh-lt/apis/discourse-analysis-tool-suite-api.md) · [All operations](https://skmtc.dev/uhh-lt/apis/discourse-analysis-tool-suite-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uhh-lt/discourse-analysis-tool-suite-api/revisions/a84d27ef7a0d/schema)