Submit feedback for response

Submit user feedback for a specific agent response to track satisfaction and model performance. Each response can only receive feedback once.

POST /api/v1/llm/feedback/responses

Python (SDK)

Python

from mka1 import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.llm.feedback.create_response_feedback(id="resp-xyz789", rating="thumbs_down", description="The response missed key details.")

    # Handle response
    print(res)

201

{
  "id": "resp-xyz789",
  "rating": "thumbs_down",
  "description": "The response missed key details.",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

Authorizations

Authorization · string · header · required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Headers

X-On-Behalf-Of · string

Optional external end-user identifier forwarded by the API gateway.

Body

application/json

Request parameters for creating feedback. Allows users to rate and comment on model outputs.

id · string · required

Request ID to associate this feedback with. Use chat completion request ID or response ID.

rating · enum<string>

Optional feedback rating. Can be 'thumbs_up' for positive feedback or 'thumbs_down' for negative feedback.

Available options: thumbs_up, thumbs_down

description · string

Optional detailed feedback description. Use this to provide specific comments, suggestions, or explain the rating (max 2000 characters).

Maximum string length: 2000

Response

201 - application/json

OK

Response containing the created feedback entry with generated ID and timestamps.

id · string · required

The request ID that this feedback is associated with

rating · enum<string>

The feedback rating indicating user satisfaction

Available options: thumbs_up, thumbs_down

description · string

Optional detailed feedback description providing additional context or explanation (max 2000 characters)

Maximum string length: 2000

createdAt · string<date-time>

Timestamp when the feedback was created

updatedAt · string<date-time>

Timestamp when the feedback was last updated