Skip to main content
POST
/
v1
/
core
/
recordings
/
upload
Create a recording from uploaded audio
curl --request POST \
  --url https://api.siro.ai/v1/core/recordings/upload \
  --header 'Content-Type: application/json' \
  --header 'x-siro-auth-token: <api-key>' \
  --data '
{
  "downloadUrl": "<string>",
  "fileType": "mp3",
  "title": "<string>",
  "userId": "<string>",
  "userEmail": "<string>",
  "userPhone": "<string>",
  "organizationId": "<string>",
  "conversationType": "<string>",
  "integrationConnectionId": "<string>",
  "crmObjects": [
    {
      "objectType": "Opportunity",
      "objectId": "<string>"
    }
  ],
  "customerPhone": "<string>",
  "customerName": "<string>",
  "dateCreated": "2023-11-07T05:31:56Z"
}
'
{
  "data": {
    "id": "<string>"
  }
}

Authorizations

​
x-siro-auth-token
string
header
required

Custom authentication token for user-scoped endpoints

Body

application/json
​
downloadUrl
string
required

Download URL from signed-urls endpoint

​
fileType
enum<string>
required
Available options:
mp3,
aac,
wav
​
title
string

Title of the recording.

​
userId
string

ID of the user who created the recording.

​
userEmail
string

Email of the user who created the recording

​
userPhone
string

Phone number of the user who created the recording

​
organizationId
string

ID of the organization associated with the recording.

​
conversationType
string

Conversation type for the recording to be analyzed against. Falls back to default conversation type

​
integrationConnectionId
string

Integration Connection Id. Retrieve via GET /v1/core/integrations/connections.

​
crmObjects
object[]

CRM objects to link to the recording.

​
customerPhone
string

Phone number of the customer for purposes of linking to CRM objects. Ignored if CRM objects are passed.

​
customerName
string

Phone number of the customer for purposes of linking to CRM objects. Ignored if CRM objects are passed.

​
dateCreated
string<date-time>

When the recording was created.

Response

201 - application/json

Created

​
data
object