Braintest
POST/v1/dataset/{dataset_id}/feedback

Submit feedback for dataset events

Submits feedback for events recorded in a dataset. Provide one or more feedback items in feedback, using each event's row id and optionally adding a comment, metadata, source, or tags.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 1 body field
dataset_idstringrequired
The UUID of the dataset containing the events for which you are logging feedback.

An array of feedback items for dataset events.

feedbackarray<object>required
A list of dataset feedback items

6 status codes
200Returns a success object with `status` set to `success`.
statusstringrequired
Allowed:success
400Returned when the request is unacceptable, such as when `feedback` or a feedback item's required `id` is missing.
401Returned when no valid API key is provided.
403Returned when the API key does not have permission to log dataset feedback.
429Returned when too many requests reach the API too quickly.
500Returned when an unexpected failure occurs on the API side.

Error handling

A 400 is returned when the request is unacceptable, such as when feedback or an item's required id is missing. A 401 is returned without a valid API key, and a 403 is returned when the API key lacks permission. A 429 indicates that requests are being sent too quickly, while a 500 indicates an API-side failure; use exponential backoff for rate limiting.