Save an inspected Look version

look_reference_select: permissions and generated input/output contracts.

look_reference_select · Gateway release 0.8.3

After inspecting the actual fit image, retain an immutable composite Look version with exact Character and Artifact ingredients. Records agent review; does not change Character identity, voice or any Production shot. Same preview receipt replays without another version.

Required scopes: account:read, studio:write. Changes saved state or requests work; review the operation’s effects.

Availability depends on runtime configuration and the permissions granted to this connection. Use live MCP discovery as the authority.

​

Input

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "storyworldId": {
      "type": "string",
      "pattern": "^[a-fA-F0-9]{24}$",
      "description": "ID of an accessible saved Storyworld returned by discovery. Keep this destination fixed for the operation."
    },
    "lookId": {
      "type": "string",
      "pattern": "^[a-fA-F0-9]{24}$",
      "description": "ID of the saved Character Look recipe, distinct from its generated image or selected version."
    },
    "assetId": {
      "type": "string",
      "pattern": "^[a-fA-F0-9]{24}$",
      "description": "ID of an already saved and linked Media record returned by this workflow."
    },
    "previewFingerprint": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$",
      "description": "Copy the exact receipt returned by previewing this image for the current brief. Do not fabricate it or reuse a stale preview."
    },
    "reviewed": {
      "const": true,
      "description": "True only after inspecting the actual current image. This records agent inspection, not human approval or canon."
    }
  },
  "required": [
    "storyworldId",
    "lookId",
    "assetId",
    "previewFingerprint",
    "reviewed"
  ]
}

​

Declared output

This is the declared success schema. Error results and binary media blocks are separate MCP protocol results.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string",
      "const": "1"
    },
    "entityId": {
      "type": "string",
      "pattern": "^[a-f0-9]{24}$"
    },
    "assetId": {
      "type": "string",
      "pattern": "^[a-f0-9]{24}$"
    },
    "status": {
      "type": "string"
    }
  },
  "required": [
    "schemaVersion",
    "entityId",
    "assetId",
    "status"
  ],
  "additionalProperties": {}
}

All tools · Permissions · Media and recovery