> ## 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.

# Change Conversation Title

> Updates the title of an existing conversation. The conversation is re-indexed in search after the title change.



## OpenAPI

````yaml put /conversations/{id}/title
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/{id}/title:
    put:
      tags:
        - Conversation
      summary: Change Conversation Title
      description: >-
        Updates the title of an existing conversation. The conversation is
        re-indexed in search after the title change.
      operationId: changeConversationTitle
      parameters:
        - name: id
          in: path
          description: UUID of the conversation to update
          required: true
          schema:
            type: string
      requestBody:
        description: New title for the conversation
        content:
          application/json:
            schema:
              required:
                - title
              type: object
              properties:
                title:
                  type: string
                  description: The new title for the conversation
                  example: Q4 Sales Review with Acme Corp
          application/vnd.api+json:
            schema:
              required:
                - title
              type: object
              properties:
                title:
                  type: string
                  description: The new title for the conversation
                  example: Q4 Sales Review with Acme Corp
        required: true
      responses:
        '200':
          description: Title updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Conversation'
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/Conversation'
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/Error'
        '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'
        '404':
          description: Conversation not found
          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:
    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
            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
    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
    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'
    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
    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

````