> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Feedbacks

> Melde ein falsches, unvollständiges oder fehlgeschlagenes API-Ergebnis. Kostet keine Credits.

Über den Olostep `/v1/feedbacks` Endpunkt kannst du melden, wenn die API etwas falsch gemacht hat. Rufe ihn von einem Agenten oder deinem eigenen Code auf, wenn ein Ergebnis falsch, unvollständig, langsam, fehlgeschlagen oder nicht mit der Dokumentation übereinstimmend war.

* Sende die `id` des Objekts, auf das sich das Feedback bezieht, damit wir es genau zur Anfrage zurückverfolgen können
* Markiere den Bericht mit einer Kategorie und optionalen Symptomcodes
* Das Einreichen von Feedback ist kostenlos und funktioniert auch, wenn die Credits deines Teams erschöpft sind

Für API-Details siehe die [Submit Feedback API Reference](https://docs.olostep.com/api-reference/feedbacks/create.md).

## Feedback einreichen

`category` und `note` sind erforderlich. Füge `related_object_id` hinzu, wenn du sie hast: eine `scrape_…`, `batch_…` oder ähnliche Ressourcen-ID, oder die `error_…` ID, wenn der Aufruf fehlgeschlagen ist.

```python Python theme={null}
import requests
import json

API_KEY = "<YOUR_API_KEY>"

payload = {
    "category": "output_quality",
    "issues": ["missing_content", "broken_formatting"],
    "note": "Die Markdown-Datei lässt die Preistabelle zum Vergleich weg; erwartet wurden alle 4 Zeilen.",
    "affected_endpoint": "POST /v1/scrapes",
    "related_object_id": "scrape_abc1234567",
    "url": "https://example.com/pricing"
}

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

response = requests.post(
    "https://api.olostep.com/v1/feedbacks",
    headers=headers,
    json=payload
)
print(json.dumps(response.json(), indent=2))
```

```js Node theme={null}
const res = await fetch('https://api.olostep.com/v1/feedbacks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <YOUR_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    category: 'output_quality',
    issues: ['missing_content', 'broken_formatting'],
    note: 'Die Markdown-Datei lässt die Preistabelle zum Vergleich weg; erwartet wurden alle 4 Zeilen.',
    affected_endpoint: 'POST /v1/scrapes',
    related_object_id: 'scrape_abc1234567',
    url: 'https://example.com/pricing'
  })
})
console.log(await res.json())
```

```bash cURL theme={null}
curl -X POST https://api.olostep.com/v1/feedbacks \
  -H "Authorization: Bearer $OLOSTEP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "output_quality",
    "issues": ["missing_content", "broken_formatting"],
    "note": "Die Markdown-Datei lässt die Preistabelle zum Vergleich weg; erwartet wurden alle 4 Zeilen.",
    "affected_endpoint": "POST /v1/scrapes",
    "related_object_id": "scrape_abc1234567",
    "url": "https://example.com/pricing"
  }'
```

### Antwort

Die Antwort ist das gespeicherte `feedback` Objekt. Es gibt keinen Listen- oder Abruf-Endpunkt; Feedback wird auf unserer Seite gelesen.

```json theme={null}
{
  "object": "feedback",
  "id": "feedback_019e70f9-214a-74fc-a1ae-26fd3318be3e",
  "category": "output_quality",
  "issues": ["missing_content", "broken_formatting"],
  "note": "Die Markdown-Datei lässt die Preistabelle zum Vergleich weg; erwartet wurden alle 4 Zeilen.",
  "affected_endpoint": "POST /v1/scrapes",
  "related_object_id": "scrape_abc1234567",
  "url": "https://example.com/pricing",
  "created_at": "2026-10-23T00:00:00.000Z"
}
```

## Felder

| Feld | Erforderlich | Hinweise |
| - | - | - |
| `category` | ja | Eine von `output_quality`, `reliability`, `performance`, `documentation`, `api_usability`, `feature_gap`, `other` |
| `note` | ja | Was schiefgelaufen ist und was du stattdessen erwartet hast, bis zu 4.000 Zeichen |
| `issues` | nein | Bis zu 20 `snake_case` Symptomcodes. Dokumentierte Codes sind unten aufgeführt; jeder andere Code in derselben Form wird akzeptiert |
| `affected_endpoint` | nein | `METHOD /path` mit dem kanonischen Pluralpfad, zum Beispiel `POST /v1/scrapes` |
| `related_object_id` | nein | Die `id` des Scrapes, Batches, Crawls, der Antwort oder eines anderen Objekts, oder die `error_…` ID, wenn der Aufruf fehlgeschlagen ist |
| `url` | nein | Die Seite, auf die sich das Feedback bezieht, wie die URL, die gescraped wurde |

### Symptomcodes

`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`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.