Get presigned URLs for recording uploads

POST /api/v1/workflow-recordings/upload-url — request parameters and responses from the Menace Voice API schema.

2 min read

post/api/v1/workflow-recordings/upload-url

Request example

curl --request POST \
  --url https://voice.menaceui.com/api/v1/workflow-recordings/upload-url \
  --header 'authorization: <string>' \
  --header 'X-API-Key: <string>' \
  --header 'Content-Type: application/json' \
  --data '{
  "files": [
    {
      "filename": "<string>",
      "mime_type": "audio/wav",
      "file_size": 1
    }
  ]
}'

Response

{
  "items": [
    {
      "upload_url": "<string>",
      "recording_id": "<string>",
      "storage_key": "<string>"
    }
  ]
}

post/api/v1/workflow-recordings/upload-url

See authentication for workspace API access. Public embed and artifact endpoints use their documented session or access tokens.

Headers

authorizationstring · null#

X-API-Keystring · null#

Body

application/json

filesobject[]required#

List of files to upload

Items: 1–20

Show child attributes

filenamestringrequired#

Original filename of the audio file

mime_typestring#

MIME type of the audio file

Default: "audio/wav"

file_sizeintegerrequired#

File size in bytes (max 5MB)

Range: 0 < x <= 5242880

Responses

application/json

Successful Response

itemsobject[]required#

Upload URLs for each file

Show child attributes

upload_urlstringrequired#

Presigned URL for uploading the audio

recording_idstringrequired#

Short unique recording ID

storage_keystringrequired#

Storage key where file will be uploaded

Download Workflow Artifact Create recording records after upload