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

# List Conversations (Optimized)

> Optimized alias for GET /conversations. Uses a batch query path that pre-fetches edges in a single pass, making it significantly faster for large result sets. Behavioural differences from /conversations: (1) extractedIntelligence and confirmedExtractedIntelligence are omitted by default — pass with_crm_records=true to include them; (2) empty conversations are not excluded; All filter parameters are identical to /conversations.



## OpenAPI

````yaml get /conversations/list
openapi: 3.0.1
info:
  title: Attention Service V2
  description: Attention Service API V2
  termsOfService: https://www.attention.com/terms-of-use
  contact:
    name: Attention Team
    url: https://docs.attention.com/welcome
    email: support@attention.com
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  version: 1.8.0
servers:
  - url: https://api.attention.tech/v2
security:
  - APIKeyHeader: []
paths:
  /conversations/list:
    get:
      tags:
        - Conversation
      summary: List Conversations (Optimized)
      description: >-
        Optimized alias for GET /conversations. Uses a batch query path that
        pre-fetches edges in a single pass, making it significantly faster for
        large result sets. Behavioural differences from /conversations: (1)
        extractedIntelligence and confirmedExtractedIntelligence are omitted by
        default — pass with_crm_records=true to include them; (2) empty
        conversations are not excluded; All filter parameters are identical to
        /conversations.
      operationId: listConversationsV2
      parameters:
        - name: fromDateTime
          in: query
          description: Start date and time for filtering conversations (ISO 8601 format)
          schema:
            type: string
        - name: toDateTime
          in: query
          description: End date and time for filtering conversations (ISO 8601 format)
          schema:
            type: string
        - name: fromUpdatedAtDateTime
          in: query
          description: >-
            Filter by last-updated lower bound (RFC 3339, e.g.
            2026-04-01T00:00:00Z; fractional seconds and numeric UTC offsets
            accepted). Matches conversations whose updatedAt (when the
            conversation was last updated) is greater than or equal to this
            value. Only conversations that have an updatedAt are matched;
            updatedAt reflects changes to the conversation itself, not to
            related records such as scorecard results or CRM data. When set,
            results are ordered by updatedAt ascending and paged with cursor,
            and meta.totalRecords is a lower bound. For incremental sync, start
            with a full unfiltered pull, then pass the time of the previous sync
            minus a few minutes and deduplicate by id.
          schema:
            type: string
        - name: toUpdatedAtDateTime
          in: query
          description: >-
            Filter by last-updated upper bound (RFC 3339, e.g.
            2026-04-10T23:59:59Z; fractional seconds and numeric UTC offsets
            accepted). Matches conversations whose updatedAt (when the
            conversation was last updated) is less than or equal to this value.
            Only conversations that have an updatedAt are matched. When set,
            results are ordered by updatedAt ascending and paged with cursor,
            and meta.totalRecords is a lower bound.
          schema:
            type: string
        - name: cursor
          in: query
          description: >-
            Opaque cursor returned as nextCursor by a previous call with the
            same filters. Omit on the first page. Requires fromUpdatedAtDateTime
            or toUpdatedAtDateTime; page is ignored when set.
          schema:
            type: string
        - name: page
          in: query
          description: Page number for pagination (starts from 1)
          schema:
            type: integer
        - name: size
          in: query
          description: Number of items per page (max 50)
          schema:
            type: integer
        - name: filter[owner.id]
          in: query
          description: Filter conversations by owner IDs
          style: form
          explode: false
          schema:
            type: array
            items:
              type: string
        - name: filter[owner.email]
          in: query
          description: Filter conversations by owner email addresses
          style: form
          explode: false
          schema:
            type: array
            items:
              type: string
        - name: filter[title]
          in: query
          description: >-
            Filter conversations by title using case-insensitive partial
            matching
          schema:
            type: string
        - name: filter[participants.email]
          in: query
          description: Filter conversations by participant email addresses
          style: form
          explode: false
          schema:
            type: array
            items:
              type: string
        - name: filter[external_opportunity.id]
          in: query
          description: Filter conversations by external opportunity IDs
          style: form
          explode: false
          schema:
            type: array
            items:
              type: string
        - name: filter[crm_field.entity_code]
          in: query
          description: CRM platform entity code to filter linked CRM records
          schema:
            type: string
            enum:
              - companies
              - contacts
              - deals
              - owners
              - pipelines
              - users
              - account
              - contact
              - lead
              - opportunity
              - user
        - name: filter[crm_field.field_name]
          in: query
          description: >-
            CRM record field name (from org_crm_records.record_data) to match on
            linked CRM records
          schema:
            type: string
        - name: filter[crm_field.values]
          in: query
          description: >-
            Exact values to match for the given CRM field. Values are OR-ed
            together. Maximum 10 entries.
          style: form
          explode: false
          schema:
            type: array
            items:
              type: string
        - name: filter[team.id]
          in: query
          description: Filter conversations by team IDs
          style: form
          explode: false
          schema:
            type: array
            items:
              type: string
        - name: filter[hide_internal]
          in: query
          description: Exclude internal conversations from results
          schema:
            type: boolean
        - name: filter[hide_non_analyzed]
          in: query
          description: Exclude conversations that have not been analyzed
          schema:
            type: boolean
        - name: filter[analyzed]
          in: query
          description: >-
            Filter conversations by analysis status (deprecated, use
            filter[hide_non_analyzed] instead)
          schema:
            type: boolean
        - name: filter[hide_pending]
          in: query
          description: Exclude conversations that are pending processing
          schema:
            type: boolean
        - name: filter[hide_transcript]
          in: query
          description: >-
            Omit the `transcript` field from each conversation in the response.
            Conversations are not filtered; totals and pagination are unchanged.
          schema:
            type: boolean
        - name: filter[hide_failed]
          in: query
          description: Exclude conversations that failed processing
          schema:
            type: boolean
        - name: filter[include_internal_participants]
          in: query
          description: Include internal participants in the response
          schema:
            type: boolean
        - name: filter[include_zoom_metadata]
          in: query
          description: Include Zoom-specific metadata in the response
          schema:
            type: boolean
        - name: filter[include_import_metadata]
          in: query
          description: Include import metadata in the response
          schema:
            type: boolean
        - name: detailedTranscript
          in: query
          description: Include detailed transcript information in the response
          schema:
            type: boolean
            default: false
        - name: withCrmRecords
          in: query
          description: >-
            Include CRM records in the response. Also re-enables
            extractedIntelligence and confirmedExtractedIntelligence fields that
            are otherwise stripped on this endpoint.
          schema:
            type: boolean
            default: false
        - name: withIntelligenceItems
          in: query
          description: Include intelligence items in the response
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: Successfully retrieved conversations
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationsResponse'
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ConversationsResponse'
        '401':
          description: Authentication failed - valid API key required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: Unexpected error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    ConversationsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Conversation'
        links:
          $ref: '#/components/schemas/Links'
        meta:
          $ref: '#/components/schemas/Meta'
        nextCursor:
          type: string
          description: >-
            Opaque cursor for the next page when fromUpdatedAtDateTime or
            toUpdatedAtDateTime is set. Absent when there are no more results.
      example:
        data: []
        links:
          self: /v2/conversations?page=1
          related: /v2/conversations?page=2
        meta:
          totalRecords: 150
    Error:
      type: object
      properties:
        id:
          type: string
          description: A unique identifier for the error.
        status:
          type: string
          description: >-
            The HTTP status code applicable to this problem, expressed as a
            string value.
        code:
          type: string
          description: An application-specific error code, expressed as a string value.
        title:
          type: string
          description: A short, human-readable summary of the problem.
        detail:
          type: string
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
        source:
          type: object
          properties:
            pointer:
              type: string
            parameter:
              type: string
        meta:
          type: object
          properties: {}
      example:
        id: not_found_error
        status: '404'
        code: '404'
        title: Not Found Error
        detail: The requested resource was not found
        source:
          pointer: /data/attributes/id
    Conversation:
      type: object
      properties:
        type:
          type: string
          enum:
            - conversations
        id:
          type: string
        attributes:
          required:
            - dealUUID
            - externalIntelligenceOpportunityID
            - externalOpportunity
            - importMetadata
            - zoomMetadata
          type: object
          properties:
            uuid:
              type: string
            transcript:
              type: object
              additionalProperties: true
            boards:
              type: array
              items:
                $ref: '#/components/schemas/ConversationBoard'
            finishedAt:
              type: string
              format: date-time
            title:
              type: string
            liveStreamStartedAt:
              type: string
              format: date-time
            liveStreamEndedAt:
              type: string
              format: date-time
            talktracks:
              type: array
              items:
                $ref: '#/components/schemas/ConversationTalktrack'
            createdAt:
              type: string
              format: date-time
            updatedAt:
              type: string
              format: date-time
              nullable: true
              description: When the conversation was last updated
            userUUID:
              type: string
            user:
              $ref: '#/components/schemas/User'
            team:
              $ref: '#/components/schemas/Team'
            teamUUID:
              type: string
            extractedIntelligence:
              type: object
              additionalProperties:
                $ref: '#/components/schemas/ExtractedIntelligenceItem'
            confirmedExtractedIntelligence:
              type: object
              additionalProperties:
                $ref: '#/components/schemas/ExtractedIntelligenceItem'
            externalIntelligenceOpportunityID:
              type: string
            crmExportStatus:
              $ref: '#/components/schemas/CrmExportStatus'
            archived:
              type: boolean
            externalOpportunity:
              $ref: '#/components/schemas/CRMExportOpportunity'
            videoUID:
              type: string
            videoStatus:
              $ref: '#/components/schemas/VideoStatus'
            bots:
              type: array
              items:
                $ref: '#/components/schemas/ConversationBot'
            transcriptStatus:
              type: string
            participants:
              type: array
              items:
                $ref: '#/components/schemas/Participant'
            attendees:
              type: array
              items:
                $ref: '#/components/schemas/Participant'
            referenceable:
              type: boolean
            private:
              type: boolean
            mediaStorageStatus:
              $ref: '#/components/schemas/VideoStatus'
            importStatus:
              $ref: '#/components/schemas/ConversationImportStatus'
            scorecardResults:
              type: array
              items:
                $ref: '#/components/schemas/ScorecardResult'
            labels:
              type: object
              additionalProperties: true
            labelTagsToFilterIfNA:
              type: array
              items:
                type: string
            deprecatedLabelCategories:
              type: array
              items:
                type: string
            isInternal:
              type: boolean
            mediaDuration:
              type: number
              format: float
            dealUUID:
              type: string
            emailTemplateID:
              type: string
            linkedCrmRecords:
              type: array
              items:
                $ref: '#/components/schemas/LinkedCrmRecord'
            externalAccounts:
              type: array
              items:
                $ref: '#/components/schemas/LinkedCrmRecord'
            externalContacts:
              type: array
              items:
                $ref: '#/components/schemas/LinkedCrmRecord'
            isEmpty:
              type: boolean
            zoomMetadata:
              $ref: '#/components/schemas/ZoomMetadata'
            importMetadata:
              type: object
              additionalProperties: true
            zoomMeetingJoinUrl:
              type: string
              description: >-
                The Zoom meeting join URL if the conversation was recorded from
                a Zoom meeting
            googleMeetJoinUrl:
              type: string
              description: >-
                The Google Meet join URL if the conversation was recorded from a
                Google Meet
            microsoftTeamsJoinUrl:
              type: string
              description: >-
                The Microsoft Teams meeting join URL if the conversation was
                recorded from a Teams meeting
            webexJoinUrl:
              type: string
              description: >-
                The Webex meeting join URL if the conversation was recorded from
                a Webex meeting
        links:
          $ref: '#/components/schemas/Links'
      example:
        type: conversations
        id: conv-uuid-123
        attributes:
          uuid: conv-uuid-123
          title: Q1 Deal Review - Acme Corp
          createdAt: '2024-03-18T10:00:00Z'
          finishedAt: '2024-03-18T10:45:00Z'
          liveStreamStartedAt: '2024-03-18T10:00:00Z'
          liveStreamEndedAt: '2024-03-18T10:45:00Z'
          userUUID: user-uuid-456
          teamUUID: team-uuid-789
          archived: false
          referenceable: true
          private: false
          isInternal: false
          isEmpty: false
          mediaDuration: 2700
          videoUID: vid-uid-abc
          videoStatus: ready
          mediaStorageStatus: ready
          transcriptStatus: completed
          crmExportStatus: exported
          importStatus: completed
          dealUUID: deal-uuid-xyz
          emailTemplateID: ''
          externalIntelligenceOpportunityID: opp-ext-123
          zoomMeetingJoinUrl: ''
          googleMeetJoinUrl: ''
          microsoftTeamsJoinUrl: ''
          webexJoinUrl: ''
          transcript: {}
          participants:
            - id: part-uuid-1
              email: jane@example.com
              name: Jane Smith
              organizer: true
              status: accepted
            - id: part-uuid-2
              email: john@customer.com
              name: John Doe
              organizer: false
              status: accepted
          attendees:
            - id: part-uuid-1
              email: jane@example.com
              name: Jane Smith
              organizer: true
              status: accepted
          bots:
            - uuid: bot-uuid-1
              meetingUrl: https://zoom.us/j/1234567890
              status:
                code: completed
                message: Recording uploaded
                createdAt: '2024-03-18T10:50:00Z'
          boards:
            - uuid: cb-uuid-1
              board:
                uuid: board-uuid-1
                name: Sales Playbook
                teamUUID: team-uuid-789
                columns: []
              battlecards: []
          talktracks:
            - uuid: ct-uuid-1
              items:
                - uuid: cti-uuid-1
                  activatedItemId: item-uuid-1
                  done: true
          scorecardResults:
            - uuid: sr-uuid-1
              title: Sales Discovery Scorecard
              items: []
              summary:
                averageScore: 85
                min: 0
                max: 100
                summaryText: Good performance
          externalOpportunity:
            uuid: opp-uuid-456
            title: Enterprise Deal - Acme Corp
          importMetadata: {}
          linkedCrmRecords:
            - id: 001ABC123
              code: Account
          externalAccounts:
            - id: 001ACC456
              code: Account
          externalContacts:
            - id: 003CON789
              code: Contact
          extractedIntelligence: {}
          confirmedExtractedIntelligence: {}
          labels: {}
          labelTagsToFilterIfNA: []
          deprecatedLabelCategories: []
        links:
          self: /v2/conversations/conv-uuid-123
    Links:
      type: object
      properties:
        self:
          type: string
        related:
          type: string
      example:
        self: https://api.attention.tech/v2/conversations/123
        related: https://api.attention.tech/v2/conversations/123/participants
    Meta:
      type: object
      properties:
        pageCount:
          type: integer
        totalRecords:
          type: integer
        pageNumber:
          type: integer
        pageSize:
          type: integer
      example:
        pageCount: 5
        totalRecords: 100
        pageNumber: 1
        pageSize: 20
    ConversationBoard:
      type: object
      properties:
        uuid:
          type: string
        board:
          $ref: '#/components/schemas/Board'
        battlecards:
          type: array
          items:
            $ref: '#/components/schemas/ConversationBoardBattlecard'
      example:
        uuid: cb-uuid-123
        board:
          uuid: board-uuid-456
          name: Sales Playbook
          teamUUID: team-uuid-789
          columns: []
        battlecards:
          - uuid: cbb-uuid-1
            activatedBattlecardID: bc-uuid-1
            feedbackAction: helpful
            hidden: false
    ConversationTalktrack:
      type: object
      properties:
        uuid:
          type: string
        items:
          type: array
          items:
            $ref: '#/components/schemas/ConversationTalktrackItem'
      example:
        uuid: ct-uuid-123
        items:
          - uuid: cti-uuid-1
            activatedItemId: item-uuid-456
            done: true
    User:
      type: object
      properties:
        uuid:
          type: string
          description: The unique identifier of the user.
          example: 123e4567-e89b-12d3-a456-426614174000
        email:
          type: string
          description: The email address of the user.
          example: user@example.com
        firstName:
          type: string
          description: The first name of the user.
          example: John
        lastName:
          type: string
          description: The last name of the user.
          example: Doe
        createdAt:
          type: string
          description: The date and time the user was created.
          example: '2021-01-01T00:00:00Z'
        deletedAt:
          type: string
          description: The date and time the user was deactivated.
          example: '2021-01-01T00:00:00Z'
        transcriptLang:
          type: string
          description: The preferred transcript language for the user.
          example: en-US
        joinOutsideHostMeetings:
          type: boolean
          description: >-
            Indicates if the user can join meetings outside their host
            organization.
          example: true
        realTimeCapabilities:
          type: boolean
          description: Indicates if the user has real-time transcription capabilities.
          example: false
        settings:
          $ref: '#/components/schemas/UserSettings'
        botName:
          type: string
          description: The name of the bot associated with the user.
          example: MyBot
        botImageURL:
          type: string
          description: The URL of the bot's profile image.
          example: https://example.com/bot.png
        primaryTeamUUID:
          type: string
          description: The UUID of the user's primary team.
          example: primary-team-uuid-12345
        organizationRoleUUID:
          type: string
          description: The UUID of the user's role in the organization.
          example: org-role-uuid-56789
        roles:
          type: array
          description: A list of roles assigned to the user.
          items:
            $ref: '#/components/schemas/Role'
        showReferralScreen:
          type: boolean
          description: Whether the user is shown a referral screen.
          example: false
        seatType:
          type: string
          description: The type of seat assigned to the user.
          example: admin
        teams:
          type: array
          description: A list of teams assigned to the user.
          items:
            $ref: '#/components/schemas/Team'
      example:
        uuid: 123e4567-e89b-12d3-a456-426614174000
        email: user@example.com
        firstName: John
        lastName: Doe
        createdAt: '2021-01-01T00:00:00Z'
        transcriptLang: en-US
        joinOutsideHostMeetings: true
        realTimeCapabilities: false
        botName: MyBot
        botImageURL: https://example.com/bot.png
        primaryTeamUUID: primary-team-uuid-12345
        organizationRoleUUID: org-role-uuid-56789
        showReferralScreen: false
        seatType: admin
    Team:
      type: object
      properties:
        uuid:
          type: string
          description: Unique identifier of the team
          example: fe515723-fe2e-4959-a5fa-c4d3937fe7e4
        name:
          type: string
          description: Name of the team
          example: Engineering
        phrases:
          type: array
          description: List of keywords or phrases associated with the team
          example:
            - engineering
            - tech
            - development
          items:
            type: string
        slackConnection:
          $ref: '#/components/schemas/SlackConnection'
        domain:
          type: string
          description: Domain associated with the team
          example: attention.tech
        organizerJoinInternalMeetings:
          type: boolean
          description: Whether team organizers can join internal meetings
          example: true
        consentEmailEnabled:
          type: boolean
          description: Whether email consent is enabled for the team
          example: true
        parentTeamUUID:
          type: string
          description: UUID of the parent team if this team is part of a hierarchy
          example: 2ccf9bde-68e3-4de4-bc4e-51b927336665
        organizationUUID:
          type: string
          description: UUID of the organization this team belongs to
          example: 16b78cec-82ef-46d2-8213-5d3bb7d2571c
        children:
          type: array
          description: List of child teams if this team has a hierarchical structure
          items:
            $ref: '#/components/schemas/Team'
      description: >-
        Represents a team in the system with its properties and hierarchical
        structure
      example:
        uuid: fe515723-fe2e-4959-a5fa-c4d3937fe7e4
        name: Engineering
        phrases:
          - engineering
          - tech
          - development
        domain: attention.tech
        organizerJoinInternalMeetings: true
        consentEmailEnabled: true
        parentTeamUUID: 2ccf9bde-68e3-4de4-bc4e-51b927336665
        organizationUUID: 16b78cec-82ef-46d2-8213-5d3bb7d2571c
    ExtractedIntelligenceItem:
      type: object
      properties:
        id:
          type: string
        key:
          type: string
        value:
          type: string
        title:
          type: string
        category:
          type: string
        refreshing:
          type: boolean
        options:
          $ref: '#/components/schemas/IntelligenceItemOptionalValues'
        source:
          type: string
        scope_insight:
          type: string
      example:
        id: intel_123
        key: budget
        value: '50000'
        title: Budget Range
        category: financial
        refreshing: false
        options:
          values:
            - '30000'
            - '50000'
            - '100000'
          maxValues: 1
        source: conversation
        scope_insight: Customer mentioned budget range of $50,000
    CrmExportStatus:
      type: string
      example: PENDING
      enum:
        - PENDING
        - EXPORTED
        - DISMISSED
    CRMExportOpportunity:
      type: object
      properties:
        uuid:
          type: string
        title:
          type: string
      example:
        uuid: opp-uuid-456
        title: Enterprise Deal - Acme Corp
    VideoStatus:
      type: string
      example: PENDING
      enum:
        - PENDING
        - UNAVAILABLE
        - IMPORTING
        - READY
    ConversationBot:
      type: object
      properties:
        uuid:
          type: string
        status:
          $ref: '#/components/schemas/BotStatus'
        meetingUrl:
          type: string
          description: The original meeting URL used to invite the bot
      example:
        uuid: bot-uuid-123
        meetingUrl: https://zoom.us/j/1234567890
        status:
          code: completed
          message: Recording uploaded successfully
          createdAt: '2024-03-18T14:30:00Z'
    Participant:
      type: object
      properties:
        id:
          type: string
        email:
          type: string
        organizer:
          type: boolean
        name:
          type: string
        status:
          type: string
      example:
        id: part-uuid-123
        email: john@customer.com
        name: John Smith
        organizer: true
        status: accepted
    ConversationImportStatus:
      type: string
      example: NONE
      enum:
        - NONE
        - PENDING
        - IN_PROGRESS
        - FINISHED
        - DISCARDED
        - FAILED
    ScorecardResult:
      type: object
      properties:
        uuid:
          type: string
        title:
          type: string
        summary:
          $ref: '#/components/schemas/ScorecardResultSummary'
        items:
          type: array
          items:
            $ref: '#/components/schemas/ScorecardItemResult'
      example:
        uuid: sr-uuid-123
        title: Sales Discovery Scorecard
        items:
          - uuid: sir-uuid-1
            scorecardItemUUID: si-uuid-1
            title: Discovery Quality
            description: Strong questioning
            status: completed
            type: numeric
            position: 1
            numericResult:
              score: 90
              min: 0
              max: 100
            evidences:
              - Asked about budget
        summary:
          averageScore: 87.5
          min: 0
          max: 100
          summaryText: Above average performance
    LinkedCrmRecord:
      required:
        - code
        - id
      type: object
      properties:
        id:
          type: string
        code:
          type: string
      example:
        id: 001ABC123
        code: Account
    ZoomMetadata:
      required:
        - calleeName
        - calleeNumber
        - callerName
        - callerNumber
      type: object
      properties:
        calleeName:
          type: string
        calleeNumber:
          type: string
        callerName:
          type: string
        callerNumber:
          type: string
      example:
        callerName: Jane Smith
        callerNumber: '+14155551234'
        calleeName: John Doe
        calleeNumber: '+14155555678'
    Board:
      type: object
      properties:
        uuid:
          type: string
        name:
          type: string
        columns:
          type: array
          items:
            $ref: '#/components/schemas/Column'
        team:
          $ref: '#/components/schemas/Team'
        teamUUID:
          type: string
      example:
        uuid: board-uuid-123
        name: Sales Playbook
        teamUUID: team-uuid-456
        columns:
          - id: col-uuid-1
            title: Discovery
            children:
              - uuid: bc-uuid-1
                text: Budget questions
                response: Ask about budget range
                keywords:
                  - budget
    ConversationBoardBattlecard:
      type: object
      properties:
        uuid:
          type: string
        activatedBattlecardID:
          type: string
        hidden:
          type: boolean
        feedbackAction:
          type: string
      example:
        uuid: cbb-uuid-123
        activatedBattlecardID: bc-uuid-456
        feedbackAction: helpful
        hidden: false
    ConversationTalktrackItem:
      type: object
      properties:
        uuid:
          type: string
        activatedItemId:
          type: string
        done:
          type: boolean
      example:
        uuid: cti-uuid-1
        activatedItemId: item-uuid-456
        done: true
    UserSettings:
      type: object
      properties:
        realTimeCapabilitiesOFF:
          type: boolean
        autoCalculateCRMFields:
          type: boolean
        joinWhenIAmHostAndAlone:
          type: boolean
        joinWhenIAmHostWithPeers:
          type: boolean
        joinWhenPeerIsHost:
          type: boolean
        joinWhenUnlicensedPeerIsHost:
          type: boolean
        dealsEnabled:
          type: boolean
      example:
        realTimeCapabilitiesOFF: true
        autoCalculateCRMFields: true
        joinWhenIAmHostAndAlone: true
        joinWhenIAmHostWithPeers: true
        joinWhenPeerIsHost: true
        joinWhenUnlicensedPeerIsHost: true
        dealsEnabled: true
    Role:
      type: object
      properties:
        uuid:
          type: string
        name:
          type: string
        type:
          type: string
      example:
        uuid: 84e67f54-5157-442b-a2b3-8b9c728b2fef
        name: Admin
        type: ADMIN
    SlackConnection:
      type: object
      properties:
        id:
          type: string
          description: Slack connection identifier
          example: T1234567890
        info:
          $ref: '#/components/schemas/SlackTeamInfo'
      description: Represents the Slack integration details for a team
      example:
        id: T1234567890
        info:
          id: T01234567
          name: Acme Corp
    IntelligenceItemOptionalValues:
      type: object
      properties:
        values:
          type: array
          items:
            type: string
        maxValues:
          type: integer
      example:
        values:
          - '30000'
          - '50000'
          - '100000'
        maxValues: 1
    BotStatus:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
        createdAt:
          type: string
          format: date-time
      example:
        code: BOT_READY
        message: Bot is ready to process requests
        createdAt: '2024-03-20T10:00:00Z'
    ScorecardResultSummary:
      type: object
      properties:
        min:
          type: integer
        max:
          type: integer
        averageScore:
          type: number
          format: float
        summaryText:
          type: string
      example:
        averageScore: 82.5
        min: 0
        max: 100
        summaryText: Strong performance across all categories
    ScorecardItemResult:
      type: object
      properties:
        uuid:
          type: string
        title:
          type: string
        status:
          $ref: '#/components/schemas/ScorecardItemResultStatus'
        type:
          $ref: '#/components/schemas/ScorecardType'
        position:
          type: integer
        numericResult:
          $ref: '#/components/schemas/NumericScorecardResult'
        description:
          type: string
        evidences:
          type: array
          items:
            type: string
        scorecardItemUUID:
          type: string
      example:
        uuid: sir-uuid-123
        scorecardItemUUID: si-uuid-456
        title: Discovery Quality
        description: Strong questioning technique
        status: completed
        type: numeric
        position: 1
        numericResult:
          score: 90
          min: 0
          max: 100
        evidences:
          - Asked about budget timeline
          - Identified key stakeholders
    Column:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        children:
          type: array
          items:
            $ref: '#/components/schemas/Battlecard'
      example:
        id: col-uuid-123
        title: Discovery
        children:
          - uuid: bc-uuid-1
            text: Budget questions
            response: Ask about allocated budget range
            keywords:
              - budget
              - spend
    SlackTeamInfo:
      type: object
      properties:
        id:
          type: string
          description: Slack team identifier
          example: T1234567890
        name:
          type: string
          description: Name of the Slack team
          example: Attention Tech
      description: Information about a connected Slack team
      example:
        id: T01234567
        name: Acme Corp
    ScorecardItemResultStatus:
      type: string
      example: CALCULATED
      enum:
        - CALCULATED
        - CALCULATING
    ScorecardType:
      type: string
      example: NUMERIC
      enum:
        - NUMERIC
    NumericScorecardResult:
      type: object
      properties:
        min:
          type: integer
        max:
          type: integer
        score:
          type: integer
      example:
        score: 85
        min: 0
        max: 100
    Battlecard:
      type: object
      properties:
        uuid:
          type: string
        keywords:
          type: array
          items:
            type: string
        response:
          type: string
        text:
          type: string
      example:
        uuid: bc-uuid-123
        text: Competitor mentions lower pricing
        response: Emphasize our ROI advantage and total cost of ownership
        keywords:
          - pricing
          - competitor
          - cost
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      name: Authorization
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.