call

[BETA] play call video

Plays an mp4 (H.264) as the outgoing camera of the connected call; loop=false resolves when the clip ended. The call has to be connected — one that is still ringing has no media channel and answers data.status: error with message: failed to play call video and an explanation. Note: This endpoint is currently in beta and may change without notice.

post/instances/{id}/client/action/play-call-video

Request

  • Base URL: https://waapi.app/api/v1
  • URL: https://waapi.app/api/v1/instances/{id}/client/action/play-call-video
  • Auth: HTTP bearer

Path parameters

idinteger required

Instance ID

Request body

callIdstring

The call to act on. Omit to use the instance's only active call.

videoUrlstring uri required

mp4 (H.264) played as the outgoing camera, max 25 MB

loopboolean

Repeat the clip until the call ends instead of resolving when it ended

Example request

{
  "callId": "00E61C7AAD3559F3AFC223D4E3FC1914",
  "videoUrl": "https://example.com/clip.mp4"
}

Response

Request reached the instance. data.status reports whether the action was carried out; on error data carries message and explanation. Payload: an empty object.

status'success' | 'error'

Whether the request reached the instance. success here does not mean the action was carried out — that is reported by data.status, which is the authoritative one. A malformed input arrives as status: success with data.status: error.

Example response

{
  "status": "success",
  "data": {
    "status": "success"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.