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

# Import Audio Review

> Import an audio review manually into the workspace. All fields are optional. If `type` is 'file', then `attachments[]` (audio files) is required. If `type` is not 'file' or omitted, then `attachment_urls[]` is required.



## OpenAPI

````yaml POST /imports/self-imports/audio-review
openapi: 3.1.0
info:
  title: Feedspace API
  description: Feedspace API v3 - Feedback and testimonial management platform
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.feedspace.io/v3
security: []
paths:
  /imports/self-imports/audio-review:
    post:
      tags:
        - Imports
      description: >-
        Import an audio review manually into the workspace. All fields are
        optional. If `type` is 'file', then `attachments[]` (audio files) is
        required. If `type` is not 'file' or omitted, then `attachment_urls[]`
        is required.
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/AudioReviewImportRequest'
      responses:
        '200':
          description: >-
            Audio review imported successfully.


            This endpoint also returns 200 when the import fails. In that case
            the body is `{ "data": { "error": "Failed to store reviews." } }`
            instead of the imported review, so check for a `data.error` key
            rather than relying on the status code alone.
          content:
            application/json:
              schema:
                type: object
              examples:
                success:
                  value:
                    data:
                      project_id: 5020
                      social_platform_id: 54
                      source: Manual Audio Review
                      is_feed_imported: 1
                      user_id: 7243
                      created_at: '2025-06-18T12:58:29.000000Z'
                      id: 4586
                      social_platform:
                        slug: manual_audio_review
                        name: Manual Audio Review
                        review_type: 1
                      social_feeds:
                        - id: 179023
                          unique_feedback_id: QDU5g5
                          feed_type: manual_audio
                          review: Great product, the onboarding call was very helpful.
                          review_url: https://www.feedspace.io/
                          rating: 5
                          rating_type: 1
                          customer_name: User
                          customer_email: developer@feedspace.io
                          customer_company: Feedspace
                          customer_designation: Engineer
                          review_at: '2025-06-18 12:58:29'
                          created_at: '2025-06-18T12:58:29.000000Z'
      security:
        - basicAuth: []
components:
  schemas:
    AudioReviewImportRequest:
      type: object
      description: >-
        Request body for importing an audio review manually. All fields are
        optional. If `type` is 'file', then `attachments[]` (audio files) is
        required. If `type` is not 'file' or omitted, then `attachment_urls[]`
        is required.
      properties:
        customer_avatar:
          type: string
          format: binary
          description: >-
            Customer avatar image (optional). Allowed formats: jpeg, png, jpg,
            gif, svg, webp, bmp, avif. Max size: 15 MB
        customer_name:
          type: string
          maxLength: 255
          description: Customer name (optional)
        customer_email:
          type: string
          format: email
          maxLength: 255
          description: Customer email (optional, must be valid email format)
        customer_designation:
          type: string
          maxLength: 255
          description: Customer designation/job title (optional)
        customer_company:
          type: string
          maxLength: 255
          description: Customer company name (optional)
        customer_company_url:
          type: string
          maxLength: 255
          description: >-
            Customer company website URL (optional). The scheme is optional, so
            a bare domain such as example.com is accepted.
        customer_company_logo:
          type: string
          format: binary
          description: >-
            Customer company logo image (optional). Allowed formats: jpeg, png,
            jpg, gif, svg, webp, bmp, avif. Max size: 15 MB
        rating:
          type: number
          minimum: 0
          maximum: 5
          description: >-
            Rating value (0 = lowest, 5 = highest, optional). Decimal values
            such as 4.5 are accepted.
        review_url:
          type: string
          format: uri
          maxLength: 255
          description: Review source URL (optional)
        review:
          type: string
          description: Review text content (optional)
        review_at:
          type: string
          format: date
          description: Date when the review was submitted (YYYY-MM-DD format, optional)
        website_logo:
          type: string
          format: binary
          description: >-
            Website logo image (optional). Allowed formats: jpeg, png, jpg, gif,
            svg, webp, bmp, avif. Max size: 15 MB
        type:
          type: string
          description: >-
            Import mode. Use 'file' to upload audio files via `attachments[]`;
            omit or use another value to reference previously uploaded Feedspace
            media via `attachment_urls[]` (optional).
        attachments[]:
          type: string
          format: binary
          description: >-
            Audio files (required if type='file'). Must be valid audio files
            (audio mime types).
          nullable: true
        attachment_urls[]:
          type: string
          format: uri
          description: >-
            Feedspace-hosted media URLs for the audio (required when type is not
            'file'). Each must be a URL returned by a prior Feedspace upload;
            arbitrary external URLs are rejected.
          nullable: true
      required: []
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        HTTP Basic Authentication using API Key and Secret Key. The credentials
        should be Base64 encoded in the format 'api_key:secret_key'. You can
        obtain your API Key and Secret Key from Feedspace → Automation → API
        (https://app.feedspace.io/automation/api).

````