> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qobra.co/llms.txt
> Use this file to discover all available pages before exploring further.

# list_sales_coach_discussions

List the company's Sales Coach discussions, most recently opened first.

A discussion is one conversation a user had with the Sales Coach — the Qobra AI
assistant they ask about their own statement — their questions and the agent's
answers. Reach for it to review what people actually asked the AI: recurring
confusion about a plan, topics the agent had to escalate, a specific rep's
questions. Qobra's other AI agents have no equivalent tool yet, so this is not
the full picture of what people ask the product's AI.

Reserved to full statement access, so it returns every discussion in the
company. Filters combine with AND. Each row is a summary — the opening question,
how many questions followed, whether the agent escalated; fetch
get\_sales\_coach\_discussion for the full transcript of one.

Keep paginating for as long as next\_offset comes back set: a page can be shorter
than limit — empty, even — without being the end of the list.

## Parameters

<Accordion title="Body" defaultOpen>
  <ParamField body="author" type="string">
    Keep only the discussions this person had with the agent, by name or email
    (case-insensitive substring) or user ObjectId. Omit for every author.
  </ParamField>

  <ParamField body="statement" type="string">
    Keep only discussions about this statement — its ObjectId, or a YYYY-MM
    period (e.g. 2026-03) for every statement of that period. Omit for every
    statement.
  </ParamField>

  <ParamField body="start" type="string">
    Keep only discussions opened at or after this instant. Accepts an absolute
    ISO-8601 date/time ('2026-07-01') or a duration relative to now ('-P7D' for
    the last 7 days). Omit for no lower bound.
  </ParamField>

  <ParamField body="end" type="string">
    Keep only discussions opened at or before this instant. Same accepted forms
    as start. Omit for no upper bound.
  </ParamField>

  <ParamField body="limit" type="integer">
    Page size, between 1 and 250. Defaults to 50.
  </ParamField>

  <ParamField body="offset" type="integer">
    Row offset into the result set — the number of rows to skip before this
    page. Pass the next\_offset returned by the previous call, or None for the
    first page.
  </ParamField>
</Accordion>

## Response

<Accordion title="Body" defaultOpen>
  <ResponseField name="discussions" type="object[]">
    <Expandable title="object properties">
      <ResponseField name="id" type="string" />

      <ResponseField name="resource_url" type="string">
        Deep link to the statement the discussion is about, in the Qobra web
        app. Discussions have no page of their own.
      </ResponseField>

      <ResponseField name="author" type="object">
        The user who asked the questions.

        <Expandable title="object properties">
          <ResponseField name="id" type="string" />

          <ResponseField name="email" type="string" />

          <ResponseField name="name" type="string" />
        </Expandable>
      </ResponseField>

      <ResponseField name="statement" type="object">
        <Expandable title="object properties">
          <ResponseField name="id" type="string" />

          <ResponseField name="period" type="string">
            Statement period, YYYY-MM.
          </ResponseField>

          <ResponseField name="owner" type="object">
            The user the statement belongs to. Usually also the discussion's
            author (a rep asking about their own statement), but an admin or
            manager can question someone else's statement.

            <Expandable title="object properties">
              <ResponseField name="id" type="string" />

              <ResponseField name="email" type="string" />

              <ResponseField name="name" type="string" />
            </Expandable>
          </ResponseField>
        </Expandable>
      </ResponseField>

      <ResponseField name="first_question" type="string">
        The opening question, verbatim — what the user came for. Null for a
        discussion with no user message yet.
      </ResponseField>

      <ResponseField name="question_count" type="integer">
        Number of questions the user asked. Excludes the replies they gave to
        the agent's own clarifying questions, which are stored as user messages
        too.
      </ResponseField>

      <ResponseField name="message_count" type="integer">
        Total messages in the transcript, questions and answers together.
      </ResponseField>

      <ResponseField name="escalation_count" type="integer">
        Number of times the agent escalated to a human, opening a request. Above
        zero means the agent could not answer on its own — fetch
        get\_sales\_coach\_discussion for the escalation detail.
      </ResponseField>

      <ResponseField name="started_at" type="string">
        When the discussion was opened — the sort key, most recent first, and
        what the start/end filters match.
      </ResponseField>

      <ResponseField name="updated_at" type="string">
        Last activity on the discussion.
      </ResponseField>
    </Expandable>
  </ResponseField>

  <ResponseField name="next_offset" type="integer" />
</Accordion>