> ## 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 GI History

> Retrieves the history of generalized insights for a specific user. This endpoint allows you to track and analyze the evolution of insights over time, with options to control the response format and pagination.



## OpenAPI

````yaml get /gi/history
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:
  /gi/history:
    get:
      tags:
        - General Insights
      summary: List GI History
      description: >-
        Retrieves the history of generalized insights for a specific user. This
        endpoint allows you to track and analyze the evolution of insights over
        time, with options to control the response format and pagination.
      operationId: listGIHistory
      parameters:
        - name: user_uuid
          in: query
          description: >-
            Unique identifier of the user whose insight history is being
            requested
          required: true
          schema:
            type: string
        - name: withoutEnhancingResults
          in: query
          description: >-
            When set to true, returns raw insight data without additional
            processing or enhancement
          schema:
            type: boolean
        - name: limit
          in: query
          description: Maximum number of history entries to return
          schema:
            type: integer
        - name: offset
          in: query
          description: Number of entries to skip before starting to collect the result set
          schema:
            type: integer
      responses:
        '200':
          description: Successfully retrieved the insight history
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GIHistoryResponse'
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/GIHistoryResponse'
        '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 while processing the request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    GIHistoryResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/GIHistory'
        links:
          $ref: '#/components/schemas/Links'
        meta:
          $ref: '#/components/schemas/Meta'
      example:
        data:
          - uuid: hist_123
            title: Sales Team Analysis
            results:
              - uuid: res_456
                synthesis: Team performance analysis for Q1
                prompt: Analyze sales team performance
                status: FINISHED
                items: []
                conversationsUsed:
                  - conv_789
                emailsUsed:
                  - email_123
                type: TEXT_WITH_SOURCES
                result: {}
        links:
          self: https://api.attention.tech/v2/gi/history
          related: https://api.attention.tech/v2/gi/history/related
        meta:
          pageCount: 1
          totalRecords: 1
          pageNumber: 1
          pageSize: 10
    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
    GIHistory:
      required:
        - results
        - title
        - uuid
      type: object
      properties:
        uuid:
          type: string
        user:
          type: object
          properties:
            uuid:
              type: string
        title:
          type: string
        results:
          type: array
          items:
            $ref: '#/components/schemas/GIResult'
        executionTemplate:
          $ref: '#/components/schemas/GIExecutionTemplate'
      example:
        uuid: hist_123
        user:
          uuid: user_456
        title: Sales Team Analysis
        results:
          - uuid: res_789
            synthesis: Team performance analysis for Q1
            prompt: Analyze sales team performance
            status: FINISHED
            items: []
            conversationsUsed:
              - conv_123
            emailsUsed:
              - email_456
            type: TEXT_WITH_SOURCES
            result: {}
        executionTemplate:
          uuid: template_123
          prompt: Analyze sales team performance
          period: WEEKLY
          lastExecutionAt: '2024-03-20T10:00:00Z'
          nextExecutionAt: '2024-03-27T10:00:00Z'
          createdAt: '2024-03-13T10:00:00Z'
    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
    GIResult:
      required:
        - conversationsUsed
        - emailsUsed
        - items
        - prompt
        - result
        - status
        - synthesis
        - type
        - uuid
      type: object
      properties:
        uuid:
          type: string
        synthesis:
          type: string
        prompt:
          type: string
        status:
          $ref: '#/components/schemas/GIStatus'
        filtersUsed:
          $ref: '#/components/schemas/GIFilters'
        items:
          type: array
          items:
            $ref: '#/components/schemas/GIResultItem'
        conversationsUsed:
          type: array
          items:
            type: string
        emailsUsed:
          type: array
          items:
            type: string
        type:
          $ref: '#/components/schemas/GIResultType'
        result:
          type: object
          properties: {}
      example:
        uuid: res_123
        synthesis: Analysis of sales team performance shows strong growth in Q1
        prompt: Analyze sales team performance
        status: FINISHED
        filtersUsed:
          teams:
            - teamUUID: team_123
              teamName: Sales Team A
          teamMembers:
            - teamMemberUUID: member_123
              teamMemberName: John
              teamMemberLastName: Doe
              teamMemberEmail: john.doe@example.com
          opportunities:
            - opportunityUUID: opp_123
              opportunityName: Enterprise Deal
          conversations:
            - conversationUUID: conv_123
              conversationTitle: Sales Review Meeting
          isInternal: false
          labels:
            - name: priority
              values:
                - high
        items:
          - uuid: item_123
            summary: Sales team achieved 120% of Q1 target
            evidence:
              conversationsEvidence:
                - type: CONVERSATION
                  conversationUUID: conv_123
                  conversationTitle: Sales Review Meeting
                  conversationQuotes:
                    - quote: We've exceeded our Q1 targets by 20%
                      reference:
                        startIdx: '0'
                        endIdx: '100'
        conversationsUsed:
          - conv_123
        emailsUsed:
          - email_123
        type: TEXT_WITH_SOURCES
        result:
          summary: Strong Q1 performance with 20% growth
    GIExecutionTemplate:
      required:
        - period
        - prompt
        - uuid
      type: object
      properties:
        uuid:
          type: string
        history:
          $ref: '#/components/schemas/GIHistory'
        filters:
          $ref: '#/components/schemas/GIExecutionTemplateFilters'
        user:
          $ref: '#/components/schemas/User'
        prompt:
          type: string
        period:
          $ref: '#/components/schemas/GIExecutionTemplatePeriod'
        lastExecutionAt:
          type: string
          format: date-time
        nextExecutionAt:
          type: string
          format: date-time
        createdAt:
          type: string
          format: date-time
      example:
        uuid: template_123
        prompt: Analyze sales team performance
        period: WEEKLY
        lastExecutionAt: '2024-03-20T10:00:00Z'
        nextExecutionAt: '2024-03-27T10:00:00Z'
        createdAt: '2024-03-13T10:00:00Z'
        filters:
          teams:
            - teamUUID: team_123
              teamName: Sales Team A
          teamMembers:
            - teamMemberUUID: member_123
              teamMemberName: John
              teamMemberLastName: Doe
              teamMemberEmail: john.doe@example.com
          opportunities:
            - opportunityUUID: opp_123
              opportunityName: Enterprise Deal
    GIStatus:
      type: string
      example: FINISHED
      enum:
        - PENDING
        - FINISHED
    GIFilters:
      required:
        - conversations
        - labels
        - opportunities
        - teamMembers
        - teams
      type: object
      properties:
        startDate:
          type: string
          format: date-time
        endDate:
          type: string
          format: date-time
        teams:
          type: array
          items:
            $ref: '#/components/schemas/GIFilterTeam'
        teamMembers:
          type: array
          items:
            $ref: '#/components/schemas/GIFilterTeamMember'
        opportunities:
          type: array
          items:
            $ref: '#/components/schemas/GIFilterOpportunities'
        conversations:
          type: array
          items:
            $ref: '#/components/schemas/GIFilterConversation'
        isInternal:
          type: boolean
        labels:
          type: array
          items:
            $ref: '#/components/schemas/GILabelFilter'
      example:
        startDate: '2024-03-01T00:00:00Z'
        endDate: '2024-03-31T23:59:59Z'
        teams:
          - teamUUID: team_123
            teamName: Sales Team A
        teamMembers:
          - teamMemberUUID: member_123
            teamMemberName: John
            teamMemberLastName: Doe
            teamMemberEmail: john.doe@example.com
        opportunities:
          - opportunityUUID: opp_123
            opportunityName: Enterprise Deal
        conversations:
          - conversationUUID: conv_123
            conversationTitle: Sales Review Meeting
        isInternal: false
        labels:
          - name: priority
            values:
              - high
    GIResultItem:
      required:
        - summary
        - uuid
      type: object
      properties:
        uuid:
          type: string
        summary:
          type: string
        evidence:
          $ref: '#/components/schemas/GIItemEvidence'
      example:
        uuid: item_123
        summary: Sales team achieved 120% of Q1 target
        evidence:
          conversationsEvidence:
            - type: CONVERSATION
              conversationUUID: conv_123
              conversationTitle: Sales Review Meeting
              conversationQuotes:
                - quote: We've exceeded our Q1 targets by 20%
                  reference:
                    startIdx: '0'
                    endIdx: '100'
    GIResultType:
      type: string
      example: TEXT_WITH_SOURCES
      enum:
        - LIST
        - TEXT_WITH_SOURCES
        - SINGLE_QUOTE
        - QUOTE_LIST
        - SUMMARY_TABLE
        - TABLE_QUOTES
    GIExecutionTemplateFilters:
      required:
        - opportunities
        - teamMembers
        - teams
      type: object
      properties:
        teams:
          type: array
          items:
            $ref: '#/components/schemas/GIFilterTeam'
        teamMembers:
          type: array
          items:
            $ref: '#/components/schemas/GIFilterTeamMember'
        opportunities:
          type: array
          items:
            $ref: '#/components/schemas/GIFilterOpportunities'
      example:
        teams:
          - teamUUID: team_123
            teamName: Sales Team A
        teamMembers:
          - teamMemberUUID: member_123
            teamMemberName: John
            teamMemberLastName: Doe
            teamMemberEmail: john.doe@example.com
        opportunities:
          - opportunityUUID: opp_123
            opportunityName: Enterprise Deal
    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
    GIExecutionTemplatePeriod:
      type: string
      example: WEEKLY
      enum:
        - WEEKLY
        - MONTHLY
    GIFilterTeam:
      required:
        - teamName
        - teamUUID
      type: object
      properties:
        teamUUID:
          type: string
        teamName:
          type: string
      example:
        teamUUID: team_123
        teamName: Sales Team A
    GIFilterTeamMember:
      required:
        - teamMemberEmail
        - teamMemberLastName
        - teamMemberName
        - teamMemberUUID
      type: object
      properties:
        teamMemberUUID:
          type: string
        teamMemberName:
          type: string
        teamMemberLastName:
          type: string
        teamMemberEmail:
          type: string
      example:
        teamMemberUUID: member_123
        teamMemberName: John
        teamMemberLastName: Doe
        teamMemberEmail: john.doe@example.com
    GIFilterOpportunities:
      required:
        - opportunityName
        - opportunityUUID
      type: object
      properties:
        opportunityUUID:
          type: string
        opportunityName:
          type: string
      example:
        opportunityUUID: opp_123
        opportunityName: Enterprise Deal
    GIFilterConversation:
      required:
        - conversationTitle
        - conversationUUID
      type: object
      properties:
        conversationUUID:
          type: string
        conversationTitle:
          type: string
      example:
        conversationUUID: conv_123
        conversationTitle: Sales Review Meeting
    GILabelFilter:
      required:
        - name
        - values
      type: object
      properties:
        name:
          type: string
        values:
          type: array
          items:
            type: string
      example:
        name: priority
        values:
          - high
          - medium
          - low
    GIItemEvidence:
      required:
        - conversationsEvidence
      type: object
      properties:
        conversationsEvidence:
          type: array
          items:
            $ref: '#/components/schemas/GIConversationEvidence'
      example:
        conversationsEvidence:
          - type: CONVERSATION
            conversationUUID: conv_123
            conversationTitle: Sales Review Meeting
            conversationQuotes:
              - quote: We've exceeded our Q1 targets by 20%
                reference:
                  startIdx: '0'
                  endIdx: '100'
    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
    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
    GIConversationEvidence:
      required:
        - conversationQuotes
        - conversationTitle
        - conversationUUID
        - type
      type: object
      properties:
        type:
          $ref: '#/components/schemas/GIEvidenceType'
        conversationUUID:
          type: string
        conversationTitle:
          type: string
        finishedAt:
          type: string
          format: date-time
        conversationQuotes:
          type: array
          items:
            $ref: '#/components/schemas/ConversationQuote'
      example:
        type: CONVERSATION
        conversationUUID: conv_123
        conversationTitle: Sales Review Meeting
        finishedAt: '2024-03-20T11:00:00Z'
        conversationQuotes:
          - quote: We've exceeded our Q1 targets by 20%
            reference:
              startIdx: '0'
              endIdx: '100'
    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
    GIEvidenceType:
      type: string
      example: CONVERSATION
      enum:
        - CONVERSATION
    ConversationQuote:
      required:
        - quote
      type: object
      properties:
        quote:
          type: string
        reference:
          $ref: '#/components/schemas/Range'
      example:
        quote: We've exceeded our Q1 targets by 20%
        reference:
          startIdx: '0'
          endIdx: '100'
    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
    Range:
      required:
        - endIdx
        - startIdx
      type: object
      properties:
        startIdx:
          type: string
        endIdx:
          type: string
      example:
        startIdx: '0'
        endIdx: '100'
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      name: Authorization
      in: header

````