Get All Person Merge Tasks
Changed onRetrieve paginated person merge tasks for the organization.
Returns all merge tasks initiated by users in your organization, including their current status, the persons involved, and task details.
You can filter tasks using the filter query parameter. The filter parameter is a string that you can specify conditions based on the following properties:
| Property Name | Type | Allowed Operators | Examples |
|---|---|---|---|
| status | enum | = | status=in-progress, status=success, status=failed |
Tasks are returned in reverse chronological order (most recent first).
Requires the "Manage duplicates" permission and organization admin role.
Request
- Base URLhttps://api.affinity.co
- URLhttps://api.affinity.co/v2/tasks/person-merges
- AuthHTTP bearer
Query parameters
Cursor for the next or previous page
Number of items to include in the page
Filter tasks using Affinity Filtering Language
Response
OK
Example response
{
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"status": "success",
"resultsSummary": {
"total": 1,
"inProgress": 0,
"success": 1,
"failed": 0
}
},
{
"id": "456e7890-e12b-34c5-d678-901234567890",
"status": "failed",
"resultsSummary": {
"total": 1,
"inProgress": 0,
"success": 0,
"failed": 1
}
}
],
"pagination": {
"prevUrl": "https://api.affinity.co/v2/foo?cursor=ICAgICAgYmVmb3JlOjo6Nw",
"nextUrl": "https://api.affinity.co/v2/foo?cursor=ICAgICAgIGFmdGVyOjo6NA"
}
}Changes
- info
added
authenticationauthorizationbad-requestconflictmethod-not-allowednot-acceptablenot-foundnot-implementedrate-limitservertimeoutunprocessable-entityunsupported-media-typevalidationdiscriminator mapping keys to the/response property for the response status - info
added
bad-requestvalidationdiscriminator mapping keys to the/response property for the response status
- info