POST
/
conversations
/
persona
Create a Persona Conversation
curl --request POST \
  --url https://api.hyperleapai.com/conversations/persona \
  --header 'Content-Type: application/json' \
  --header 'x-hl-api-key: <api-key>' \
  --data '{
  "personaId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "personaVersionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "replacements": {},
  "metadata": {},
  "stream": true,
  "externalUserId": "<string>"
}'
{
  "conversationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "aiSystem": "<string>",
  "model": "<string>",
  "personaId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "personaVersionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "conversationStatus": "<string>",
  "conversationName": "<string>",
  "chatMessages": [
    {
      "role": "<string>",
      "content": "<string>",
      "toolCallId": "<string>",
      "name": "<string>",
      "messageId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "timestamp": "2023-11-07T05:31:56Z",
      "feedbacks": [
        {
          "feedbackId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "score": 0,
          "comments": "<string>",
          "tags": [
            "<string>"
          ],
          "timestamp": "2023-11-07T05:31:56Z",
          "scoreConfidence": 0.5
        }
      ],
      "promptTokens": 123,
      "completionTokens": 123,
      "totalTokens": 123,
      "conversationRunId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "chatMessagesCount": 123,
  "chatStarted": true,
  "areChatMessagesInBlob": true,
  "chatMessagesBlobUri": "<string>",
  "configuration": {},
  "metadata": {},
  "externalUserId": "<string>",
  "isActive": true,
  "isDeleted": true,
  "promptTokens": 123,
  "completionTokens": 123,
  "totalTokens": 123
}

Authorizations

x-hl-api-key
string
header
required

API Key for authentication

Body

personaId
string<uuid>
required
personaVersionId
string<uuid> | null
replacements
object | null
metadata
object | null
stream
boolean
externalUserId
string | null

Response

OK

conversationId
string<uuid>
aiSystem
string | null
model
string | null
personaId
string<uuid> | null
personaVersionId
string<uuid> | null
conversationStatus
string | null
conversationName
string | null
chatMessages
object[] | null
chatMessagesCount
integer | null
chatStarted
boolean | null
areChatMessagesInBlob
boolean | null
chatMessagesBlobUri
string | null
configuration
object | null
metadata
object | null
externalUserId
string | null
isActive
boolean
isDeleted
boolean
promptTokens
integer | null
completionTokens
integer | null
totalTokens
integer | null