Take over a conversation
POST /api/conversations/{id}/take-over
Transfers a conversation from AI management to human management. After taking over, the AI will stop responding to new messages in this conversation. Use the reply endpoint to send messages manually, and the release endpoint to return control to the AI. This sends a signal to the conversation’s Temporal workflow to pause AI processing.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The unique identifier of the conversation to take over.
Responses
Section titled “ Responses ”The conversation is now under human management. The AI will not respond to new messages until released.
Simple success acknowledgment returned by action endpoints (reply, resolve, take-over, etc.).
object
Always true on success.
Example
trueFailed to signal the conversation workflow. The conversation may not exist or the workflow may have already completed.
Standard error response returned by all endpoints on failure.
object
A human-readable error message describing what went wrong.
Example
Conversation not found