Skip to main content
Glama

Update objects

update_objects
Destructive

Change objects already on a slide, by id: position, size, rotation, text, look (font, colour, fill, border, shadow, line), a shape's kind, the image's alt text or picture, stacking order, behind (true sends it behind the layout's own elements, false brings it back in front), group and locked. Requires a Pro account. An object the user locked on the web is refused unless the same change sends locked:false. Send only the fields to change; the style is merged, and a style field sent as null goes back to its default. An image keeps its proportions (send w alone). Up to 50 changes per call, all applied or none. Read ids and the current draft_version with get_template(draft: true). Returns the slide's objects and the new draft_version. The edit is saved to the template's draft; call publish_template to publish it. Errors: pro_required, not_found, conflict (read again with get_template(draft: true) and retry), invalid_input.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "template_id": "<template_id>",
      "slide_id": "<slide_id>",
      "changes": "<changes>"
    },
    "name": "update_objects"
  }
}

Input Schema

NameRequiredDescriptionDefault
changesYesChanges to existing objects, one per object id. Send only the fields to change.
slide_idYesThe slide's id from get_template.
template_idYesFrom list_templates.
expected_versionNoOlder callers: the published version from get_template. Given, the call fails with conflict if the template was published since.
expected_draft_versionNoThe draft_version from get_template(draft: true) or your last save (0: no draft yet). Given, the call fails with conflict if the draft changed since.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / expected_draft_version
      Added value: +{
      +  "description": "The draft_version from get_template(draft: true) or your last save (0: no draft yet). Given, the call fails with conflict if the draft changed since.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedInput schema / properties / expected_version / description
      Previous value: -"The version from get_template. Given, the call fails with conflict if the template changed since."New value: +"Older callers: the published version from get_template. Given, the call fails with conflict if the template was published since."
  2. Changed26 schema fields changed
    • addedInput schema / properties / changes / items / properties / group
      Added value: +{
      +  "description": "Objects with the same group id are picked, moved and copied together in the web editor (1 to 40 letters, digits, \"_\" or \"-\"). Has no effect on how the slide looks or exports. null takes the object out of its group.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / changes / items / properties / locked
      Added value: +{
      +  "description": "true: the web editor will not move, resize, change or delete it until it is unlocked. A locked object also refuses update_objects and remove_objects until a change sends locked:false. Has no effect on how the slide looks or exports.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / changes / items / properties / runs
      Added value: +{
      +  "anyOf": [
      +    {
      +      "items": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "end": {
      +            "type": "number"
      +          },
      +          "start": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "start",
      +          "end"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Formatting of part of the text: [{ start, end, bold?, italic?, underline?, color?, link? }]. start and end are UTF-16 offsets into the text (JavaScript string indices: a Korean syllable counts 1, an emoji outside the basic plane 2), end exclusive, start < end. bold, italic, underline are true or false (false undoes a look the whole text has); color takes the colour forms below; link is kept for a later version and not drawn yet. The text itself stays plain. Ranges must fit the text, else the call fails with invalid_input. Shown in the editor, the PPTX (one text run per piece) and the HTML export. Changing the text without sending runs moves the stored runs with it (text before a range shifts it; a range whose characters are all deleted is dropped); send runs with the text to set them yourself, null (update_objects) or [] to remove them. Fields you do not know on a run are kept."
      +}
    • addedInput schema / properties / changes / items / properties / shape
      Added value: +{
      +  "description": "Shape only: change its kind (a line or arrow cannot hold text).",
      +  "enum": [
      +    "rect",
      +    "roundRect",
      +    "ellipse",
      +    "line",
      +    "arrow"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / changes / items / properties / style / additionalProperties
      Previous value: -falseNew value: +{}
    • changedInput schema / properties / changes / items / properties / style / description
      Previous value: -"Text box look. Only the fields you send change."New value: +"Text box or shape look. Only the fields you send change; null takes a field away. Look fields (all optional; send null to take one away and go back to the default): text: size (8-400 px; in an override entry it is called fontSize), weight (400 or 700), italic, underline, strike (true/false), align (\"left\", \"center\", \"right\"), lineHeight (multiple of the size, 0.5-4), vAlign (\"top\", \"middle\", \"bottom\"; text boxes only), color. box: fill (a colour or \"none\"), fillOpacity (0-1), borderColor, borderWidth (0-40 px), radius (0-540 px), shadow (\"none\", \"sm\", \"md\", \"lg\"). line (strokes of a drawn line or icon): lineColor, lineWidth (0.5-40 px), dash (\"solid\", \"dash\", \"dot\"; also the border's style). A colour is one of: a theme colour token (ink, ink-soft, ink-muted, ink-on-dark, accent, accent-soft, accent-bg, bg, bg-alt, bg-inverse, border, border-strong, success, warning, danger), which follows the theme; \"palette:<name>\" for an entry of the template's deck palette, which follows that entry; or a direct colour \"#rrggbb\" (no alpha; use fillOpacity for a see-through fill). Palette and direct colours stay when the theme changes, also with a custom theme. Some layout elements are drawn as a picture in the PPTX; colours stored for them are ignored on every output."
    • changedInput schema / properties / changes / items / properties / style / properties / align / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • addedInput schema / properties / changes / items / properties / style / properties / borderColor
      Added value: +{
      +  "description": "A colour is one of: a theme colour token (ink, ink-soft, ink-muted, ink-on-dark, accent, accent-soft, accent-bg, bg, bg-alt, bg-inverse, border, border-strong, success, warning, danger), which follows the theme; \"palette:<name>\" for an entry of the template's deck palette, which follows that entry; or a direct colour \"#rrggbb\" (no alpha; use fillOpacity for a see-through fill). Palette and direct colours stay when the theme changes, also with a custom theme.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / changes / items / properties / style / properties / borderWidth
      Added value: +{
      +  "description": "0 to 40 px; 0 is no border.",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • changedInput schema / properties / changes / items / properties / style / properties / color / description
      Previous value: -"A theme token such as \"ink\", \"ink-soft\", \"accent\", \"bg\", \"danger\". Not a color value."New value: +"A colour is one of: a theme colour token (ink, ink-soft, ink-muted, ink-on-dark, accent, accent-soft, accent-bg, bg, bg-alt, bg-inverse, border, border-strong, success, warning, danger), which follows the theme; \"palette:<name>\" for an entry of the template's deck palette, which follows that entry; or a direct colour \"#rrggbb\" (no alpha; use fillOpacity for a see-through fill). Palette and direct colours stay when the theme changes, also with a custom theme."
    • changedInput schema / properties / changes / items / properties / style / properties / color / type
      Previous value: -"string"New value: +[
      +  "string",
      +  "null"
      +]
    • addedInput schema / properties / changes / items / properties / style / properties / dash
      Added value: +{
      +  "description": "Border or line style: \"solid\", \"dash\" or \"dot\".",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / changes / items / properties / style / properties / fill
      Added value: +{
      +  "description": "Box fill: a colour, or \"none\".",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / changes / items / properties / style / properties / fillOpacity
      Added value: +{
      +  "description": "0 to 1, the fill only.",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / changes / items / properties / style / properties / italic
      Added value: +{
      +  "type": [
      +    "boolean",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / changes / items / properties / style / properties / lineColor
      Added value: +{
      +  "description": "A colour is one of: a theme colour token (ink, ink-soft, ink-muted, ink-on-dark, accent, accent-soft, accent-bg, bg, bg-alt, bg-inverse, border, border-strong, success, warning, danger), which follows the theme; \"palette:<name>\" for an entry of the template's deck palette, which follows that entry; or a direct colour \"#rrggbb\" (no alpha; use fillOpacity for a see-through fill). Palette and direct colours stay when the theme changes, also with a custom theme.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / changes / items / properties / style / properties / lineHeight
      Added value: +{
      +  "description": "Line spacing as a multiple of the size, 0.5 to 4. Default 1.3.",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / changes / items / properties / style / properties / lineWidth
      Added value: +{
      +  "description": "Line and arrow shapes: 0.5 to 40 px.",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / changes / items / properties / style / properties / radius
      Added value: +{
      +  "description": "Corner radius, 0 to 540 px.",
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / changes / items / properties / style / properties / shadow
      Added value: +{
      +  "description": "\"none\", \"sm\", \"md\" or \"lg\".",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • changedInput schema / properties / changes / items / properties / style / properties / size / type
      Previous value: -"number"New value: +[
      +  "number",
      +  "null"
      +]
    • addedInput schema / properties / changes / items / properties / style / properties / strike
      Added value: +{
      +  "type": [
      +    "boolean",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / changes / items / properties / style / properties / underline
      Added value: +{
      +  "type": [
      +    "boolean",
      +    "null"
      +  ]
      +}
    • addedInput schema / properties / changes / items / properties / style / properties / vAlign
      Added value: +{
      +  "description": "\"top\" (default), \"middle\" or \"bottom\" inside the box.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • changedInput schema / properties / changes / items / properties / style / properties / weight / type
      Previous value: -"number"New value: +[
      +  "number",
      +  "null"
      +]
    • changedInput schema / properties / changes / items / properties / text / description
      Previous value: -"New text for a text box."New value: +"New text for a text box or a box shape. Without runs, the stored runs move with the new text; a range whose characters were all removed is dropped."
  3. Changed3 schema fields changed
    • addedInput schema / properties / changes / description
      Added value: +"Changes to existing objects, one per object id. Send only the fields to change."
    • addedInput schema / properties / changes / items / properties / alt / description
      Added value: +"Image only: new alt text, up to 300 characters."
    • addedInput schema / properties / changes / items / properties / text / description
      Added value: +"New text for a text box."
  4. Added

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already flag destructiveHint=true and idempotentHint=false, and the description adds substantial context beyond them: partial merge semantics, null-resets-to-default, send-w-alone for images, 50-change all-or-nothing atomicity, refusal of web-locked objects unless locked:false is sent, draft-only persistence, and enumerated error codes with recovery steps.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the core action and the highest-risk constraints (Pro requirement, locked refusal, atomicity) before the error list. The long parenthetical field enumeration is somewhat redundant with the schema and could be trimmed, but it is dense rather than padded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a destructive batch mutation with no output schema, the description covers prerequisites, edit semantics, versioning/conflict handling, and the required follow-up call to publish. An agent has everything needed to invoke it correctly and recover from failures.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds real meaning on top: "send only the fields to change", the merge/reset rule for style, the image aspect-ratio rule, and the behind true/false layer behavior. It stops short of explaining expected_version vs expected_draft_version, which the schema handles.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb and resource ("Change objects already on a slide, by id") and enumerates the mutable facets (position, size, rotation, text, look, shape kind, alt/picture, stacking, group, locked). This clearly separates it from add_objects and remove_objects, which act on object existence rather than existing object state.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives concrete preconditions and workflow: read ids and draft_version via get_template(draft: true), then call publish_template to publish, and retry after conflict by re-reading. It does not explicitly state the inverse routing (use add_objects to create, remove_objects to delete), so the when-not guidance is only implicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources