artifact_details_save · Gateway release 0.8.3
Save exact-revision Artifact details or repair source images without generation. Preserves generated Media, provenance, immutable versions and all existing Looks. Refresh if the expectedVersion changed.
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."
},
"artifactId": {
"type": "string",
"pattern": "^[a-fA-F0-9]{24}$",
"description": "ID of the reusable prop, clothing or accessory, distinct from its Media image IDs."
},
"expectedVersion": {
"type": "integer",
"minimum": 1,
"description": "Copy the current version from the latest workflow read. Refresh after a conflict; never increment or guess it."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"details": {
"type": "object",
"additionalProperties": false,
"properties": {
"schemaVersion": {
"const": 1
},
"category": {
"enum": [
"prop",
"clothing",
"accessory"
]
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"materials": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"scale": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"placement": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"continuityNotes": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"required": [
"schemaVersion",
"category",
"description"
]
},
"sourceAssetIds": {
"type": "array",
"maxItems": 16,
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^[a-fA-F0-9]{24}$"
},
"description": "Ordered IDs of saved source images to preserve as generation inputs. Never silently omit an intended source."
},
"removeReferenceAssetIds": {
"type": "array",
"maxItems": 16,
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^[a-fA-F0-9]{24}$"
}
}
},
"required": [
"storyworldId",
"artifactId",
"expectedVersion",
"title",
"details"
]
}
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"
},
"version": {
"description": "Current mutable document version. Copy it to expectedVersion before a write.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"contentRevision": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
{
"type": "null"
}
]
},
"referenceRevision": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
{
"type": "null"
}
]
},
"recipeVersionId": {
"description": "Immutable Look recipe identity; distinct from the mutable document version.",
"type": "string"
},
"generationEligible": {
"type": "boolean"
},
"lookEligible": {
"type": "boolean"
},
"candidates": {
"description": "Saved candidate images. Inspect an actual image before selecting it.",
"type": "array",
"items": {
"type": "object",
"properties": {
"assetId": {
"type": "string"
},
"title": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"selectedLookVersionId": {
"type": [
"string",
"null"
]
},
"activeImageRequest": {
"description": "Original preparing/admitted image request to reconcile after a timeout; do not replace it.",
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"jobs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"jobId": {
"type": "string"
},
"status": {
"type": "string"
}
},
"required": [
"jobId",
"status"
],
"additionalProperties": {}
}
},
"nextActions": {
"type": "array",
"items": {
"type": "string"
}
},
"studioUrl": {
"description": "Canonical authenticated Studio editor for this saved asset.",
"type": "string"
},
"artifactId": {
"type": "string",
"pattern": "^[a-f0-9]{24}$"
},
"storyworldId": {
"type": "string",
"pattern": "^[a-f0-9]{24}$"
}
},
"required": [
"schemaVersion",
"artifactId",
"storyworldId"
],
"additionalProperties": {}
}