End

Should you want to end a conversation with Socrates prematurely, let us know so we can close the conversation and mark it as unfinished.

Ending a conversation will not let you resume it at a later date…

URL https://www.socratesinsights.com/api/conversation/end
HTTP Method(s) POST

Example Request

<?xml version="1.0" encoding="UTF-8"?>
<conversation>
    <token>XYZ123456</token>
</conversation>
Parameters
token required. Supplied during conversation/start and relevant to the survey you are about to take.

Example Response (valid request)

<?xml version="1.0" encoding="UTF-8"?>
<conversation>
    <token>XYZ123456</token>
    <end-date>16-MAY-2013 12:00:00</end-date>
</conversation>

Example Response (invalid request)

<?xml version="1.0" encoding="UTF-8"?>
<conversation>
    <error>
        <message>Invalid token.</message>
    </error>
</conversation>
Parameters
token Supplied during conversation/start and relevant to the survey you are about to take.
end-date Date and time stamp that confirms the conversation has ended and cannot be resumed.
error > message This appears should you supply an invalid token or invalid variable name and/or variable value.