Queries

Rate a response

Idempotent upsert: rating the same response again returns 201 and OVERWRITES the previous score/feedback (it is not a 409). The small platform-funded feedback reward is credited only once per response and never for simulated / test-mode responses.

post/requestor/queries/{id}/responses/{responseId}/rate

Request

  • Base URL: https://www.getabrain.ai/api/v1
  • URL: https://www.getabrain.ai/api/v1/requestor/queries/{id}/responses/{responseId}/rate
  • Auth: one of:
    • API key in header X-API-Key and API key in header X-API-Secret
    • HTTP bearer

Path parameters

idstring uuid required
responseIdstring uuid required

Request body

scoreinteger required
feedback_textstring

Response

Rated (re-rating overwrites; also credits the requestor a small platform-funded reward the first time quality feedback is left on a real response)

response_idstring
scoreinteger
feedback_textstring nullable
worker_new_quality_scorenumber
worker_new_rating_countinteger
worker_suspendedboolean
reward_credited_centsinteger

Platform-funded credit earned for this rating (0 on re-rate and for simulated/test-mode responses)

total_reward_centsinteger

Running total of feedback rewards credited

Changes

No recorded changes to this operation across all 1 revision of this API.