Skip to main content

Creates an audio clip

POST /v1/audioclip

Summary​

Creates an audio clip.

Details​

Request body: JSON object.

This endpoint is not used by devices.

Authentication​

No operation-level security requirement is documented here.

Parameters​

None documented here.

Request Body​

Required: Yes

application/json​

  • deviceID (integer (int64), optional)
  • deviceName (string, optional)
  • fileID (integer (int64), optional)
  • localFilePath (string, optional)
  • startTime (integer (int64), optional)
  • startTimeMs (integer (int64), optional)
  • clipLengthInSeconds (number (double), optional)
  • audioClipStatus (integer (int64), optional)
  • audioClipTypeID (integer (int64), optional)
  • audioClipParameters (string, optional)

Example

{
  "deviceID": 201,
  "deviceName": "WearableDevice",
  "fileID": 1,
  "localFilePath": "Example value",
  "startTime": 1,
  "startTimeMs": 1,
  "clipLengthInSeconds": 1,
  "audioClipStatus": 1,
  "audioClipTypeID": 1,
  "audioClipParameters": "Example value"
}

Responses​

200​

Success

application/json​

  • key (integer (int64), optional)
  • deviceID (integer (int64), optional)
  • fileID (integer (int64), optional)
  • audioClipStatus (integer (int64), optional)
  • audioClipTypeID (integer (int64), optional)
  • audioClipParameters (string, optional)
  • localFilePath (string, optional)
  • fileSize (integer (int64), optional)
  • bitrate (integer (int64), optional)
  • startTime (integer (int64), optional)
  • startTimeMs (integer (int64), optional)
  • endTime (integer (int64), optional)
  • endTimeMs (integer (int64), optional)
  • clipLengthInSeconds (number (double), optional)
  • tagListID (integer (int64), optional)
  • creationDate (string (date-time), optional)

Example

{
  "key": 1,
  "deviceID": 201,
  "fileID": 1,
  "audioClipStatus": 1,
  "audioClipTypeID": 1,
  "audioClipParameters": "Example value",
  "localFilePath": "Example value",
  "fileSize": 1,
  "bitrate": 1,
  "startTime": 1,
  "startTimeMs": 1,
  "endTime": 1,
  "endTimeMs": 1,
  "clipLengthInSeconds": 1,
  "tagListID": 1,
  "creationDate": "2026-03-30T12:00:00.0000000Z"
}