ToolDestructive

Update artifact

update_library_artifact

You 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 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
    }
  ]
}

Useful next tools

Prepare chart or table artifactprepare_chart_table_artifactValidate visualization artifactvalidate_visualization_artifactCreate artifactcreate_artifact