Inspect saved Character workflow state

character_workflow_get: permissions and generated input/output contracts.

character_workflow_get · Gateway release 0.8.3

Read authoritative setup, reference roles/review, saved voice, retained auditions/video, active operations and next valid actions. Provider submission is not completion. Speaking video uses provider-native audio, not the selected ElevenLabs voice. Large media stays in managed storage.

Required scopes: account:read, studio:read. Read-only.

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."
    },
    "characterId": {
      "type": "string",
      "pattern": "^[a-fA-F0-9]{24}$",
      "description": "ID of the exact saved Character to reuse; do not create a new identity for an outfit or accessory."
    }
  },
  "required": [
    "storyworldId",
    "characterId"
  ]
}

​

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"
    },
    "storyworldId": {
      "type": "string",
      "pattern": "^[a-f0-9]{24}$"
    },
    "characterId": {
      "type": "string",
      "pattern": "^[a-f0-9]{24}$"
    },
    "version": {
      "type": "number"
    },
    "setup": {
      "anyOf": [
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "references": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "requiredReferenceRoles": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "voice": {
      "anyOf": [
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "operations": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "auditions": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "videos": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "videoCapability": {
      "type": "object",
      "properties": {
        "audioSource": {
          "type": "string",
          "const": "provider_native"
        },
        "audioReferenceUsed": {
          "type": "boolean",
          "const": false
        },
        "matchesAssignedVoice": {
          "type": "boolean",
          "const": false
        }
      },
      "required": [
        "audioSource",
        "audioReferenceUsed",
        "matchesAssignedVoice"
      ],
      "additionalProperties": false
    },
    "nextActions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "studioUrl": {
      "type": "string"
    }
  },
  "required": [
    "schemaVersion",
    "storyworldId",
    "characterId",
    "version",
    "setup",
    "references",
    "requiredReferenceRoles",
    "voice",
    "operations",
    "auditions",
    "videos",
    "videoCapability",
    "nextActions",
    "studioUrl"
  ],
  "additionalProperties": {}
}

All tools · Permissions · Media and recovery