Retell custom-function webhook for powsoo_show_card

POST

/v1/retell/tools/show-card

Configured as the URL of the powsoo_show_card custom function on the Retell agent. Retell POSTs here when the LLM invokes the tool. We look up the SSE writer for the call_id, push the card to the widget, and hold this HTTP response open until the widget posts the user’s tap result back via POST /v1/sessions/:callId/results. Retell’s default webhook timeout is 2 minutes; we cut at 110s so we always respond first.

Request Body

object

name

string

args

nullable

call

required

object

call_id

required

string

>= 1 characters

Responses

200

Result string for the LLM

object

result

required

string

400

Malformed payload

object

ok

required

boolean

error

required

object

code

required

string

>= 1 characters

message

required

string

>= 1 characters

requestId

string

>= 1 characters

404

No widget connected for this callId

object

ok

required

boolean

error

required

object

code

required

string

>= 1 characters

message

required

string

>= 1 characters

requestId

string

>= 1 characters

504

Widget did not respond within the timeout window

object

ok

required

boolean

error

required

object

code

required

string

>= 1 characters

message

required

string

>= 1 characters

requestId

string

>= 1 characters