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

# Create speaker verification evidence

> Uploads an evidence file for a speaker verification



## OpenAPI

````yaml post /organization/voices/{voice_id}/speaker_verification/evidences
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/evidences:
    parameters:
      - name: voice_id
        in: path
        required: true
        description: Voice ID
        schema:
          type: string
    post:
      tags:
        - Speaker Verification Evidences
      summary: Create
      description: Uploads an evidence file for a speaker verification
      operationId: organization/voices/speaker_verification/evidences#create
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/requestBodySpeakerVerificationEvidence'
            examples:
              example:
                $ref: >-
                  #/components/examples/requestSpeakerVerificationEvidenceExample
      responses:
        '201':
          description: Created
          content:
            application/json:
              examples:
                example:
                  $ref: '#/components/examples/speakerVerificationEvidenceExample'
              schema:
                $ref: '#/components/schemas/speakerVerificationEvidenceModel'
        '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'
        '422':
          description: Unprocessable entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
      security:
        - apiKey: []
components:
  schemas:
    requestBodySpeakerVerificationEvidence:
      type: object
      properties:
        file:
          type: object
          description: Evidence file reference
          properties:
            url:
              type: string
              description: URL of the evidence file to upload
    speakerVerificationEvidenceModel:
      type: object
      properties:
        id:
          type: integer
          description: Unique identifier for the object
        speaker_verification_id:
          type: integer
          description: ID of the speaker verification this evidence belongs to
        file:
          type: object
          description: Evidence file
          nullable: true
          properties:
            url:
              type: string
              description: URL of the uploaded evidence 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:
    requestSpeakerVerificationEvidenceExample:
      summary: Sample upload of a speaker verification evidence
      value:
        file:
          url: https://example.com/evidence.jpg
    speakerVerificationEvidenceExample:
      summary: A sample speaker verification evidence response
      value:
        id: 1
        speaker_verification_id: 10
        file:
          url: https://example.com/evidence.jpg
        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

````