FeedbackResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/arcmira/json-schema/arcmira-feedback-response-schema.json",
  "title": "FeedbackResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/arcmira-feedback-api-openapi.yml#/components/schemas/FeedbackResponse",
  "type": "object",
  "properties": {
    "feedback_id": {
      "type": "string",
      "description": "Id of the persisted feedback record, fbk_ and digits. Read it back via GET /v1/feedback/{feedback_id}."
    },
    "type": {
      "type": "string",
      "description": "The feedback type you submitted. Values: recommendations, channel_sponsors, mentions, entities_search, entities, channels, monitor_alert, appearances, search, experience."
    },
    "query": {
      "type": "object",
      "additionalProperties": {},
      "description": "The query object the feedback is attached to, echoed back. category and mcp_call_id, when sent, are recorded in it under those names."
    },
    "applied": {
      "type": "integer",
      "description": "Count of corrections applied automatically. CURRENTLY always 0: public submissions are logged for review, never auto-applied."
    },
    "unchanged": {
      "type": "integer",
      "description": "Count of corrections whose target already had the requested value. Currently always 0 for public submissions."
    },
    "failed": {
      "type": "integer",
      "description": "Count of corrections that could not be processed. Currently always 0 for public submissions."
    },
    "logged": {
      "type": "integer",
      "description": "Count of corrections recorded for human review."
    },
    "corrections": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/FeedbackCorrectionResult"
      },
      "description": "Per-correction outcomes, in submission order."
    }
  },
  "required": [
    "feedback_id",
    "type",
    "query",
    "applied",
    "unchanged",
    "failed",
    "logged",
    "corrections"
  ],
  "$defs": {
    "FeedbackCorrectionResult": {
      "type": "object",
      "properties": {
        "item_id": {
          "type": "string",
          "description": "The correction target id you supplied (or a generated placeholder when omitted)."
        },
        "item_kind": {
          "type": "string",
          "description": "Inferred kind of the target. Values include: recommendation, sponsor_entity, entity, entity_merge, mention, appearance, alert, alert_expectation, unknown."
        },
        "status": {
          "type": "string",
          "enum": [
            "applied",
            "unchanged",
            "not_found",
            "invalid",
            "logged"
          ],
          "description": "Outcome. Values: applied (the correction was applied automatically), unchanged (the target already had the requested value), not_found (the target does not exist), invalid (the correction payload was malformed for its kind), logged (recorded for human review; no automatic apply)."
        },
        "reason": {
          "type": "string",
          "description": "The reason code you supplied, echoed back."
        },
        "message": {
          "type": "string",
          "description": "Human-readable explanation of the outcome."
        }
      },
      "required": [
        "item_id",
        "item_kind",
        "status"
      ]
    }
  }
}