API reference · Calls

Speak into a call

POSThttps://goblins-call-api.onrender.com/v1/calls/:id/say

Has the agent say a line right now, outside its normal turn. Use it for something your system learns mid-call, such as a payment going through.

Works with a workspace API key or the agent’s own key.

Path parameters

idstringRequired

The callId returned when the call was started.

Body

textstringRequired1–2,000 chars

What the agent says, in its own voice.

allowInterruptionsbooleanOptional

false has the agent finish the line even if the caller starts talking.

Errors

400

The body failed validation. details lists each field and what is wrong with it.

404

No call in your workspace has that ID.

409

The call has already ended.

Every request can also answer 401, 429 and 500: see Errors.

curl -X POST "https://goblins-call-api.onrender.com/v1/calls/8f1c2c1e-7b1a-4e0a-9c55-2f6f0d3b1a90/say" \
  -H "Authorization: Bearer $CRACKLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "text": "Your payment just came through. Thank you!"
}'

Response · 202 Accepted

{
  "ok": true
}