Submit feedback
curl --request POST \
--url https://api.olostep.com/v1/feedbacks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"note": "The markdown drops the pricing comparison table; expected all 4 rows.",
"issues": [
"missing_content",
"broken_formatting"
],
"affected_endpoint": "POST /v1/scrapes",
"related_object_id": "scrape_abc1234567",
"url": "https://example.com/pricing"
}
'import requests
url = "https://api.olostep.com/v1/feedbacks"
payload = {
"note": "The markdown drops the pricing comparison table; expected all 4 rows.",
"issues": ["missing_content", "broken_formatting"],
"affected_endpoint": "POST /v1/scrapes",
"related_object_id": "scrape_abc1234567",
"url": "https://example.com/pricing"
}
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({
note: 'The markdown drops the pricing comparison table; expected all 4 rows.',
issues: ['missing_content', 'broken_formatting'],
affected_endpoint: 'POST /v1/scrapes',
related_object_id: 'scrape_abc1234567',
url: 'https://example.com/pricing'
})
};
fetch('https://api.olostep.com/v1/feedbacks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.olostep.com/v1/feedbacks",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'note' => 'The markdown drops the pricing comparison table; expected all 4 rows.',
'issues' => [
'missing_content',
'broken_formatting'
],
'affected_endpoint' => 'POST /v1/scrapes',
'related_object_id' => 'scrape_abc1234567',
'url' => 'https://example.com/pricing'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.olostep.com/v1/feedbacks"
payload := strings.NewReader("{\n \"note\": \"The markdown drops the pricing comparison table; expected all 4 rows.\",\n \"issues\": [\n \"missing_content\",\n \"broken_formatting\"\n ],\n \"affected_endpoint\": \"POST /v1/scrapes\",\n \"related_object_id\": \"scrape_abc1234567\",\n \"url\": \"https://example.com/pricing\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.olostep.com/v1/feedbacks")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"note\": \"The markdown drops the pricing comparison table; expected all 4 rows.\",\n \"issues\": [\n \"missing_content\",\n \"broken_formatting\"\n ],\n \"affected_endpoint\": \"POST /v1/scrapes\",\n \"related_object_id\": \"scrape_abc1234567\",\n \"url\": \"https://example.com/pricing\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.olostep.com/v1/feedbacks")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"note\": \"The markdown drops the pricing comparison table; expected all 4 rows.\",\n \"issues\": [\n \"missing_content\",\n \"broken_formatting\"\n ],\n \"affected_endpoint\": \"POST /v1/scrapes\",\n \"related_object_id\": \"scrape_abc1234567\",\n \"url\": \"https://example.com/pricing\"\n}"
response = http.request(request)
puts response.read_body{
"object": "feedback",
"id": "feedback_019e70f9-214a-74fc-a1ae-26fd3318be3e",
"category": "<string>",
"issues": [
"<string>"
],
"note": "<string>",
"created_at": "2026-10-23T00:00:00.000Z",
"affected_endpoint": "<string>",
"related_object_id": "<string>",
"url": "<string>"
}Feedbacks
Submit Feedback
Tell us when the API got something wrong. Costs no credits.
POST
/
v1
/
feedbacks
Submit feedback
curl --request POST \
--url https://api.olostep.com/v1/feedbacks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"note": "The markdown drops the pricing comparison table; expected all 4 rows.",
"issues": [
"missing_content",
"broken_formatting"
],
"affected_endpoint": "POST /v1/scrapes",
"related_object_id": "scrape_abc1234567",
"url": "https://example.com/pricing"
}
'import requests
url = "https://api.olostep.com/v1/feedbacks"
payload = {
"note": "The markdown drops the pricing comparison table; expected all 4 rows.",
"issues": ["missing_content", "broken_formatting"],
"affected_endpoint": "POST /v1/scrapes",
"related_object_id": "scrape_abc1234567",
"url": "https://example.com/pricing"
}
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({
note: 'The markdown drops the pricing comparison table; expected all 4 rows.',
issues: ['missing_content', 'broken_formatting'],
affected_endpoint: 'POST /v1/scrapes',
related_object_id: 'scrape_abc1234567',
url: 'https://example.com/pricing'
})
};
fetch('https://api.olostep.com/v1/feedbacks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.olostep.com/v1/feedbacks",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'note' => 'The markdown drops the pricing comparison table; expected all 4 rows.',
'issues' => [
'missing_content',
'broken_formatting'
],
'affected_endpoint' => 'POST /v1/scrapes',
'related_object_id' => 'scrape_abc1234567',
'url' => 'https://example.com/pricing'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.olostep.com/v1/feedbacks"
payload := strings.NewReader("{\n \"note\": \"The markdown drops the pricing comparison table; expected all 4 rows.\",\n \"issues\": [\n \"missing_content\",\n \"broken_formatting\"\n ],\n \"affected_endpoint\": \"POST /v1/scrapes\",\n \"related_object_id\": \"scrape_abc1234567\",\n \"url\": \"https://example.com/pricing\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.olostep.com/v1/feedbacks")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"note\": \"The markdown drops the pricing comparison table; expected all 4 rows.\",\n \"issues\": [\n \"missing_content\",\n \"broken_formatting\"\n ],\n \"affected_endpoint\": \"POST /v1/scrapes\",\n \"related_object_id\": \"scrape_abc1234567\",\n \"url\": \"https://example.com/pricing\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.olostep.com/v1/feedbacks")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"note\": \"The markdown drops the pricing comparison table; expected all 4 rows.\",\n \"issues\": [\n \"missing_content\",\n \"broken_formatting\"\n ],\n \"affected_endpoint\": \"POST /v1/scrapes\",\n \"related_object_id\": \"scrape_abc1234567\",\n \"url\": \"https://example.com/pricing\"\n}"
response = http.request(request)
puts response.read_body{
"object": "feedback",
"id": "feedback_019e70f9-214a-74fc-a1ae-26fd3318be3e",
"category": "<string>",
"issues": [
"<string>"
],
"note": "<string>",
"created_at": "2026-10-23T00:00:00.000Z",
"affected_endpoint": "<string>",
"related_object_id": "<string>",
"url": "<string>"
}Use this endpoint when a result was wrong, incomplete, slow, failed, or did not match the documentation. It is meant to be called by agents as much as by people: when your pipeline detects a bad result, report it with the
The response is the stored
id of the object it came from and we can trace it back to the exact request.
Submitting feedback is free, and it works even when your team’s credits are exhausted.
What to send
| Field | Required | Notes |
|---|---|---|
category | yes | One of output_quality, reliability, performance, documentation, api_usability, feature_gap, other |
note | yes | What went wrong and what you expected instead, up to 4,000 characters |
issues | no | Up to 20 snake_case symptom codes, such as missing_content or timeout. The documented codes are listed in the schema; any other code of the same shape is accepted |
affected_endpoint | no | METHOD /path, for example POST /v1/scrapes |
related_object_id | no | The id of the scrape, batch, crawl, answer, or other object the feedback is about, or the error_… id when the call failed |
url | no | The page the feedback is about, such as the URL that was scraped |
Example
cURL
curl -X POST https://api.olostep.com/v1/feedbacks \
-H "Authorization: Bearer <your_token>" \
-H "Content-Type: application/json" \
-d '{
"category": "output_quality",
"issues": ["missing_content", "broken_formatting"],
"note": "The markdown drops the pricing comparison table; expected all 4 rows.",
"affected_endpoint": "POST /v1/scrapes",
"related_object_id": "scrape_abc1234567",
"url": "https://example.com/pricing"
}'
feedback object with its id and created_at. There is no list or get endpoint yet; feedback is read on our side.Authorizations
Bearer authentication header of the form Bearer , where is your auth token.
Body
application/json
The broad reason for the feedback.
Available options:
output_quality, reliability, performance, documentation, api_usability, feature_gap, other What went wrong and what you expected instead.
Required string length:
1 - 4000Example:
"The markdown drops the pricing comparison table; expected all 4 rows."
Specific symptoms, as lowercase snake_case codes. Documented codes: missing_content, incorrect_content, incomplete_content, broken_formatting, irrelevant_results, duplicate_results, stale_content, request_failed, timeout, slow_response, inconsistent_result, docs_mismatch, broken_example, confusing_schema, confusing_error, unsupported_website, unsupported_format. Any other code of the same shape is accepted.
Maximum array length:
20Pattern:
^[a-z0-9](?:[a-z0-9_]{0,78}[a-z0-9])?$Example:
["missing_content", "broken_formatting"]
The endpoint the feedback is about, as METHOD /path with the canonical plural path.
Required string length:
1 - 200Example:
"POST /v1/scrapes"
The id of the object the API returned that the feedback is about: a scrape_…, batch_… or similar resource id, or the id of the error object (error_…) when the call failed.
Required string length:
1 - 128Example:
"scrape_abc1234567"
The page the feedback is about, such as the URL that was scraped.
Maximum string length:
2048Example:
"https://example.com/pricing"
Response
The stored feedback.
Available options:
feedback Example:
"feedback_019e70f9-214a-74fc-a1ae-26fd3318be3e"
Example:
"2026-10-23T00:00:00.000Z"
Was this page helpful?