Agent Sessions

Submit Feedback

Changed on

Submit feedback on an assistant message.

When positive feedback is received, the conversation exchange is stored to memory for future context. When negative feedback is received, the exchange is NOT stored. This enables learning from quality interactions.

Args: request: FastAPI request with tenant context session_id: Session identifier payload: Feedback request

Returns: SubmitFeedbackResponse with feedback status

Raises: NotFoundError: If session or message not found

Example: bash curl -X POST http://localhost:8000/v1/agents/sessions/ses_abc123/feedback \ -H "Authorization: Bearer {api_key}" \ -H "X-Namespace: {namespace_id}" \ -H "Content-Type: application/json" \ -d '{ "message_id": "msg_xyz789", "rating": "positive", "feedback_text": "Very helpful response!" }'

post/v1/agents/sessions/{session_id}/feedback

Request

  • Base URL: https://api.mixpeek.com
  • URL: https://api.mixpeek.com/v1/agents/sessions/{session_id}/feedback
  • Auth: HTTP bearer and API key in header X-Namespace

Path parameters

session_idstring required

Session ID

Request body

message_idstring required

Assistant message ID (REQUIRED)

ratingstring required

Feedback rating: 'positive' or 'negative' (REQUIRED)

feedback_textstring nullable

Additional feedback text (OPTIONAL)

Example request

{
  "feedback_text": "Great response!",
  "message_id": "msg_abc123",
  "rating": "positive"
}

Response

Successful Response

session_idstring required

Session identifier

message_idstring required

Message identifier

ratingstring required

Feedback rating submitted

storedboolean required

Whether exchange was stored to memory

recorded_atstring date-time required

Feedback timestamp

Changes

  • 61a175e8eb9aRevision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 5d4c905106b4Revision changes
    • info

      the endpoint scheme security BearerAuth AND NamespaceHeader was added to the API