`recordings_visual_identity_retry`

Retry a saved image answer’s picture update

Retries only native application of the current saved image answer. Preserves the answer and starts no recognition, transcription or render provider work. Existing pending work is reused, and the result returns status and a recovery action.

Surface: Default model and app

Product release eb8538f4a297f331d0399351c1e175bffcd212d2
Public contract commit 20688e11af473a363145ed880d5019c90a7ec1e2
Public contract SHA-256 87a94b85a84dc19245fc03f9b544c70d64bd9f5e08585dcccb38157cace5700d
Captured 2026-10-04T11:55:45.577Z. Review or improve this contract on GitHub.

These blocks show the complete MCP descriptors captured from serving Rails. Security schemes and resource URIs can differ by connected host.

Default model descriptor

{
  "name": "recordings_visual_identity_retry",
  "title": "Retry a saved image answer’s picture update",
  "description": "Retries only native application of the current saved image answer. Preserves the answer and starts no recognition, transcription or render provider work. Existing pending work is reused, and the result returns status and a recovery action.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "recording_id": {
        "type": "string"
      },
      "visual_identity_decision_id": {
        "type": "string"
      }
    },
    "required": [
      "recording_id",
      "visual_identity_decision_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Retry a saved image answer’s picture update",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "model",
        "app"
      ]
    },
    "openai/widgetAccessible": true
  }
}

App descriptor

{
  "name": "recordings_visual_identity_retry",
  "title": "Retry a saved image answer’s picture update",
  "description": "Retries only native application of the current saved image answer. Preserves the answer and starts no recognition, transcription or render provider work. Existing pending work is reused, and the result returns status and a recovery action.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "recording_id": {
        "type": "string"
      },
      "visual_identity_decision_id": {
        "type": "string"
      }
    },
    "required": [
      "recording_id",
      "visual_identity_decision_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Retry a saved image answer’s picture update",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "model",
        "app"
      ]
    },
    "openai/widgetAccessible": true
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "recording_id": {
        "type": "string"
      },
      "decision": {
        "type": "object"
      },
      "speaker_evidence": {
        "type": "object"
      },
      "schema": {
        "type": "string",
        "description": "Result schema identifier, bitterclip.visual_identity_decision_operation.v1."
      },
      "already_applied": {
        "type": "boolean",
        "description": "True when the call returned the existing decision rather than recording a new one."
      },
      "speaker_model_context": {
        "type": "object",
        "description": "Compact speaker identity context shared with the model; the full speaker evidence stays in result metadata."
      }
    },
    "required": [],
    "additionalProperties": false
  }
}

Live Workspace descriptor

{
  "name": "recordings_visual_identity_retry",
  "title": "Retry a saved image answer’s picture update",
  "description": "Retries only native application of the current saved image answer. Preserves the answer and starts no recognition, transcription or render provider work. Existing pending work is reused, and the result returns status and a recovery action.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "recording_id": {
        "type": "string"
      },
      "visual_identity_decision_id": {
        "type": "string"
      }
    },
    "required": [
      "recording_id",
      "visual_identity_decision_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Retry a saved image answer’s picture update",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "recording_id": {
        "type": "string"
      },
      "decision": {
        "type": "object"
      },
      "speaker_evidence": {
        "type": "object"
      },
      "schema": {
        "type": "string",
        "description": "Result schema identifier, bitterclip.visual_identity_decision_operation.v1."
      },
      "already_applied": {
        "type": "boolean",
        "description": "True when the call returned the existing decision rather than recording a new one."
      },
      "speaker_model_context": {
        "type": "object",
        "description": "Compact speaker identity context shared with the model; the full speaker evidence stays in result metadata."
      },
      "workspace_binding": {
        "type": "object",
        "properties": {
          "schema": {
            "type": "string",
            "enum": [
              "bitterclip.workspace-binding.v2"
            ]
          },
          "mode": {
            "type": "string",
            "enum": [
              "live_workspace"
            ]
          },
          "project_id": {
            "type": "string"
          },
          "target_kind": {
            "type": "string",
            "enum": [
              "episode",
              "clip"
            ]
          },
          "target_id": {
            "type": "string"
          },
          "revision": {
            "type": "integer"
          },
          "draft_revision": {
            "type": "string"
          },
          "workspace_url": {
            "type": "string"
          },
          "output_id": {
            "type": "string"
          },
          "output_status": {
            "type": "string",
            "enum": [
              "missing",
              "stale",
              "rendering",
              "ready",
              "failed"
            ]
          },
          "output_revision": {
            "type": "integer"
          },
          "parent_episode_id": {
            "type": "string"
          }
        },
        "required": [
          "schema",
          "mode",
          "target_kind",
          "target_id",
          "revision",
          "draft_revision",
          "workspace_url",
          "output_status"
        ],
        "additionalProperties": false
      }
    },
    "required": [],
    "additionalProperties": false
  }
}

Errors

[
  "recording_not_found",
  "visual_identity_actor_required",
  "visual_identity_supersession_stale",
  "visual_identity_question_stale",
  "invalid_input"
]

Examples

[]