Open Menace Voice

Create recording records after upload

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

2 min read

post/api/v1/workflow-recordings

Request example

curl --request POST \
  --url https://voice.menaceui.com/api/v1/workflow-recordings \
  --header 'authorization: <string>' \
  --header 'X-API-Key: <string>' \
  --header 'Content-Type: application/json' \
  --data '{
  "recordings": [
    {
      "recording_id": "<string>",
      "tts_provider": "<string>",
      "tts_model": "<string>",
      "tts_voice_id": "<string>",
      "transcript": "<string>",
      "storage_key": "<string>",
      "metadata": {}
    }
  ]
}'

Response

{
  "recordings": [
    {
      "id": 1,
      "recording_id": "<string>",
      "workflow_id": 1,
      "organization_id": 1,
      "tts_provider": "<string>",
      "tts_model": "<string>",
      "tts_voice_id": "<string>",
      "transcript": "<string>",
      "storage_key": "<string>",
      "storage_backend": "<string>",
      "metadata": {},
      "created_by": 1,
      "created_at": "2026-08-10T12:00:00Z",
      "is_active": true
    }
  ]
}

post/api/v1/workflow-recordings

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

recordingsobject[]required#

List of recordings to create

Items: 1–20

Show child attributes

recording_idstringrequired#

Short recording ID from upload step

tts_providerstring · null#

TTS provider (e.g. elevenlabs)

Show child attributes

tts_modelstring · null#

TTS model name

Show child attributes

tts_voice_idstring · null#

TTS voice identifier

Show child attributes

transcriptstringrequired#

User-provided transcript of the recording

storage_keystringrequired#

Storage key from upload step

metadataobject · null#

Optional metadata (file_size, duration, etc.)

Show child attributes

Responses

application/json

Successful Response

recordingsobject[]required#

Created recording records

Show child attributes

idintegerrequired#

recording_idstringrequired#

workflow_idinteger · null#

Show child attributes

organization_idintegerrequired#

tts_providerstring · null#

Show child attributes

tts_modelstring · null#

Show child attributes

tts_voice_idstring · null#

Show child attributes

transcriptstringrequired#

storage_keystringrequired#

storage_backendstringrequired#

metadataobjectrequired#

created_byintegerrequired#

created_atstringrequired#

is_activebooleanrequired#

Get presigned URLs for recording uploads List recordings