v1

latestOpenAPI 3.1.02026-07-22128346287.7 KB

Feedback

Feedback Create

Add feedback to a call or object.

post/feedback/create

Request body

idstring nullable

If provided by the client, this ID will be used for the feedback row instead of a server-generated one.

project_idstring required

weave_refstring required

creatorstring nullable

feedback_typestring required

payloadobject required

annotation_refstring nullable

runnable_refstring nullable

call_refstring nullable

trigger_refstring nullable

queue_idstring nullable

The annotation queue ID this feedback was created from. References annotation_queues.id. NULL when feedback is created outside of queues.

scorer_tagsstring[]

Tags applied to the ref by a scorer

scorer_tag_reasonsobject

reason text per tag, keyed by tag name

scorer_tag_confidencesobject

confidence (0-1) per tag, keyed by tag name

scorer_ratingsobject

numeric ratings (0-1) keyed by rating name

scorer_rating_reasonsobject

reason text per rating, keyed by rating name

scorer_rating_confidencesobject

confidence (0-1) per rating, keyed by rating name

span_agent_namestring

Display name of the scored agent (from spans.agent_name)

span_agent_versionstring

Version of the scored agent (from spans.agent_version)

span_status_codestring

Status of the scored turn (from spans.status_code)

wb_user_idstring nullable

Do not set directly. Server will automatically populate this field.

Example request

{
  "id": "018f1f2a-9c2b-7d3e-b5a1-8c9d2e4f6a7b",
  "project_id": "entity/project",
  "weave_ref": "weave:///entity/project/object/name:digest",
  "creator": "Jane Smith",
  "feedback_type": "custom",
  "payload": {
    "key": "value"
  },
  "annotation_ref": "weave:///entity/project/object/name:digest",
  "runnable_ref": "weave:///entity/project/op/name:digest",
  "call_ref": "weave:///entity/project/call/call_id",
  "trigger_ref": "weave:///entity/project/object/name:digest",
  "queue_id": "018f1f2a-9c2b-7d3e-b5a1-8c9d2e4f6a7b",
  "scorer_tags": [
    "nsfw",
    "high-quality"
  ],
  "scorer_tag_reasons": {
    "nsfw": "Contains explicit language"
  },
  "scorer_tag_confidences": {
    "nsfw": 0.92
  },
  "scorer_ratings": {
    "_rating_": 0.87
  },
  "scorer_rating_reasons": {
    "_rating_": "very confident response"
  },
  "scorer_rating_confidences": {
    "_rating_": 0.92
  },
  "span_agent_name": "midi-generator",
  "span_agent_version": "1.2.0",
  "span_status_code": "SUCCESS"
}

Response

Successful Response

idstring required

created_atstring date-time required

wb_user_idstring required

payloadobject required