API Documentation
- Introduction
- API Keys
- Errors
- Prompts
- Conversations
- Capture Feedback
- Audit Report
- Feedback Report
- Moderations
Capture Feedback
Set Message's Score
Set the Message Score in a Conversation (while gathering user feedback).
PATCH
/
conversations
/
{conversationId}
/
set-score
/
{messageId}
curl --request PATCH \
--url https://api.hyperleapai.com/conversations/{conversationId}/set-score/{messageId} \
--header 'Content-Type: application/json' \
--header 'x-hl-api-key: <api-key>' \
--data '{
"messageId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"feedbackId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"score": 0,
"comments": "<string>",
"tags": [
"<string>"
],
"scoreConfidence": 0.5
}'
{
"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
API Key for authentication
Body
Response
200
text/plain
OK
The response is of type object
.
curl --request PATCH \
--url https://api.hyperleapai.com/conversations/{conversationId}/set-score/{messageId} \
--header 'Content-Type: application/json' \
--header 'x-hl-api-key: <api-key>' \
--data '{
"messageId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"feedbackId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"score": 0,
"comments": "<string>",
"tags": [
"<string>"
],
"scoreConfidence": 0.5
}'
{
"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
}
Assistant
Responses are generated using AI and may contain mistakes.