Skip to main content

List duplicate candidates

GET/api/projects/{projectId}/duplicate-candidates
Signed-in memberRead-only

Read the guideSource: ChangeApiController#duplicates(opens in new tab)

Path parameters​

NameTypeRequiredNotes
projectIdstring (uuid)Required

Query parameters​

NameTypeRequiredNotes
statusenum DuplicateCandidateStatusOptionalOPENCONFIRMEDDISMISSED

Response​

Success: 200

An array of DuplicateCandidateView, each with:

FieldTypeRequiredNotes
idstring (uuid)Optional
changeIdstring (uuid)Optional
changePullRequestNumberintegerOptional
changeTitlestringOptional
changeWhatChangedstringOptional
duplicateOfIdstring (uuid)Optional
duplicateOfPullRequestNumberintegerOptional
duplicateOfTitlestringOptional
duplicateOfWhatChangedstringOptional
similaritynumberOptional
evidenceDuplicateEvidenceOptional
evidence.titlenumberOptional
evidence.contentnumberOptional
evidence.pathsnumberOptional
statusenum DuplicateCandidateStatusOptionalOPENCONFIRMEDDISMISSED
deciderNamestringOptional
createdAtstring (date-time)Optional
decidedAtstring (date-time)Optional

Errors​

StatusCodeApplies to
400validation_faileda field is missing or out of rangeAny endpoint
400invalid_parametera path or query parameter is missing or does not convert, such as an ID that is not a UUIDAny endpoint
401authentication_requiredno sessionAny endpoint
404not_foundno such addressAny endpoint
405method_not_allowedthe address does not take that methodAny endpoint
415unsupported_media_typethe address does not read a body of that typeAny endpoint
500internal_errora fault ReleaseFlow did not foresee; the body never carries the exception behind itAny endpoint
400invalid_change_filterChanges area
400invalid_change_reviewChanges area
400invalid_sensitive_pathsChanges area
404change_not_foundChanges area
404duplicate_candidate_not_foundChanges area
409change_processingChanges area
409change_not_eligible_for_aiChanges area
409duplicate_candidate_decidedChanges area
409change_excludedChanges area
409change_in_releaseChanges area
502ai_classification_failedChanges area
503ai_classification_unavailableChanges area
404category_not_foundCategories area
404category_suggestion_not_foundCategories area
409category_code_takenCategories area
409category_systemCategories area
409category_suggestion_decidedCategories area

Request

bash
# Sign in first and keep the session cookie in cookies.txt (see Sessions and CSRF).
curl "http://localhost:8080/api/projects/$PROJECT_ID/duplicate-candidates" \
-b cookies.txt -c cookies.txt

Response

200

Example

[
  {
    "id": "<uuid>",
    "changeId": "<uuid>",
    "changePullRequestNumber": 0,
    "changeTitle": "<string>",
    "changeWhatChanged": "<string>",
    "duplicateOfId": "<uuid>",
    "duplicateOfPullRequestNumber": 0,
    "duplicateOfTitle": "<string>",
    "duplicateOfWhatChanged": "<string>",
    "similarity": 0,
    "evidence": {
      "title": 0,
      "content": 0,
      "paths": 0
    },
    "status": "OPEN",
    "deciderName": "<string>",
    "createdAt": "<date-time>",
    "decidedAt": "<date-time>"
  }
]