Skip to main content

Enqueue a concatenate clips event based on a start time and end time

POST /v1/audioclip/concatenate

Summary​

Enqueue a concatenate clips event based on a start time and end time.

Details​

Request body: JSON object.

Supports an optional usevrs=true query parameter.

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)
  • startEpoch (integer (int64), optional)
  • endEpoch (integer (int64), optional)
  • uploadURL (string, optional)
  • postbackURL (string, optional)
  • timeout (string, optional)
  • audioClips (array<AudioClip>, optional)
    • array of AudioClip
      • 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

{
  "deviceID": 201,
  "deviceName": "WearableDevice",
  "startEpoch": 1711800000,
  "endEpoch": 1711800000,
  "uploadURL": "https://api.actionstreamer.com/example",
  "postbackURL": "https://api.actionstreamer.com/example",
  "timeout": "Example value",
  "audioClips": [
    {
      "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"
    }
  ]
}

Responses​

200​

Success

application/json​

  • key (integer (int64), optional)
  • deviceID (integer (int64), optional)
  • agentTypeID (integer (int64), optional)
  • agentID (integer (int64), optional)
  • eventTypeID (integer (int64), optional)
  • serverEvent (integer (int64), optional)
  • eventStatus (integer (int64), optional)
  • eventParameters (string, optional)
  • processID (integer (int64), optional)
  • result (string, optional)
  • percentComplete (number (double), optional)
  • priority (integer (int64), optional)
  • expirationEpoch (integer (int64), optional)
  • attemptNumber (integer (int64), optional)
  • maxAttempts (integer (int64), optional)
  • tagString (string, optional)
  • tagNumber (integer (int64), optional)
  • creationDate (string (date-time), optional)

Example

{
  "key": 501,
  "deviceID": 201,
  "agentTypeID": 1,
  "agentID": 1,
  "eventTypeID": 1,
  "serverEvent": 1,
  "eventStatus": 1,
  "eventParameters": "{\"presetName\":\"Run Event Preset\"}",
  "processID": 4321,
  "result": "Example value",
  "percentComplete": 42.5,
  "priority": 1,
  "expirationEpoch": 1711800000,
  "attemptNumber": 1,
  "maxAttempts": 3,
  "tagString": "Example value",
  "tagNumber": 1,
  "creationDate": "2026-03-30T12:00:00.0000000Z"
}