Enigma Developers
API ReferenceHandover

Hand the conversation back to the bot

PATCH
/v1/handover/open

Reopens the contact's latest conversation so the bot handles it again. Requires scope conversation:handover:open.

Authorization

headerAuthorizationBearer <token>

Your organization API key: Authorization: Bearer org_…

Request Body

application/json
  1. body
audienceExternalId*AudienceExternalId

The contact's ID on its channel. For WhatsApp it is <phone number>:<your WhatsApp phone number ID>.

Response Body

Reopened.

application/json
  1. response
success*boolean
curl -X PATCH 'https://api.enigma-ai.com/v1/handover/open' \  -H 'Content-Type: application/json' \  -d '{  "audienceExternalId": "string"}'
{  "success": true}