Customer interactions
A customer interaction is one conversation with a customer: a customer meeting, a support case, an agentic interview or a feedback widget conversation. List, create, update and delete interactions, change their status, read and add messages, and summarize one, which also files what the customer asked for as feature requests and the problems they hit as bug reports. You can also have Productmind read an interaction's screenshots into a draft analysis, then append it to the notes or dismiss it. See Customer meetings.
List customer interactions in a workspace
Returns customer interactions (interviews, feedback streams, meeting notes). Supports filtering by status, type, and account. Returns: id, type, status, contact, summary, createdAt.
path Parameters
workspaceIdWorkspace UUID
query Parameters
pagePage number (1-indexed, default 1)
limitItems per page (default 50)
sortByField to sort by
sortOrderSort direction (default desc)
searchFull-text search across searchable fields
statusComma-separated interaction statuses to filter by (draft, scheduled, invited, in_progress, processing, completed, cancelled, invalid, failed)
typesComma-separated interaction types to filter by
standaloneOnlyOnly return standalone interactions
accountIdsComma-separated account UUIDs to filter by
contactIdsComma-separated contact UUIDs to filter by
tagsComma-separated tag names to filter by
sourcesComma-separated interaction sources to filter by. Use productmind for interactions created in Productmind rather than imported.
activityAfter^(?:(?:\d\d[2468][04…Only the items with activity after this ISO 8601 instant (for example 2026-10-26T09:00:00Z): for a session its last activity, or its last update when it has none; for every other list its last update (updatedAt). Send it with limit=1 and read pagination.total to count what changed since then. The response names the instant it applied in filters.activityAfter. A value that is not an ISO 8601 instant is refused with 400.
List customer interactions in a workspace › Responses
List of customer interactions
Create a customer interaction
Create a new customer interaction (customer meeting, support case, etc.).
path Parameters
workspaceIdWorkspace UUID
Create a customer interaction › Request Body
typetitleHuman name for the interaction. Stored in the summary blob; an AI summarization may later replace it.
customerResearchIdworkspaceIdcontactIdtagsrawContentguidelinescheduledAtendsAtWhen the meeting ends. Only meaningful paired with scheduledAt, and must be strictly after it. Leave it out when the duration is unknown — the UI renders an unset end as one hour.
meetingUrlvoiceEnabledrecordingEnabledtranscriptionEnabledPeople on the meeting invitation. The server normalizes these and stores them as read-only participants; blank or malformed addresses are dropped rather than rejected.
externalSourceWhich external system this interaction was imported from.
externalIdThe external system's own id for this record — half of the dedup key.
externalSourceUrlDeep link back to the record in the external system.
Create a customer interaction › Responses
Created interaction
Get a customer interaction by ID
Retrieve a single customer interaction with full details.
path Parameters
workspaceIdWorkspace UUID
idInteraction UUID
Get a customer interaction by ID › Responses
Interaction details
Update a customer interaction
Modify an existing customer interaction's details.
path Parameters
workspaceIdWorkspace UUID
idInteraction UUID
Update a customer interaction › Request Body
tagsrawContentguidelinemeetingUrlrecordingEnabledtranscriptionEnabledThe conversation's whole participant roster, replaced. The server normalizes the addresses, keeps the role it already recorded for anyone already on the roster, and drops blank or malformed entries. Send an empty array to clear it.
Update a customer interaction › Responses
Updated interaction
Update a customer interaction's status
Change the status of a customer interaction (e.g., draft → in_progress → completed).
path Parameters
workspaceIdWorkspace UUID
idInteraction UUID
Update a customer interaction's status › Request Body
statusWhy the interaction is being cancelled, shown beside its cancelled status. Kept only with status cancelled; any other status clears it.
A machine-readable code for the cancel reason, such as insufficient_credit or spending_paused for an interview the AI credit check refused. Kept only with status cancelled.
Update a customer interaction's status › Responses
Updated interaction
Update a customer interaction's progress
Update the progress metadata of a customer interaction.
path Parameters
workspaceIdWorkspace UUID
idInteraction UUID
Update a customer interaction's progress › Responses
Updated interaction
Summarize a customer interaction
Queue AI summarization of a customer interaction's content. Returns as soon as the job is published; the result arrives over the customer_interaction:status_updated socket frame and an interaction.summarized notification. Refused with 409 while a run is already in flight — a second run would duplicate the interests the first one imports.
path Parameters
workspaceIdWorkspace UUID
idInteraction UUID
Summarize a customer interaction › Responses
Summarization queued
Read a conversation's screenshots into its notes
Trigger the vision agent to read the screenshots attached to a customer conversation and draft an analysis section for its meeting notes. Idempotent while a run is in flight. The draft is ALWAYS held for review — unlike the feature-request, task and bug-report equivalents there is no auto-apply, because the section is appended to notes somebody wrote. Rejected for a conversation whose content is a message thread rather than notes: its summary is built from the thread, so an appended section would never reach it.
path Parameters
workspaceIdWorkspace UUID
idInteraction UUID
Read a conversation's screenshots into its notes › Request Body
sourceHow the run was triggered. Only manual is wired today.
Read a conversation's screenshots into its notes › Responses
The queued (or in-flight) description proposal
List a conversation's screenshot-analysis proposals
Returns AI-drafted screenshot-analysis proposals for a customer conversation. Pass activeOnly=true for the single in-flight / awaiting-review proposal.
path Parameters
workspaceIdWorkspace UUID
idInteraction UUID
query Parameters
activeOnlyList a conversation's screenshot-analysis proposals › Responses
Screenshot-analysis proposals
Append a reviewed screenshot analysis to the notes
Append the reviewed analysis BLOCK to the conversation's notes under a stable heading, replacing any block a previous run left, and settle the proposal. The body carries the block, not the whole notes — this is the one place this endpoint differs from its feature-request, task and bug-report equivalents.
path Parameters
workspaceIdWorkspace UUID
idInteraction UUID
proposalIdProposal UUID
Append a reviewed screenshot analysis to the notes › Request Body
descriptionAppend a reviewed screenshot analysis to the notes › Responses
The settled proposal
Dismiss a screenshot-analysis proposal
Reject the drafted analysis wholesale, leaving the conversation's notes unchanged.
path Parameters
workspaceIdWorkspace UUID
idInteraction UUID
proposalIdProposal UUID
Dismiss a screenshot-analysis proposal › Responses
The dismissed proposal
Cancel an in-flight screenshot-analysis run
Stop a queued or running run, releasing the one-active-proposal slot. A late worker callback then no-ops on the already-settled proposal.
path Parameters
workspaceIdWorkspace UUID
idInteraction UUID
proposalIdProposal UUID
Cancel an in-flight screenshot-analysis run › Responses
The cancelled proposal
List messages for a customer interaction
Returns all messages exchanged during a customer interaction.
path Parameters
workspaceIdWorkspace UUID
interactionIdInteraction UUID
List messages for a customer interaction › Responses
List of messages
Add a message to a customer interaction
Post a new message to a customer interaction conversation. A message posted through the API carries its content alone: an interviewer's turn and what it cost are reported by Productmind's interviewer, and refused (400) from any other caller.
path Parameters
workspaceIdWorkspace UUID
interactionIdInteraction UUID
Add a message to a customer interaction › Request Body
contentisFromAgentSet by Productmind's interviewer only; refused from any other caller.
Set by Productmind's interviewer only; refused from any other caller.
userIdSet by Productmind's interviewer only; refused from any other caller.
organizationIdSet by Productmind's interviewer only; refused from any other caller, and never read.
Add a message to a customer interaction › Responses
Message created