Audio

Upload and download audio recordings from mapping and testing runs.

5 endpoints

Get an upload URL

POST/audio/upload-url

Generate a pre-signed URL for uploading an audio file to S3.

Body Parameters

Name	Type	Required	Description
filename	string	required	Name of the audio file. Note the all-lowercase spelling — the API rejects fileName
category	string	required	test, map, voice, or transcript. Selects the storage prefix
associatedId	string	optional	Run, job or voice id this file belongs to. Defaults to the generated audioId
contentType	string	required	MIME type (e.g., audio/wav, audio/mp3)

Request

bash

curl -X POST -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename":"recording.wav","contentType":"audio/wav","category":"test"}' \
  https://api.nopaque.co.uk/audio/upload-url

Response

json

{
  "uploadUrl": "https://s3.eu-west-2.amazonaws.com/...",
  "audioId": "aud_abc123",
  "expiresIn": 3600
}

Get a download URL

GET/audio/download-url

Generate a pre-signed URL for downloading an audio file.

Query Parameters

Name	Type	Required	Description
audioId	string	required	Audio file ID

Request

bash

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.nopaque.co.uk/audio/download-url?audioId=aud_abc123"

Response

json

{
  "downloadUrl": "https://s3.eu-west-2.amazonaws.com/...",
  "expiresIn": 3600
}

List audio files

GET/audio

List all audio files in the workspace.

Query Parameters

Name	Type	Required	Description
limit	number	optional	Maximum items to return (default 50)
nextToken	string	optional	Pagination token from previous response

Request

bash

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.nopaque.co.uk/audio

Response

json

{
  "audioFiles": [
    {
      "id": "aud_abc123",
      "filename": "recording.wav",
      "contentType": "audio/wav",
      "createdAt": "2026-04-10T12: 00: 00Z"
    }
  ],
  "count": 1
}

Get an audio file

GET/audio/{id}

Get metadata for a specific audio file.

Path Parameters

Name	Type	Required	Description
id	string	required	Audio file ID

Request

bash

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.nopaque.co.uk/audio/aud_abc123

Response

json

{
  "id": "aud_abc123",
  "filename": "recording.wav",
  "contentType": "audio/wav",
  "sizeBytes": 1048576,
  "createdAt": "2026-04-10T12: 00: 00Z"
}

Delete an audio file

DELETE/audio/{id}

Delete an audio file and its S3 object.

Path Parameters

Name	Type	Required	Description
id	string	required	Audio file ID

Request

bash

curl -X DELETE -H "x-api-key: YOUR_API_KEY" \
  https://api.nopaque.co.uk/audio/aud_abc123

Response

json

{
  "message": "Audio file deleted successfully"
}