GET
/
api
/
conversation
/
history
curl --location \
--request GET 'https://api.delphi.ai/api/conversation/history?id=b4177da8-40fc-4e5f-9c26-f7915d7e35e3' \
--header 'x-api-key: <key>' 

{
  "history": [
        {
            "text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
            "created_at": "2023-06-04T15:30:23+00:00",
            "sender": "CLONE"
        },
        {
            "text": "Quisque dapibus libero non placerat bibendum. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.",
            "created_at": "2023-06-04T15:32:44+00:00",
            "sender": "USER"
        },
        {
            "text": "Sed tincidunt mauris vitae elit fringilla, sit amet finibus mauris rhoncus.",
            "created_at": "2023-06-04T15:32:52+00:00",
            "sender": "CLONE"
        },
    ]
}

​
⚠️ Privacy Warning ⚠️

With Delphi’s public api the creator of Prodigy clones have the ability to view all interactions users have with their clones over the api. This only applies to:

  1. Conversations had through the api
  2. ONLY the Prodigy clones that the user who set up the API has created.

If you are using a custom application powered by Delphi, ask the creator how your conversations will be secured.

​
Delphi Privacy Statement

All interactions users have on the Delphi platform (delphi.ai) are private and will never be shared for any reason. We cannot, however, control what custom applications will do with your messages.

​
Query

​
id
uuid

The id of the conversation you would like to retrieve the message history of

​
include_citations
boolean

Defaults to false, if passed in as true will include the citations used for each message in the conversation history.

​
Response

​
history
Message array

History of the conversation between a user and a clone in chronological order

curl --location \
--request GET 'https://api.delphi.ai/api/conversation/history?id=b4177da8-40fc-4e5f-9c26-f7915d7e35e3' \
--header 'x-api-key: <key>' 

{
  "history": [
        {
            "text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
            "created_at": "2023-06-04T15:30:23+00:00",
            "sender": "CLONE"
        },
        {
            "text": "Quisque dapibus libero non placerat bibendum. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.",
            "created_at": "2023-06-04T15:32:44+00:00",
            "sender": "USER"
        },
        {
            "text": "Sed tincidunt mauris vitae elit fringilla, sit amet finibus mauris rhoncus.",
            "created_at": "2023-06-04T15:32:52+00:00",
            "sender": "CLONE"
        },
    ]
}