S2S Conversations

Answer workflow step

Answer the pending workflow step (text, selection, rating, attachments) or request a human with botAction "humanHandoff".

POST

https://api.gleap.io/v3/s2s/conversations/{conversationId}/workflow/answer

Authorizations

Authorizationstring · headerrequired

Bearer authentication header of the form Bearer <token>.

Path parameters

conversationIdstringrequired

Bodyapplication/jsonrequired

textstring

Free-text answer (input / chat steps).

selectedstring

Selected option value (button / select steps).

ratingnumber<double>

Rating value (rate-conversation steps).

attachmentsobject[]

Show child attributes

urlstringrequired

namestring

contentTypestring

botActionenum<string>

"humanHandoff" requests a human without waking an agent run.

Allowed values: humanHandoff

Response

Accepted

Updated November 1, 2026

curl --request POST \
  --url 'https://api.gleap.io/v3/s2s/conversations/{conversationId}/workflow/answer' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "botAction": "humanHandoff"
}'

No example in the spec.