Skip to main content
POST
/
api
/
v1
/
llm
/
feedback
/
responses
Python (SDK)
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)
{
  "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>.

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