---
title: "Upload external audio"
method: POST
path: "/v1/rooms/{room_sid}/artifacts/external-audio"
tags: ["rooms"]
---

# Upload external audio

`POST /v1/rooms/{room_sid}/artifacts/external-audio`

Upload external audio to overwrite Streem-recorded audio in recordings

## Path parameters

- `room_sid` string, required

## Request body

- StreemApiAcceptExternalAudioRequest
  - `filename` string
  - `start_time` string, date-time
  - `audio_file_url` string

## Response `200`

External audio uploaded

- StreemApiAcceptExternalAudioResponse
  - `recording_track` StreemApiArtifactRecordingTrack
    - `bucket` string
    - `filename` string
    - `user_sid` string
    - `track_type` string
    - `codec` string
    - `storage_url` string
    - `status` 'STATUS_STARTED_RECORDING' | 'STATUS_FINISHED_RECORDING' | 'STATUS_TRANSFERRING' | 'STATUS_ERROR' | 'STATUS_FULFILLED' | 'STATUS_INVALID'
    - `requested_at` string, date-time
    - `started_recording_at` string, date-time
    - `finished_recording_at` string, date-time
    - `started_transferring_at` string, date-time
    - `errored_at` string, date-time
    - `fulfilled_at` string, date-time
    - `url` string
    - `created_at` string, date-time
    - `recording_source` 'SOURCE_TWILIO' | 'SOURCE_EXTERNAL' | 'SOURCE_MUXER' | 'SOURCE_ARAAS' | 'SOURCE_CHIME' | 'SOURCE_INVALID'
    - `source_recording_track_sid` string
    - `deleted_at` string, date-time

## Other responses

- `500` — Internal Server Error, multiple things could be wrong, see error message

---

[API](https://skmtc.net/streem/apis/streem-api.md) · [All operations](https://skmtc.net/streem/apis/streem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streem/streem-api/versions/04250faebd19/schema)