Interaction

Create a resolution for an interaction

Manually attribute (positive) or suppress (negative) an interaction for a contact. A positive resolution attaches the interaction to the contact. A negative resolution suppresses an incorrect automatic match.

post/interactions/{id}/resolutions

Path parameters

idstring uuid required
Example:550e8400-e29b-41d4-a716-446655440000

The ID of the interaction. The ID is returned from GET /interactions response.

Request body

contact_idstring uuid required

The contact to attach or suppress this interaction for.

resolution_type'positive' | 'negative' required

Type of resolution.

resolved_by_type'agent' | 'system' | 'rule' required

Who resolved this interaction.

resolved_by_idstring uuid required

ID of the agent, system, or rule that resolved the interaction.

Example request

{
  "contact_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
  "resolution_type": "positive",
  "resolved_by_type": "agent",
  "resolved_by_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Response

Resolution created successfully.

idstring uuid

Unique identifier for the resolution.

customer_idstring uuid

Unique identifier of the associated customer.

contact_idstring uuid

The contact this resolution is attributed to.

interaction_idstring uuid

The interaction this resolution belongs to.

resolution_type'positive' | 'negative'

Attribution type.

resolved_by_type'agent' | 'system' | 'rule'

Who resolved this interaction.

resolved_by_idstring uuid

ID of the agent, system, or rule that resolved the interaction.

tm_createstring date-time

Timestamp when the resolution was created.

tm_updatestring date-time

Timestamp when the resolution was last updated.

tm_deletestring date-time

Timestamp when the resolution was soft-deleted. Null if active.

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "customer_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
  "contact_id": "550e8400-e29b-41d4-a716-446655440000",
  "interaction_id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
  "resolution_type": "positive",
  "resolved_by_type": "agent",
  "resolved_by_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "tm_create": "2026-06-01T10:00:00.000000Z",
  "tm_update": "2026-06-01T10:00:00.000000Z",
  "tm_delete": "2026-06-02T08:00:00.000000Z"
}

Changes