---
title: "Updates the ConceptOverTimeAnalysis"
method: PATCH
path: "/cota/{cota_id}"
tags: ["conceptOverTimeAnalysis"]
---

# Updates the ConceptOverTimeAnalysis

`PATCH /cota/{cota_id}`

Updates the ConceptOverTimeAnalysis with the given ID if it exists

## Path parameters

- `cota_id` integer, required

## Request body

- COTAUpdate
  - `name` string, nullable — Name of the ConceptOverTimeAnalysis
  - `timeline_settings` COTATimelineSettings
    - `group_by` 'YEAR' | 'MONTH' | 'DAY'
    - `date_metadata_id` integer, nullable — ID of the Project Date Metadata that is used for the ConceptOverTimeAnalysis
    - `threshold` number — Threshold of the ConceptOverTimeAnalysis
  - `training_settings` COTATrainingSettings
    - `search_space_topk` integer — Number of sentences to use as search space per concept.
    - `search_space_threshold` number — Threshold to filter sentences from the search space.
    - `min_required_annotations_per_concept` integer — Minimum number of annotations per concept required to train the CEM.
    - `dimensionality_reduction_algorithm` 'umap' | 'pca' | 'tsne'
    - `layers` integer — Number of layers of the CEM.
    - `dimensions` integer — Number of dimensions of the CEM.
    - `epochs` integer — Number of epochs to train
  - `concepts` COTAConcept[], nullable — List of Concepts that are part of the ConceptOverTimeAnalysis
    - `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

## Response `200`

Successful Response

- COTARead
  - `name` string, required — Name of the ConceptOverTimeAnalysis
  - `id` integer, required — ID of the ConceptOverTimeAnalysis
  - `project_id` integer, required — Project the ConceptOverTimeAnalysis belongs to
  - `last_refinement_job_id` string, nullable, required — ID of the last refinement job for the ConceptOverTimeAnalysis
  - `timeline_settings` COTATimelineSettings, required
    - `group_by` 'YEAR' | 'MONTH' | 'DAY'
    - `date_metadata_id` integer, nullable — ID of the Project Date Metadata that is used for the ConceptOverTimeAnalysis
    - `threshold` number — Threshold of the ConceptOverTimeAnalysis
  - `training_settings` COTATrainingSettings, required
    - `search_space_topk` integer — Number of sentences to use as search space per concept.
    - `search_space_threshold` number — Threshold to filter sentences from the search space.
    - `min_required_annotations_per_concept` integer — Minimum number of annotations per concept required to train the CEM.
    - `dimensionality_reduction_algorithm` 'umap' | 'pca' | 'tsne'
    - `layers` integer — Number of layers of the CEM.
    - `dimensions` integer — Number of dimensions of the CEM.
    - `epochs` integer — Number of epochs to train
  - `concepts` COTAConcept[], required — List of Concepts that are part of the ConceptOverTimeAnalysis
    - `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
  - `search_space` COTASentence[], required — List of Sentences that form the search space of the ConceptOverTimeAnalysis
    - `sentence_id` integer, required — ID of the Sentence in the SDoc
    - `sdoc_id` integer, required — ID of the Sentence Document that contains the Sentence
    - `concept_similarities` object, required — Dictionary of Concept IDs and their similarity score
    - `concept_probabilities` object, required — Dictionary of Concept IDs and their probability score
    - `concept_annotation` string, nullable, required — Concept ID this sentence belongs to
    - `x` number, required — X coordinate of the Sentence in the search space
    - `y` number, required — Y coordinate of the Sentence in the search space
    - `date` string, date-time, required — date of the sdoc
    - `text` string, required — text of the sentence
  - `created` string, date-time, required — Created timestamp of the ConceptOverTimeAnalysis
  - `updated` string, date-time, required — Updated timestamp of the ConceptOverTimeAnalysis

## Other responses

- `422` — Validation Error

---

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