---
title: "Import provider audio into workspace media"
method: POST
path: "/audio-library/import"
tags: ["Platform"]
---

# Import provider audio into workspace media

`POST /audio-library/import`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/audio-library/import`
- Auth: API key in header `Authorization`

Import provider audio into workspace media.

## Request body

- object
  - `provider` 'openverse' | 'freesound' | 'wikimedia' | 'remotion', required
  - `external_id` string, required
  - `folder_id` string, uuid, nullable
  - `project_id` string, uuid, nullable
  - `start_seconds` number
  - `duration_seconds` number, nullable
  - `volume` number
  - `fade_in_seconds` number
  - `fade_out_seconds` number
  - `loop` boolean
  - `audio_type` 'music' | 'sound_effect' | 'ambient' | 'other'

## Response `200`

Successful response

- object
  - `asset` object, required
    - `id` string, required
    - `name` string, required
    - `asset_type` 'audio', required
    - `audio_type` string, required
    - `duration_seconds` number, nullable, required
    - `source_url` string, required
    - `license_code` string, required
    - `license_url` string, nullable, required
    - `attribution_text` string, nullable, required
  - `imported` boolean, required
  - `deduped` boolean, required
  - `timeline_item_id` string, nullable, required
  - `txid` number, nullable, required
  - `provider_request` object, required
    - `provider` 'openverse' | 'freesound' | 'wikimedia' | 'remotion', required
    - `external_id` string, required
    - `retryable` boolean, required
    - `imported_at` string, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `500`: Internal server error

---

[API](https://skmtc.dev/blitzreels/apis/blitzreels-api.md) · [All operations](https://skmtc.dev/blitzreels/apis/blitzreels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blitzreels/apis/blitzreels-api/revisions/35608b12471d?raw)