Skip to main content
Glama

artifacts_update

Republish an existing artifact with new HTML. The slug and URL stay the SAME; a new version is stored (older versions are retained up to a cap). Use this to refresh a shared dashboard — anyone with the link sees the new snapshot.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
htmlNoThe new full self-contained HTML page (same contract as artifacts.create). Omit when passing analytics_card_ids.
labelNoOptional human name for this version (e.g. 'Q3 final').
templateNoOptional: attach/replace the data-driven template (HTML with {{placeholder}} tokens) on this existing artifact, so later artifacts.refresh(data={...}) can re-render it server-side. Pass the html rendered from this template. Omit to leave the template unchanged.
artifact_idYesThe artifact to republish.
in_workspaceNoRun this one call in this workspace id instead of the session's. Nothing is stored; other sessions are not affected.
analytics_card_idsNoIds of saved analytics dashboard cards to make this artifact's source, keeping its link: the cards are attached and the page is rebuilt from them now; afterwards artifacts.refresh(artifact_id) alone rebuilds it again. Mutually exclusive with html.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedInput schema / properties / analytics_card_ids
      Added value: +{
      +  "description": "Ids of saved analytics dashboard cards to make this artifact's source, keeping its link: the cards are attached and the page is rebuilt from them now; afterwards artifacts.refresh(artifact_id) alone rebuilds it again. Mutually exclusive with html.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / html / description
      Previous value: -"The new full self-contained HTML page (same contract as artifacts.create)."New value: +"The new full self-contained HTML page (same contract as artifacts.create). Omit when passing analytics_card_ids."
    • changedInput schema / required
      Previous value: -[
      -  "artifact_id",
      -  "html"
      -]New value: +[
      +  "artifact_id"
      +]
  2. Changed1 schema field changed
    • addedInput schema / properties / in_workspace
      Added value: +{
      +  "description": "Run this one call in this workspace id instead of the session's. Nothing is stored; other sessions are not affected.",
      +  "type": "integer"
      +}
  3. Added
  4. Removed
  5. Changed1 schema field changed
    • addedInput schema / properties / template
      Added value: +{
      +  "description": "Optional: attach/replace the data-driven template (HTML with {{placeholder}} tokens) on this existing artifact, so later artifacts.refresh(data={...}) can re-render it server-side. Pass the html rendered from this template. Omit to leave the template unchanged.",
      +  "type": "string"
      +}
  6. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources