---
title: "Start DuplicateFinder job"
method: POST
path: "/job/duplicate_finder"
tags: ["job"]
---

# Start DuplicateFinder job

`POST /job/duplicate_finder`

## Request body

- DuplicateFinderInput
  - `project_id` integer, required — Project ID associated with the job
  - `max_different_words` integer, required — Number of different words allowed between duplicates
  - `tag_id` integer, nullable, required — Tag id to filter source documents. If not provided, all source documents are considered.

## Response `200`

Successful Response

- DuplicateFinderJobRead
  - `job_id` string, required — RQ job ID
  - `job_type` string, required — Type of the job
  - `project_id` integer, required — Project ID associated with the job
  - `status` 'queued' | 'finished' | 'failed' | 'started' | 'deferred' | 'scheduled' | 'stopped' | 'canceled', required
  - `status_message` string, nullable — Status message
  - `current_step` integer, required — Current step in the job process
  - `steps` string[], required — Total number of steps in the job process
  - `input` DuplicateFinderInput, required
    - `project_id` integer, required — Project ID associated with the job
    - `max_different_words` integer, required — Number of different words allowed between duplicates
    - `tag_id` integer, nullable, required — Tag id to filter source documents. If not provided, all source documents are considered.
  - `output` DuplicateFinderOutput
    - `duplicates` array[], required — List of found duplicate clusters
      - integer[]
  - `created` string, date-time, required — Created timestamp of the job
  - `finished` string, date-time, nullable — Finished timestamp of the job

## 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/revisions/6b22366ce2d1/schema)