Interactions

Update interaction metadata (e.g. spam, report)

Update interaction metadata (e.g. spam, report).

PATCH

/business/locations/{location_id}/agents/{agent_id}/interactions/{id}

curl --request PATCH \
  --url https://api-example.kickcall.ai/api/v1/business/locations/{location_id}/agents/{agent_id}/interactions/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "interaction": {
    "report_call": {
      "description": "<string>"
    },
    "spam": true
  }
}
'

{
  "agent_id": 980,
  "channel": "Interactions::Phone",
  "contact": {
    "category": "general",
    "id": 1201,
    "phone_number": "+14166706230"
  },
  "created_at": "2026-10-22T18:00:02.000Z",
  "direction": "inbound",
  "disconnection_reason": "user_hangup",
  "duration_in_seconds": 372.5,
  "id": 22702,
  "interaction_journey": [
    {
      "content": "What type of appointment would you like to book?",
      "id": "m1",
      "role": "assistant",
      "type": "message"
    },
    {
      "content": "Established patient",
      "id": "m2",
      "role": "user",
      "type": "message"
    }
  ],
  "interaction_type": "call",
  "metrics": {},
  "recording_url": "https://cdn.example/recordings/22702.mp3",
  "source_info": "+14166706230",
  "start_at": "2026-10-22T18:00:00.000Z",
  "status": "completed",
  "summary": "Caller booked an Established Patient appointment with Dr. Jones.",
  "test": false
}

Audience: Business portal. Auth: Business/agency JWT or API key; usually header Business-Id. Resource: Interactions.

Authorizations

Authorizationstringheaderrequired

JWT from OTP login, or business/agency API key string.

Path Parameters

location_idintegerrequired

agent_idintegerrequired

idintegerrequired

Body

interactionobject

Show child attributes

Response

OK — Updated interaction

agent_idinteger

channelstring

contactobject | null

created_atstring

directionenum<string>

Available options: inbound, outbound

disconnection_reasonstring | null

duration_in_secondsnumber | null

idinteger

interaction_journeyobject[]

interaction_typeenum<string>

Available options: call, chat

metricsobject

recording_urlstring | null

source_infostring

Caller identity (usually E.164 phone)

start_atstring | null

statusstring

summarystring | null

testboolean

Still need help? Ask the team