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

# Update speaker verification

> Updates the speaker verification for a voice



## OpenAPI

````yaml put /organization/voices/{voice_id}/speaker_verification
openapi: 3.0.1
info:
  title: BeyondWords REST API
  description: |-
    This is the documentation for the BeyondWords REST API.
              You can use this API to use BeyondWords programmatically.
              You can get your API Key and Project ID for each project in the Project settings tab in the BeyondWords
              <a href="https://dash.beyondwords.io/dashboard">dashboard</a>.
  version: 1.0.0
servers:
  - url: https://api.beyondwords.io/v1
security: []
paths:
  /organization/voices/{voice_id}/speaker_verification:
    parameters:
      - name: voice_id
        in: path
        required: true
        description: Voice ID
        schema:
          type: string
    put:
      tags:
        - Speaker Verifications
      summary: Update
      description: Updates the speaker verification for a voice
      operationId: organization/voices/speaker_verification#update
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/requestBodySpeakerVerification'
            examples:
              example:
                $ref: '#/components/examples/requestSpeakerVerificationExample'
      responses:
        '200':
          description: OK
          content:
            application/json:
              examples:
                example:
                  $ref: '#/components/examples/speakerVerificationExample'
              schema:
                $ref: '#/components/schemas/speakerVerificationModel'
        '401':
          description: Invalid authentication token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
      security:
        - apiKey: []
components:
  schemas:
    requestBodySpeakerVerification:
      type: object
      properties:
        note:
          type: string
          description: Optional note about the verification
          nullable: true
        consent_statement:
          type: object
          description: Consent statement file reference
          nullable: true
          properties:
            url:
              type: string
              description: URL of the consent statement file
    speakerVerificationModel:
      type: object
      properties:
        id:
          type: integer
          description: Unique identifier for the object
        voice_id:
          type: integer
          description: ID of the voice this verification belongs to
        note:
          type: string
          description: Optional note about the verification
          nullable: true
        consent_statement:
          type: object
          description: Consent statement file
          nullable: true
          properties:
            url:
              type: string
              description: URL of the uploaded consent statement file
        created:
          type: string
          description: Time at which the object was created (ISO 8601)
        updated:
          type: string
          description: Time at which the object was updated (ISO 8601)
    errorModel:
      type: object
      properties:
        code:
          type: integer
          description: Error code
        message:
          type: string
          description: Error message
        errors:
          type: array
          nullable: true
          items:
            type: object
            properties:
              location:
                type: string
              message:
                type: string
  examples:
    requestSpeakerVerificationExample:
      summary: Sample creation or update of a speaker verification
      value:
        note: Verified by legal team
        consent_statement:
          url: https://example.com/consent.pdf
    speakerVerificationExample:
      summary: A sample speaker verification response
      value:
        id: 1
        voice_id: 42
        note: Verified by legal team
        consent_statement:
          url: https://example.com/consent.pdf
        created: 2024-01-01 00:00:00 UTC
        updated: 2024-01-01 00:00:05 UTC
  securitySchemes:
    apiKey:
      type: apiKey
      name: X-Api-Key
      in: header

````