---
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

## Changes

- **2026-07-15** `1af5a8046f20` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2025-09-10** `fe127c9a2bea` — 1 breaking, 1 info
  - added the new required request property `tag_id`
  - added the required property `input/tag_id` to the response with the `200` status
- **2025-08-22** `53e769440a25` — 1 breaking, 3 warning
  - removed the required property `input/tag_id` from the response with the `200` status
  - removed the request property `tag_id`
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status

[Change history](https://skmtc.dev/uhh-lt/apis/discourse-analysis-tool-suite-api/changes/job/duplicate_finder/post.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/4c6052711f99/schema)