Skip to main content
POST
Ask Attention V2
Choosing between deal_id and conversations_idsAlthough both deal_id and conversations_ids appear as required in the schema, the endpoint actually requires exactly one of them per request:
  • To analyze specific conversations, set conversations_ids to a non-empty array and pass deal_id as an empty string ("").
  • To analyze every conversation associated with a deal, set deal_id to the deal UUID and omit conversations_ids (or pass it as an empty array []).
Sending both a non-empty deal_id and a non-empty conversations_ids returns a 400 error: “you must provide either a deal ID or conversation IDs, not both”. Sending neither returns an error stating that at least one is required.

Example requests

Using conversations_ids (pass deal_id as an empty string):
Using deal_id (omit or empty conversations_ids):

Authorizations

Authorization
string
header
required

Query Parameters

include_timestamps
boolean

When true, return timestamped segments (start/end seconds + excerpt) for each conversation alongside the textual answer.

summarize
boolean

When true, synthesize all per-conversation outputs into a single combined response appended with conversation_id "summary".

Body

Request containing the content to be analyzed and analysis parameters

conversations_ids
string[]
required
Maximum string length: 50
deal_id
string
required
prompt
string
required

Response

Content successfully analyzed with attention points identified

output
string
required
conversation_id
string
required
error
string
required
segments
object[]

Optional timestamped segments relevant to the answer (present when include_timestamps=true).

title
string

Conversation title

Example: