POST api/Start_Conversation?Session_ID={Session_ID}&Use_Case={Use_Case}&App_Key={App_Key}

Start Conversation

Request Information

URI Parameters

Name	Description	Type	Additional information
Session_ID		string	Required
Use_Case		string	Required
App_Key	Currently not used.	string	Default value is

Body Parameters

None.

Response Information

Resource Description

Start_Conversation_Response

Name	Type	Additional information
Request_Type	string	None.
Request_Parameters	Start_Conversation_Request_Record	None.
Data	Start_Conversation_Response_Record	None.
Response_Tail	Response_Tail_Record	None.

Response Formats

application/json, text/json

Sample:

{
  "Request_Type": "sample string 1",
  "Request_Parameters": {
    "Session_ID": "sample string 1",
    "Use_Case": "sample string 2",
    "App_Key": "sample string 3"
  },
  "Data": {
    "Conversation_ID": "sample string 1"
  },
  "Response_Tail": {
    "Time_Stamp": "sample string 1",
    "Status": "sample string 2",
    "Build_Number": "sample string 3",
    "Execution_Time_In_Milliseconds": 4,
    "Errors_List": [
      {
        "Error_Time": "2026-06-27T18:20:55.482113+00:00",
        "Error_Text": "sample string 2",
        "Error_Type": 0
      },
      {
        "Error_Time": "2026-06-27T18:20:55.482113+00:00",
        "Error_Text": "sample string 2",
        "Error_Type": 0
      }
    ]
  }
}

application/xml, text/xml

Sample:

<Start_Conversation_Response xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Cognitive_Layer_API">
  <Data>
    <Conversation_ID>sample string 1</Conversation_ID>
  </Data>
  <Request_Parameters>
    <App_Key>sample string 3</App_Key>
    <Session_ID>sample string 1</Session_ID>
    <Use_Case>sample string 2</Use_Case>
  </Request_Parameters>
  <Request_Type>sample string 1</Request_Type>
  <Response_Tail>
    <Build_Number>sample string 3</Build_Number>
    <Errors_List xmlns:d3p1="http://schemas.datacontract.org/2004/07/IA_Tools">
      <d3p1:IA_Error_Item>
        <d3p1:Error_Text>sample string 2</d3p1:Error_Text>
        <d3p1:Error_Time>2026-06-27T18:20:55.482113+00:00</d3p1:Error_Time>
        <d3p1:Error_Type>Message</d3p1:Error_Type>
      </d3p1:IA_Error_Item>
      <d3p1:IA_Error_Item>
        <d3p1:Error_Text>sample string 2</d3p1:Error_Text>
        <d3p1:Error_Time>2026-06-27T18:20:55.482113+00:00</d3p1:Error_Time>
        <d3p1:Error_Type>Message</d3p1:Error_Type>
      </d3p1:IA_Error_Item>
    </Errors_List>
    <Execution_Time_In_Milliseconds>4</Execution_Time_In_Milliseconds>
    <Status>sample string 2</Status>
    <Time_Stamp>sample string 1</Time_Stamp>
  </Response_Tail>
</Start_Conversation_Response>