---
title: "Webhook Handler"
method: POST
path: "COTA_UPDATED"
---

# Webhook Handler

`POST COTA_UPDATED` (webhook)

## Acknowledgement `200`

Successful Response

- CotaUpdatedEvent
  - `type` 'COTA_UPDATED'
  - `payload` COTARead, required
    - `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, 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

---

[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.dev/uhh-lt/apis/discourse-analysis-tool-suite-api/revisions/c68c19b13069?raw)