---
updatedAt: 2026-05-06T16:58:26.000Z
agentTools:
  projectIndex: https://cloud.docs.tamr.com/llms.txt
---

# apply item

Apply an action to resolve a queue item (e.g., merge records, apply edit).

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Queues",
    "version": "v1alpha2"
  },
  "tags": [
    {
      "name": "tamr.api.queues.v1alpha2.Queues"
    }
  ],
  "paths": {
    "/api/v1alpha2/projects/{projectId}/queues/{queueId}/items/{itemId}:apply": {
      "post": {
        "summary": "apply item",
        "description": "Apply an action to resolve a queue item (e.g., merge records, apply edit).",
        "operationId": "Queues_ApplyQueueItem",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.QueueItem"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "projectId",
            "description": "Required. The project the item belongs to.",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "queueId",
            "description": "Required. The queue the item belongs to.",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "itemId",
            "description": "Required. The item to perform the action on.",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.Queues.ApplyQueueItemBody"
              }
            }
          },
          "required": true
        },
        "tags": [
          "tamr.api.queues.v1alpha2.Queues"
        ]
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "X-API-KEY",
        "value": "example-api-key"
      }
    ]
  },
  "servers": [
    {
      "url": "https://api-examples.tamr.cloud"
    }
  ],
  "components": {
    "schemas": {
      "tamr.api.queues.v1alpha2.ActionResult": {
        "type": "object",
        "properties": {
          "resultRecordId": {
            "type": "string",
            "description": "Output only. The resulting record ID after the action.",
            "readOnly": true
          },
          "resultVersionId": {
            "type": "string",
            "format": "int64",
            "description": "Output only. The resulting record version after the action.",
            "readOnly": true
          },
          "resultData": {
            "type": "object",
            "description": "Output only. The resulting record data after the action.",
            "readOnly": true
          }
        }
      },
      "tamr.api.queues.v1alpha2.ApplyEdit": {
        "type": "object",
        "properties": {
          "tableId": {
            "type": "string",
            "description": "Required. The table containing the record."
          },
          "recordId": {
            "type": "string",
            "description": "Required. The record ID to edit."
          },
          "expectedVersionId": {
            "type": "string",
            "format": "int64",
            "description": "Required. The expected record version. Action will fail if the record has been updated."
          },
          "updateData": {
            "type": "object",
            "description": "Required. The data to update."
          }
        },
        "required": [
          "tableId",
          "recordId",
          "expectedVersionId",
          "updateData"
        ]
      },
      "tamr.api.queues.v1alpha2.ClassificationSignal": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "title": "implementation-defined; for example: \"keyword\", \"brand\", \"supplier\", \"similar\", \"rule\""
          },
          "text": {
            "type": "string",
            "description": "Human-readable description of the signal."
          }
        },
        "description": "A single piece of evidence the classifier surfaced for a suggestion\n(e.g., keyword match, brand match, supplier, similar-record signal, rule hit)."
      },
      "tamr.api.queues.v1alpha2.ClassificationSource": {
        "type": "string",
        "enum": [
          "CLASSIFICATION_SOURCE_UNSPECIFIED",
          "CLASSIFICATION_SOURCE_MODEL",
          "CLASSIFICATION_SOURCE_USER"
        ],
        "default": "CLASSIFICATION_SOURCE_UNSPECIFIED",
        "description": "The category of actor or process that produced the suggestion.\n\n - CLASSIFICATION_SOURCE_UNSPECIFIED: Default value. This value is unused.\n - CLASSIFICATION_SOURCE_MODEL: A model produced the suggestion.\n - CLASSIFICATION_SOURCE_USER: A human suggested the classification."
      },
      "tamr.api.queues.v1alpha2.ClassificationSuggestion": {
        "type": "object",
        "properties": {
          "categoryId": {
            "type": "string",
            "description": "Required. The ID of the suggested taxonomy node (category)."
          },
          "taxonomyId": {
            "type": "string",
            "description": "Required. The ID of the taxonomy the category belongs to."
          },
          "taxonomyVersion": {
            "type": "string",
            "format": "int64",
            "description": "Required. The version of the taxonomy the category belongs to."
          },
          "confidence": {
            "description": "Optional. Qualitative confidence in this candidate.",
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.ConfidenceLevel"
              }
            ]
          },
          "rationale": {
            "type": "string",
            "description": "Optional. Prose rationale for this candidate."
          },
          "signals": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.ClassificationSignal"
            },
            "description": "Optional. Structured evidence for the classification."
          }
        },
        "description": "A single candidate classification (top suggestion or alternative).",
        "required": [
          "categoryId",
          "taxonomyId",
          "taxonomyVersion"
        ]
      },
      "tamr.api.queues.v1alpha2.ClassifyRecord": {
        "type": "object",
        "properties": {
          "tableId": {
            "type": "string",
            "description": "Required. The table containing the record."
          },
          "recordId": {
            "type": "string",
            "description": "Required. The record ID to classify."
          },
          "expectedVersionId": {
            "type": "string",
            "format": "int64",
            "description": "Required. The expected record version. Action will fail if the record has been updated."
          },
          "categoryId": {
            "type": "string",
            "description": "Required. The ID of the taxonomy node (category) applied to the record."
          },
          "taxonomyId": {
            "type": "string",
            "description": "Required. The ID of the taxonomy the category belongs to."
          },
          "taxonomyVersion": {
            "type": "string",
            "format": "int64",
            "description": "Required. The version of the taxonomy the category belongs to."
          },
          "updateData": {
            "type": "object",
            "description": "Output only. The data written to the record (record data plus the classification fields).",
            "readOnly": true
          }
        },
        "description": "Apply a classification (taxonomy node) to a record.",
        "required": [
          "tableId",
          "recordId",
          "expectedVersionId",
          "categoryId",
          "taxonomyId",
          "taxonomyVersion"
        ]
      },
      "tamr.api.queues.v1alpha2.ConfidenceLevel": {
        "type": "string",
        "enum": [
          "CONFIDENCE_LEVEL_UNSPECIFIED",
          "CONFIDENCE_LEVEL_HIGH",
          "CONFIDENCE_LEVEL_MEDIUM",
          "CONFIDENCE_LEVEL_LOW"
        ],
        "default": "CONFIDENCE_LEVEL_UNSPECIFIED",
        "description": "Qualitative confidence level for a classification suggestion.\n\n - CONFIDENCE_LEVEL_UNSPECIFIED: Default value. This value is unused.\n - CONFIDENCE_LEVEL_HIGH: High confidence.\n - CONFIDENCE_LEVEL_MEDIUM: Medium confidence.\n - CONFIDENCE_LEVEL_LOW: Low confidence."
      },
      "tamr.api.queues.v1alpha2.EditRecord": {
        "type": "object",
        "properties": {
          "recordId": {
            "type": "string",
            "description": "Required. The record ID to edit."
          },
          "expectedVersionId": {
            "type": "string",
            "format": "int64",
            "description": "Optional. The expected record version to edit. If not provided, the current\nversion is fetched and stored automatically at item creation time.\nWill fail on apply if the record was updated since the item was created\n(use force=true on ApplyQueueItemRequest to override)."
          },
          "updateData": {
            "type": "object",
            "description": "Required. The suggested content to update."
          },
          "tableId": {
            "type": "string",
            "description": "Required. The table containing the record."
          }
        },
        "required": [
          "recordId",
          "updateData",
          "tableId"
        ]
      },
      "tamr.api.queues.v1alpha2.MergeRecords": {
        "type": "object",
        "properties": {
          "tableId": {
            "type": "string",
            "description": "Required. The table containing the records."
          },
          "toRecordId": {
            "type": "string",
            "description": "Required. The ID of the record to keep (merge target)."
          },
          "toRecordVersionId": {
            "type": "string",
            "format": "int64",
            "description": "Required. The expected version of the record to keep."
          },
          "fromRecordId": {
            "type": "string",
            "description": "Required. The ID of the record to retire (merge source)."
          },
          "fromRecordVersionId": {
            "type": "string",
            "format": "int64",
            "description": "Required. The expected version of the record to retire."
          },
          "overrideData": {
            "type": "object",
            "description": "Optional. Data to override during the merge operation."
          }
        },
        "required": [
          "tableId",
          "toRecordId",
          "toRecordVersionId",
          "fromRecordId",
          "fromRecordVersionId"
        ]
      },
      "tamr.api.queues.v1alpha2.QueueItem": {
        "type": "object",
        "properties": {
          "itemId": {
            "type": "string",
            "description": "Output only. The unique identifier for the item. Generated by the service on creation.",
            "readOnly": true
          },
          "queueId": {
            "type": "string",
            "description": "Required. The queue this item belongs to."
          },
          "createTime": {
            "type": "string",
            "format": "date-time",
            "description": "Output only. The time at which the item was created.",
            "readOnly": true
          },
          "editRecord": {
            "description": "Item for editing a record.",
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.EditRecord"
              }
            ]
          },
          "suggestedDuplicate": {
            "description": "Item for reviewing a suggested duplicate.",
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.SuggestedDuplicate"
              }
            ]
          },
          "suggestedClassification": {
            "description": "Item for reviewing a suggested classification.",
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.SuggestedClassification"
              }
            ]
          },
          "status": {
            "description": "Optional. The status of the item.",
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.QueueItemStatus"
              }
            ]
          },
          "updateTime": {
            "type": "string",
            "format": "date-time",
            "description": "Output only. Time when the item was last updated.",
            "readOnly": true
          },
          "tableId": {
            "type": "string",
            "description": "Output only. The table this item belongs to.",
            "readOnly": true
          },
          "actions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.QueueItemAction"
            },
            "description": "Output only. Actions that have been submitted for this item.",
            "readOnly": true
          },
          "createdBy": {
            "description": "Output only. The user who created this item.",
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.v1alpha2.User"
              }
            ]
          },
          "updatedBy": {
            "description": "Output only. The user who last updated this item.",
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.v1alpha2.User"
              }
            ]
          }
        },
        "required": [
          "queueId"
        ]
      },
      "tamr.api.queues.v1alpha2.QueueItemAction": {
        "type": "object",
        "properties": {
          "actionId": {
            "type": "string",
            "description": "Output only. The unique identifier for the action.",
            "readOnly": true
          },
          "createTime": {
            "type": "string",
            "format": "date-time",
            "description": "Output only. The time at which the action was created.",
            "readOnly": true
          },
          "mergeRecords": {
            "description": "Merge two records together.",
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.MergeRecords"
              }
            ]
          },
          "applyEdit": {
            "description": "Apply an edit to a record.",
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.ApplyEdit"
              }
            ]
          },
          "classifyRecord": {
            "description": "Apply a classification to a record.",
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.ClassifyRecord"
              }
            ]
          },
          "result": {
            "description": "Output only. The result of the action.",
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.ActionResult"
              }
            ]
          },
          "user": {
            "description": "Output only. The user who performed this action.",
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.v1alpha2.User"
              }
            ]
          }
        }
      },
      "tamr.api.queues.v1alpha2.QueueItemStatus": {
        "type": "string",
        "enum": [
          "QUEUE_ITEM_STATUS_UNSPECIFIED",
          "QUEUE_ITEM_STATUS_OPEN",
          "QUEUE_ITEM_STATUS_CLOSED"
        ],
        "default": "QUEUE_ITEM_STATUS_UNSPECIFIED",
        "description": " - QUEUE_ITEM_STATUS_UNSPECIFIED: Default value. This value is unused.\n - QUEUE_ITEM_STATUS_OPEN: Item is active and awaiting review. Includes items that have been re-opened.\n - QUEUE_ITEM_STATUS_CLOSED: Item is inactive. Includes items that were dismissed or had an action applied."
      },
      "tamr.api.queues.v1alpha2.Queues.ApplyQueueItemBody": {
        "type": "object",
        "properties": {
          "dryRun": {
            "type": "boolean",
            "description": "Optional. If true, compute the result but do not commit the changes."
          },
          "force": {
            "type": "boolean",
            "description": "Optional. If true, bypasses record version checks. For edit items the edit\nis applied regardless of current record version. For merge items the current\nrecord versions are re-fetched at apply time so the merge proceeds against\nthe latest state."
          }
        }
      },
      "tamr.api.queues.v1alpha2.SuggestedClassification": {
        "type": "object",
        "properties": {
          "record": {
            "description": "Required. The record to classify.",
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.SuggestedRecord"
              }
            ]
          },
          "topSuggestion": {
            "description": "Required. The top (recommended) classification.",
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.ClassificationSuggestion"
              }
            ]
          },
          "alternatives": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.ClassificationSuggestion"
            },
            "description": "Optional. Alternative classifications, ranked. May be empty."
          },
          "source": {
            "description": "Optional. The source for the suggested classification.",
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.ClassificationSource"
              }
            ]
          }
        },
        "description": "A suggested classification of a record into a taxonomy node.",
        "required": [
          "record",
          "topSuggestion"
        ]
      },
      "tamr.api.queues.v1alpha2.SuggestedDuplicate": {
        "type": "object",
        "properties": {
          "primaryRecord": {
            "description": "Required. The primary record (typically the one to keep).",
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.SuggestedRecord"
              }
            ]
          },
          "candidateRecord": {
            "description": "Required. The candidate duplicate record.",
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.SuggestedRecord"
              }
            ]
          },
          "matchType": {
            "description": "Required. The type of match that identified this potential duplicate.",
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.queues.v1alpha2.SuggestedMatchType"
              }
            ]
          }
        },
        "required": [
          "primaryRecord",
          "candidateRecord",
          "matchType"
        ]
      },
      "tamr.api.queues.v1alpha2.SuggestedMatchType": {
        "type": "string",
        "enum": [
          "SUGGESTED_MATCH_TYPE_UNSPECIFIED",
          "ID_MATCH",
          "SEARCH_MATCH",
          "POSSIBLE_DUPLICATE",
          "USER_FEEDBACK"
        ],
        "default": "SUGGESTED_MATCH_TYPE_UNSPECIFIED",
        "description": " - SUGGESTED_MATCH_TYPE_UNSPECIFIED: Default value. This value is unused.\n - ID_MATCH: Match based on record ID.\n - SEARCH_MATCH: Match based on search similarity.\n - POSSIBLE_DUPLICATE: Possible duplicate with lower confidence.\n - USER_FEEDBACK: User indicated potential duplicate."
      },
      "tamr.api.queues.v1alpha2.SuggestedRecord": {
        "type": "object",
        "properties": {
          "tableId": {
            "type": "string",
            "description": "Required. The table containing the record."
          },
          "recordId": {
            "type": "string",
            "description": "Required. The record ID at the time the item was created."
          },
          "versionId": {
            "type": "string",
            "format": "int64",
            "description": "Optional. The record version at the time the item was created. If not provided, the\ncurrent version is fetched and stored automatically at item creation time.\nWill fail on apply if the record was updated since the item was created\n(use force=true on ApplyQueueItemRequest to override)."
          },
          "snapshotData": {
            "type": "object",
            "description": "Output only. The record data at the time the item was created.",
            "readOnly": true
          },
          "currentRecordId": {
            "type": "string",
            "description": "Output only. The current record ID. May differ from record_id if the record was merged.",
            "readOnly": true
          },
          "currentVersionId": {
            "type": "string",
            "format": "int64",
            "description": "Output only. The current record version.",
            "readOnly": true
          }
        },
        "required": [
          "tableId",
          "recordId"
        ]
      },
      "tamr.api.v1alpha2.User": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string",
            "description": "The unique identifier of the user."
          },
          "email": {
            "type": "string",
            "description": "The email address of the user."
          }
        }
      }
    }
  }
}
```