Skip to main content
POST
Play audio to call

Authorizations

apikey
string
header
required

Your Pilot Status API key (ps_...). Evolution GO also accepts Authorization: Bearer <key>.

Body

application/json
callId
string
required

Identifier of the active call to play into.

Example:

"3EB0C767D26A8B4E7F1A"

filePath
string
required

Server-side path to the audio file (.mp3, .wav or .opus).

Example:

"/audios/greeting.mp3"

hangupAfterPlay
boolean

When true, ends the call automatically once playback finishes. Defaults to false.

Example:

true

Response

Success — provider-native response body.

message
string

Operation status, always "success" on 200

data
object

Only present for multipart/form-data uploads; absent for JSON (filePath) requests