List active conversations
Your organization's active conversations, ones still starting included, oldest first: the ones its limit on conversations at once counts. Each has its id, its status, when it was created and when the AI persona started it, so you can find one to end. Reaches only your organization's conversations.
apiKeyAuthorizationBearer <token>An API key from your organization's API keys page on the platform, nk_…. Server only.
Successful Response
application/json- response
Your organization's active conversations.
items*array<>Oldest first, ones still starting included.
curl -X GET 'https://api.nuancelabs.ai/conversations/active'{ "items": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "status": "created", "created_at": "2019-08-24T14:15:22Z", "started_at": "2019-08-24T14:15:22Z" } ]}Get a transcript GET
What the person and the AI persona said in a conversation, turn by turn, with each word's time. It is ready shortly after the conversation ends; until then the response is `null`. Reaches only your organization's conversations: another's answers 404.
End a conversation POST
Ends one of your organization's conversations the way it ends when the person hangs up, though for now the page's `session.closed` may name the reason `error` rather than `close_requested`. One that hasn't started ends at once; a running one ends within a few seconds, once the AI persona leaves, and its place counts until then. Answers with the conversation as it stands, so a running one can still say `connected`. One already over is left as it is. It has no body; send `Content-Length: 0`. Reaches only your organization's conversations: another's answers 404.