API documentation

PUT /agent_messages/:id

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/agent_messages/:id

Update Agent Message by id.

Updates the content or agent_status_id of an existing Agent Message. Saving the change re-triggers the asynchronous broadcast to the same agent widgets that were targeted at creation; the buyer, buyer group, and call center targeting itself cannot be changed after the message is created.

Params

Param name	Description
content Optional Blank value allowed	Content Must be a String
agent_status_id Optional Blank value allowed	Agent Status Must be a valid foreign key reference to an Agent Status. Refer to: /api/docs/1.0/agent_statuses
buyer_ids Optional Blank value allowed	Agents Must be a valid array of integers. Each integer ID must be a valid foreign key reference to an Buyer. Refer to: /api/docs/1.0/buyers
buyer_group_ids Optional Blank value allowed	Buyer Groups Must be a valid array of integers. Each integer ID must be a valid foreign key reference to an Buyer Group. Refer to: /api/docs/1.0/buyer_groups
call_center_ids Optional Blank value allowed	Call Centers Must be a valid array of integers. Each integer ID must be a valid foreign key reference to an Call Center. Refer to: /api/docs/1.0/call_centers

Example Request

curl -X PUT 'https://[your-subdomain].trackdrive.com/api/v1/agent_messages/a6af7847-1b1e-4760-ac0d-e1813a6d3a09' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "content": "This is an updated example broadcast message."
}'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "agent_message": {
    "id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "type": "AgentMessage",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": null,
    "routes_edit_path": "/agent_messages/a6af7847-1b1e-4760-ac0d-e1813a6d3a09/edit",
    "external_record_id": null,
    "company_id": 10001,
    "content": "This is an updated example broadcast message.",
    "agent_status_id": null,
    "user_id": 10002,
    "agent_widget_count": 1
  },
  "metadata": {
    "root": "agent_message"
  }
}