POST
/
api
/
conversation
/
new
curl --location \
--request POST 'https://api.delphi.ai/api/conversation/new' \
--header 'x-api-key: <key>' \
--header 'Content-Type: application/json' \
--data-raw '{"slug": "my-test-clone"}'
{
  "new_conversation": {
    "conversation_id": "b4177da8-40fc-4e5f-9c26-f7915d7e35e3",
    "created_at": "2023-06-04T15:32:04+00:00",
    "messages": [
        {
            "text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
            "created_at": "2023-06-04T15:32:17+00:00",
            "sender": "CLONE"
        }
    ]
  },
  "conversation_type": "anonymous"
}

Body

slug
string

The slug of the clone that you want to start a new conversation with

instance_slug
string

Optionally, the slug of the clone instance that you want to start a new conversation with. This should be used in addition to the slug of the clone

user_email
string

The email of the user chatting with the clone.

Include this field to personalize the conversation to a user. Read more on the Personalization page

Response

new
object

Metadata about the new conversation that was just created

conversation_type
string

The type of the conversation, either: anonymous No user email was included in the request, no user information will be used to generate clone responses for this conversation personalized User email was included, conversation will be personal to the user

curl --location \
--request POST 'https://api.delphi.ai/api/conversation/new' \
--header 'x-api-key: <key>' \
--header 'Content-Type: application/json' \
--data-raw '{"slug": "my-test-clone"}'
{
  "new_conversation": {
    "conversation_id": "b4177da8-40fc-4e5f-9c26-f7915d7e35e3",
    "created_at": "2023-06-04T15:32:04+00:00",
    "messages": [
        {
            "text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
            "created_at": "2023-06-04T15:32:17+00:00",
            "sender": "CLONE"
        }
    ]
  },
  "conversation_type": "anonymous"
}