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

# Update Talking Points

> Replaces the text of one or more existing Talking Points. Talking Points not listed are left unchanged. Text limit: 750 characters. Returns one result per requested element, in request order: the saved Talking Point, or the reason that element was not applied (access, plan cap, not found). Other elements are unaffected. Talking Points feed comment generation only — never direct messages. The change applies to future generations only: an already-generated comment draft keeps its text until it is regenerated (`comments_generate-or-improve-draft`).



## OpenAPI

````yaml https://api.goextrovert.com/client/v2/docs-json patch /client/v2/voice-talking-points
openapi: 3.1.0
info:
  title: Extrovert Client API
  description: >-
    Public API for Extrovert platform integration. Use your API key for
    authentication.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.goextrovert.com/
    description: API Server
security: []
tags: []
paths:
  /client/v2/voice-talking-points:
    patch:
      tags:
        - Voice Talking Points
      summary: Update Talking Points
      description: >-
        Replaces the text of one or more existing Talking Points. Talking Points
        not listed are left unchanged. Text limit: 750 characters. Returns one
        result per requested element, in request order: the saved Talking Point,
        or the reason that element was not applied (access, plan cap, not
        found). Other elements are unaffected. Talking Points feed comment
        generation only — never direct messages. The change applies to future
        generations only: an already-generated comment draft keeps its text
        until it is regenerated (`comments_generate-or-improve-draft`).
      operationId: VoiceTalkingPointClientApiController_update
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateRequestDto7'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateResponseDto7'
        '401':
          description: Invalid or missing API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClientApiErrorResponseDto'
      security:
        - api-key: []
components:
  schemas:
    UpdateRequestDto7:
      type: object
      properties:
        items:
          type: array
          minItems: 1
          maxItems: 25
          items:
            type: object
            properties:
              id:
                type: string
                format: uuid
                description: >-
                  Talking point to replace on its shared Voice; future comment
                  generations across its campaigns and workspaces can use the
                  change.
              text:
                type: string
                minLength: 1
                description: New Talking Point text. Up to 750 characters.
            required:
              - id
              - text
          description: >-
            Elements to apply, 1 to 25. Each element is applied on its own and
            gets its own result, in the same order; a failed element does not
            affect the others.
      required:
        - items
    UpdateResponseDto7:
      type: object
      properties:
        status:
          type: string
          const: success
          description: Response status
        data:
          type: array
          items:
            type: object
            properties:
              index:
                type: integer
                minimum: 0
                maximum: 9007199254740991
                description: Position of the element in the request list, starting at 0.
              id:
                description: >-
                  Element ID. Present for every updated or deleted element, and
                  for a created element once it was saved.
                type: string
                format: uuid
              item:
                description: The element as saved. Absent when the element failed.
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    description: Talking Point ID
                    examples:
                      - 8d256aa6-9b12-49a7-93ee-bf41634b5b60
                  updatedAt:
                    type: string
                    description: Talking Point update timestamp
                    examples:
                      - '2025-06-30T14:02:07.456Z'
                      - '2025-07-03T08:30:00.000Z'
                  createdAt:
                    type: string
                    description: Talking Point creation timestamp
                    examples:
                      - '2025-06-30T14:02:07.456Z'
                      - '2025-07-03T08:30:00.000Z'
                  text:
                    type: string
                    description: >-
                      A single idea, fact, or point of view used as context when
                      generating comments — industry observations, product
                      benefits, hot takes, advice you'd give peers, thoughts
                      that add value. All Talking Points attached to the parent
                      Voice are used together as comment-generation context. Up
                      to 750 characters.
                  voiceId:
                    type: string
                    format: uuid
                    description: >-
                      ID of the Voice this Talking Point belongs to. See the
                      `voices` config for the full Voice shape. When the Voice
                      is deleted, all its Talking Points are deleted in cascade.
                    examples:
                      - cf33282b-b171-4d23-ae02-848499d793e4
                required:
                  - id
                  - updatedAt
                  - createdAt
                  - text
                  - voiceId
              error:
                description: >-
                  Why this element was not applied. Absent when the element
                  succeeded; the other elements are unaffected.
                type: object
                properties:
                  code:
                    type: string
                    description: >-
                      Status name of the failure, e.g. `NOT_FOUND`,
                      `PERMISSION_DENIED`, `INVALID_ARGUMENT`, `INTERNAL`.
                  message:
                    type: string
                    description: Human-readable reason this element was not applied.
                required:
                  - code
                  - message
            required:
              - index
          description: One result per requested Talking Point, in request order
        message:
          type: string
          description: Success message
          examples:
            - Operation completed successfully
      required:
        - status
        - data
        - message
    ClientApiErrorResponseDto:
      type: object
      properties:
        status:
          type: string
          description: Response status
          example: error
          enum:
            - error
        data:
          type: object
          description: Response data
          example: null
          nullable: true
        message:
          type: string
          description: Error message
          example: An error occurred while processing the request
      required:
        - status
        - data
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-Key
      description: API Key for authentication

````

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