Braintest
POST/v1/experiment/{experiment_id}/feedback

Submit feedback for experiment events

Submits feedback for a set of events in an experiment. Supply the feedback array with each item's event id and any scores, expected values, comments, metadata, or tags to record. The response confirms that the feedback was accepted.

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

1 parameter · 1 body field
experiment_idstringrequired
The unique experiment identifier in UUID format.

Payload containing feedback items for experiment events.

feedbackarray<object>required
A list of experiment feedback items

6 status codes
200Returns an object with `status` set to `success` after the feedback is recorded.
statusstringrequired
Allowed:success
400Returned when `feedback` is missing, an item lacks its `id`, or a field value fails validation.
401Returned when the request does not include a valid API key.
403Returned when the API key does not have permission to submit experiment feedback.
429Returned when the API receives too many requests too quickly.
500Returned when an internal server error occurs.

Error handling

A 400 is returned when feedback is missing, an item omits id, or a value fails validation. source must be one of app, api, external, or null. A 401 is returned without a valid API key, and a 403 is returned when the API key lacks permission; a 429 indicates excessive request volume, and a 500 indicates an internal server error.