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

# Get Voice Clip Upload Parts

> Resume an interrupted upload: which parts landed, and fresh URLs for the rest.

S3 is the authority on what survived, so a client that lost its progress asks here
instead of restarting from part 1.



## OpenAPI

````yaml https://api.usetuner.ai/public/openapi.json get /api/v1/workspaces/{workspace_id}/agents/{agent_id}/voice-clip-uploads/{voice_clip_upload_id}/parts
openapi: 3.1.0
info:
  title: My Public API
  version: 1.0.0
servers:
  - url: https://api.usetuner.ai
security: []
tags:
  - name: calls
    x-group: Calls
  - name: workspaces
    x-group: Workspaces
  - name: simulation
    x-group: Simulation
  - name: agent-settings
    x-group: Agent Settings
  - name: agents
    x-group: Agents
  - name: scenarios
    x-group: Scenarios
  - name: traces
    x-group: Traces
  - name: providers
    x-group: Providers
paths:
  /api/v1/workspaces/{workspace_id}/agents/{agent_id}/voice-clip-uploads/{voice_clip_upload_id}/parts:
    get:
      tags:
        - simulation
      summary: Get Voice Clip Upload Parts
      description: >-
        Resume an interrupted upload: which parts landed, and fresh URLs for the
        rest.


        S3 is the authority on what survived, so a client that lost its progress
        asks here

        instead of restarting from part 1.
      operationId: >-
        get_voice_clip_upload_parts_api_v1_workspaces__workspace_id__agents__agent_id__voice_clip_uploads__voice_clip_upload_id__parts_get
      parameters:
        - name: voice_clip_upload_id
          in: path
          required: true
          schema:
            type: integer
            title: Voice Clip Upload Id
        - name: agent_id
          in: path
          required: true
          schema:
            type: integer
            description: Tuner's internal numeric ID for the agent.
            title: Agent Id
          description: Tuner's internal numeric ID for the agent.
        - name: workspace_id
          in: path
          required: true
          schema:
            type: integer
            description: Workspace ID. Find this in Workspace > General Settings.
            title: Workspace Id
          description: Workspace ID. Find this in Workspace > General Settings.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceClipUploadPartsResponse'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              example:
                detail: Not authenticated
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: You do not have access to this workspace.
          content:
            application/json:
              example:
                detail: User does not have access to workspace 42
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Agent or upload not found.
          content:
            application/json:
              example:
                detail: Voice clip upload with ID 9 not found
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: The upload has already been completed or aborted.
          content:
            application/json:
              example:
                detail: >-
                  Voice clip upload 9 has no upload in progress
                  (status='uploaded').
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '503':
          description: The S3 upload signer is not configured in this environment.
          content:
            application/json:
              example:
                detail: Audio uploads are not available in this environment.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - Bearer: []
components:
  schemas:
    VoiceClipUploadPartsResponse:
      properties:
        upload_id:
          type: integer
          title: Upload Id
        part_size_bytes:
          type: integer
          title: Part Size Bytes
        uploaded_part_numbers:
          items:
            type: integer
          type: array
          title: Uploaded Part Numbers
          description: Parts S3 confirms it already holds.
        parts:
          items:
            $ref: '#/components/schemas/VoiceClipUploadPart'
          type: array
          title: Parts
          description: Fresh presigned URLs for the parts still missing.
        expires_at:
          type: string
          format: date-time
          title: Expires At
      type: object
      required:
        - upload_id
        - part_size_bytes
        - expires_at
      title: VoiceClipUploadPartsResponse
      description: >-
        The resume read model: what S3 already has, and fresh URLs for what it
        does not.
    ErrorResponse:
      properties:
        detail:
          type: string
          title: Detail
          description: Human-readable description of what went wrong.
      type: object
      required:
        - detail
      title: ErrorResponse
      description: Error body returned when a request fails.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    VoiceClipUploadPart:
      properties:
        part_number:
          type: integer
          minimum: 1
          title: Part Number
          description: 1-based part index.
        url:
          type: string
          title: Url
          description: Presigned PUT URL. Treat as a credential; do not log.
      type: object
      required:
        - part_number
        - url
      title: VoiceClipUploadPart
      description: One part of the multipart upload, as offered to the client.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    Bearer:
      type: http
      description: >-
        Use Tuner API key (tr_api_...) or user session token. Find your API key
        in Workspace Settings > API Keys.
      scheme: bearer

````

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