Withdraw your rating on a message

POST 
/api/v1/llm/delete-message-rating

Removes the caller's own rating from a message. As with rate-message, the rater is derived server-side from the verified request headers.

This is idempotent: withdrawing a rating that was never left is a success, not an error — the response returns removed: false in that case.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Collect message feedback · Feedback and score attribution

Request

Responses

200

Rating withdrawn (or confirmed absent)

Schema-valid request illustration; replace example identifiers and confirm operation prerequisites.

Section ID: DOC-MA-conversations-api-deleteMessageRating#example-conversations-deleteMessageRating-request

Request example

{
  "conversationKey": "example_123",
  "messageSequence": "1"
}

Guide request for Let the user remove their judgment. Replace example resource identifiers with your own authorized values.

Section ID: DOC-MA-conversations-api-deleteMessageRating#example-cookbook-insights-evaluation-message-feedback-02-request

Request example

{
  "conversationKey": "support-chat-001",
  "messageSequence": 8
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.

Section ID: DOC-MA-conversations-api-deleteMessageRating#example-conversations-deleteMessageRating-response

Response example

{
  "ratedMessage": {
    "role": "ROLE_SYSTEM",
    "content": [
      {
        "type": "CONTENT_PART_TYPE_TEXT",
        "content": "Example text",
        "cachePreferred": true
      }
    ],
    "toolCalls": [
      {
        "id": "example_123",
        "name": "example",
        "status": "TOOL_EXECUTION_STATUS_PENDING",
        "serverId": "example_123",
        "isClientTool": true,
        "description": "example",
        "approvedBy": "example",
        "endReason": "example"
      }
    ],
    "name": "example",
    "timestamp": "2026-09-16T12:00:00Z",
    "messageId": "example_123",
    "annotations": [
      {
        "kind": "ANNOTATION_KIND_URL_CITATION"
      }
    ],
    "sequence": "1",
    "generatedBy": "example",
    "usage": {
      "promptTokens": 1,
      "completionTokens": 1,
      "totalTokens": 1,
      "costEstimate": 1,
      "isByok": true
    },
    "model": "example",
    "generationContext": {
      "languagePreference": "en-US",
      "resolvedSystemPrompt": "Example text",
      "profileId": "example_123",
      "model": "example",
      "promptSource": "PROMPT_SOURCE_CLIENT_OVERRIDE",
      "profileVersion": 1,
      "fragmentsVersion": 1,
      "profileRenderFailed": true,
      "resolvedPromptHash": "Example text",
      "resolvedUserContext": "Example text"
    },
    "clientContext": {},
    "feedback": [
      {
        "kind": "FEEDBACK_KIND_THUMB",
        "thumbUp": true,
        "reason": "example",
        "ratedBy": "example"
      }
    ],
    "sourceUserMessageId": "example_123",
    "finishReason": "example"
  },
  "removed": true
}

Illustrative response for Let the user remove their judgment. Replace example resource identifiers with your own authorized values.

Section ID: DOC-MA-conversations-api-deleteMessageRating#example-cookbook-insights-evaluation-message-feedback-json-03-response

Response example

{
  "ratedMessage": {
    "role": "ROLE_ASSISTANT",
    "sequence": "8",
    "content": [
      {
        "type": "CONTENT_PART_TYPE_TEXT",
        "content": "…"
      }
    ]
  },
  "removed": true
}

Document ID: DOC-MA-conversations-api-deleteMessageRating. Section identities and revisions.

Section	Stable reference
Withdraw your rating on a message	DOC-MA-conversations-api-deleteMessageRating#overview
Request	DOC-MA-conversations-api-deleteMessageRating#request
Responses	DOC-MA-conversations-api-deleteMessageRating#responses