curl --request POST \
--url https://alpha.api.trycaesar.com/v1/feedback \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'import requests
url = "https://alpha.api.trycaesar.com/v1/feedback"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://alpha.api.trycaesar.com/v1/feedback', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"accepted": true,
"access": {
"rate_limit": {
"limit_rps": 123,
"remaining": 123,
"reset_at": "<string>"
}
},
"feedback_id": "<string>",
"request_id": "<string>",
"session_id": "<string>",
"$schema": "https://alpha.api.trycaesar.com/FeedbackResponse.json",
"usage": {
"bytes_returned": 123,
"requests": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"request_id": "<string>",
"type": "error",
"$schema": "https://alpha.api.trycaesar.com/ErrorEnvelope.json"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"request_id": "<string>",
"type": "error",
"$schema": "https://alpha.api.trycaesar.com/ErrorEnvelope.json"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"request_id": "<string>",
"type": "error",
"$schema": "https://alpha.api.trycaesar.com/ErrorEnvelope.json"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"request_id": "<string>",
"type": "error",
"$schema": "https://alpha.api.trycaesar.com/ErrorEnvelope.json"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"request_id": "<string>",
"type": "error",
"$schema": "https://alpha.api.trycaesar.com/ErrorEnvelope.json"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"request_id": "<string>",
"type": "error",
"$schema": "https://alpha.api.trycaesar.com/ErrorEnvelope.json"
}Record feedback
Persist an agent or evaluation feedback event.
curl --request POST \
--url https://alpha.api.trycaesar.com/v1/feedback \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'import requests
url = "https://alpha.api.trycaesar.com/v1/feedback"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://alpha.api.trycaesar.com/v1/feedback', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"accepted": true,
"access": {
"rate_limit": {
"limit_rps": 123,
"remaining": 123,
"reset_at": "<string>"
}
},
"feedback_id": "<string>",
"request_id": "<string>",
"session_id": "<string>",
"$schema": "https://alpha.api.trycaesar.com/FeedbackResponse.json",
"usage": {
"bytes_returned": 123,
"requests": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"request_id": "<string>",
"type": "error",
"$schema": "https://alpha.api.trycaesar.com/ErrorEnvelope.json"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"request_id": "<string>",
"type": "error",
"$schema": "https://alpha.api.trycaesar.com/ErrorEnvelope.json"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"request_id": "<string>",
"type": "error",
"$schema": "https://alpha.api.trycaesar.com/ErrorEnvelope.json"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"request_id": "<string>",
"type": "error",
"$schema": "https://alpha.api.trycaesar.com/ErrorEnvelope.json"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"request_id": "<string>",
"type": "error",
"$schema": "https://alpha.api.trycaesar.com/ErrorEnvelope.json"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"request_id": "<string>",
"type": "error",
"$schema": "https://alpha.api.trycaesar.com/ErrorEnvelope.json"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Optional client session identifier.
Body
What happened: result_helpful / result_not_helpful (the result did or did not advance the task), passage_used (a passage was used or cited), read_abandoned (opened but abandoned), duplicate_result, stale_result (outdated content), spam_or_low_quality, missing_expected_source (a source you expected did not appear), unsafe_or_policy_issue.
result_helpful, result_not_helpful, passage_used, read_abandoned, duplicate_result, stale_result, spam_or_low_quality, missing_expected_source, unsafe_or_policy_issue Optional calling-agent context for slicing feedback in evaluation.
Show child attributes
Show child attributes
Document the event concerns, from the result's doc_id.
Free-text context, recorded for human review and offline evaluation.
Specific passage the event concerns, from passages[].passage_id; most useful with passage_used.
Query text the event relates to, useful when no search_id is available.
One-based position the result had in the ranked list.
x >= 1The search_id returned by /v1/search. Ties feedback to the exact ranked list that produced the result, so ranking learns from the right context.
Session the event belongs to (UUID), matching session_id from earlier responses.
Response
Feedback accepted.
Show child attributes
Show child attributes
A URL to the JSON Schema for this object.
"https://alpha.api.trycaesar.com/FeedbackResponse.json"
Show child attributes
Show child attributes