All tools
ToolDestructive
Patch artifact data
patch_artifact_dataYou need to discover, read, validate, create, or attach Prism visual artifacts.
When to use it
You need to discover, read, validate, create, or attach Prism visual artifacts.
Typical workflow
Plan, generate externally, validate, then create or attach.
What it returns
Artifact metadata, specs, validation results, save guidance, or embeds.
Avoid using it when
You are trying to preview live output through MCP; render externally first.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View full registry notes
Patch exact artifact spec paths without replacing the whole artifact. Preview this operation with mode=preview and a stable idempotencyKey. After approval, commit with mode=commit, operationId and commitToken only; saved preview fields cannot be replaced.
View JSON Schema
{
"type": "object",
"properties": {
"artifactId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expectedVersion": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"title": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"spec": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"operations": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"op": {
"type": "string",
"enum": [
"set",
"remove"
]
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"value": {}
},
"required": [
"op",
"path"
]
}
},
"mode": {
"type": "string",
"enum": [
"preview",
"commit"
]
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"operationId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"commitToken": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"mode"
],
"additionalProperties": false,
"anyOf": [
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"artifactId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expectedVersion": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"title": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"spec": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"operations": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"op": {
"type": "string",
"enum": [
"set",
"remove"
]
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"value": {}
},
"required": [
"op",
"path"
]
}
},
"mode": {
"type": "string",
"const": "preview"
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"artifactId",
"expectedVersion",
"mode",
"idempotencyKey"
],
"additionalProperties": false
},
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"mode": {
"type": "string",
"const": "commit"
},
"operationId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"commitToken": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"mode",
"operationId",
"commitToken"
],
"additionalProperties": false
}
]
}