Skip to content
wanderer Documentation

Suggest merge target or duplicate groups

POST
/api/v1/trail-merge/suggest
 
curl --request POST \
  --url https://example.com/api/v1/trail-merge/suggest \
  --header 'Content-Type: application/json' \
  --data '{ "mode": "manual-selection", "trailIds": [ "example" ], "sourceTrailId": "example" }'

Returns merge target suggestions for manual selection or auto-discovery, or temporary duplicate groups for maintenance workflows.

Request Body required

Section titled “Request Body required ”
Media type application/json
object
mode
required
string
Allowed values: manual-selection auto-discovery maintenance-groups
trailIds

Required for manual-selection

Array<string>
sourceTrailId

Required for auto-discovery

string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Suggestion response

Media type application/json
One of:
object
targetTrailId
required
string
reason
required
string
warnings
required
Array<string>
candidates
required
Array<object>
object
trailId
required
string
score
required
number
reason
required
string
warnings
required
Array<string>
selectable
required
boolean
Example generated
{
  "targetTrailId": "example",
  "reason": "example",
  "warnings": [
    "example"
  ],
  "candidates": [
    {
      "trailId": "example",
      "score": 1,
      "reason": "example",
      "warnings": [
        "example"
      ],
      "selectable": true
    }
  ]
}

400

Section titled “400 ”

Bad Request

Media type application/json
object
message
required
string
code
integer
data
object
Example generated
{
  "message": "example",
  "code": 1,
  "data": {}
}

401

Section titled “401 ”

Unauthorized

Media type application/json
object
message
required
string
code
integer
data
object
Example generated
{
  "message": "example",
  "code": 1,
  "data": {}
}