grr

Overview Schema Source Related Servers Discussions Admin

chat.spaces.messages.update

Updates an existing Google Chat message's content or fields by specifying the message name and update mask; uses a PUT request and returns the updated message as JSON.

Instructions

Updates a message. There's a difference between the patch and update methods. The patch method uses a patch request while the update method uses a put request. We recommend using the patch method. For an example, see Update a message. Supports the following types of authentication: - App authentication with the authorization scope: - https://www.googleapis.com/auth/ch [HTTP PUT] — updates the resource; refused under --readonly safety profiles. Returns the API's response resource as JSON — request body is a JSON Message object accepting accessoryWidgets, actionResponse, annotations, argumentText, attachedGifs, attachment, cards, cardsV2 and 20 more fields; pass it via paramsor whole viabody_file` Siblings over the same resource: create, delete, get, list, patch, replaceCards, search.

Input Schema

Name	Required	Description
`name`	Yes	[URL path segment] Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{m
`query`	No	Extra KEY=VALUE query pairs for endpoints whose parameters Discovery does not describe.
`params`	No	Parameter map merged into the request; typed parameters win.
`dry_run`	No	Return the request that would be sent, without sending it.
`body_file`	No	Read the request body from this file ('-' for stdin) instead of building one from the parameters. The body is a JSON Message object.
`updateMask`	No	[query parameter] Required. The field paths to update. Separate multiple values with commas or use `*` to update all field paths. Currently supported field paths: - `text` - `att
`allowMissing`	No	[query parameter] Optional. If `true` and the message isn't found, a new message is created and `updateMask` is ignored. The specified message ID must be [client-assigned](https:
`request_body`	No	Request body of type Message: pass it via `params` (merged into the built body) or whole via `body_file`.

Output Schema

Name	Required	Description	Default
`name`	No
`text`	No
`cards`	No
`space`	No
`sender`	No
`silent`	No
`thread`	No
`cardsV2`	No
`attachment`	No
`createTime`	No
`deleteTime`	No
`matchedUrl`	No
`annotations`	No
`threadReply`	No
`argumentText`	No
`attachedGifs`	No
`fallbackText`	No
`markupSyntax`	No
`slashCommand`	No
`formattedText`	No
`actionResponse`	No
`lastUpdateTime`	No
`accessoryWidgets`	No
`deletionMetadata`	No
`privateMessageViewer`	No
`quotedMessageMetadata`	No
`emojiReactionSummaries`	No
`clientAssignedMessageId`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 26, 2026

changedInput schema / properties / body_file / description

Previous value: -"Read the request body from this file ('-' for stdin) instead of building one from the parameters."New value: +"Read the request body from this file ('-' for stdin) instead of building one from the parameters. The body is a JSON Message object."

addedInput schema / properties / request_body

Added value: +{
+  "description": "Request body of type Message: pass it via `params` (merged into the built body) or whole via `body_file`.",
+  "properties": {
+    "accessoryWidgets": {
+      "items": {
+        "properties": {
+          "buttonList": {
+            "properties": {
+              "buttons": {
+                "items": {
+                  "properties": {
+                    "altText": {
+                      "type": "string"
+                    },
+                    "color": {
+                      "type": "object"
+                    },
+                    "disabled": {
+                      "type": "boolean"
+                    },
+                    "icon": {
+                      "type": "object"
+                    },
+                    "onClick": {
+                      "type": "object"
+                    },
+                    "text": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "enum": [
+                        "TYPE_UNSPECIFIED",
+                        "OUTLINED",
+                        "FILLED",
+                        "FILLED_TONAL",
+                        "BORDERLESS"
+                      ],
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "actionResponse": {
+      "properties": {
+        "dialogAction": {
+          "properties": {
+            "actionStatus": {
+              "properties": {
+                "statusCode": {
+                  "enum": [
+                    "OK",
+                    "CANCELLED",
+                    "UNKNOWN",
+                    "INVALID_ARGUMENT",
+                    "DEADLINE_EXCEEDED",
+                    "NOT_FOUND",
+                    "ALREADY_EXISTS",
+                    "PERMISSION_DENIED",
+                    "UNAUTHENTICATED",
+                    "RESOURCE_EXHAUSTED",
+                    "FAILED_PRECONDITION",
+                    "ABORTED",
+                    "OUT_OF_RANGE",
+                    "UNIMPLEMENTED",
+                    "INTERNAL",
+                    "UNAVAILABLE",
+                    "DATA_LOSS"
+                  ],
+                  "type": "string"
+                },
+                "userFacingMessage": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "dialog": {
+              "properties": {
+                "body": {
+                  "type": "object"
+                }
+              },
+              "type": "object"
+            }
+          },
+          "type": "object"
+        },
+        "type": {
+          "enum": [
+            "TYPE_UNSPECIFIED",
+            "NEW_MESSAGE",
+            "UPDATE_MESSAGE",
+            "UPDATE_USER_MESSAGE_CARDS",
+            "REQUEST_CONFIG",
+            "DIALOG",
+            "UPDATE_WIDGET"
+          ],
+          "type": "string"
+        },
+        "updatedWidget": {
+          "properties": {
+            "suggestions": {
+              "properties": {
+                "items": {
+                  "items": {
+                    "type": "object"
+                  },
+                  "type": "array"
+                }
+              },
+              "type": "object"
+            },
+            "widget": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "url": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "annotations": {
+      "items": {
+        "properties": {
+          "customEmojiMetadata": {
+            "properties": {
+              "customEmoji": {
+                "properties": {
+                  "emojiName": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "payload": {
+                    "type": "object"
+                  },
+                  "temporaryImageUri": {
+                    "type": "string"
+                  },
+                  "uid": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "length": {
+            "type": "integer"
+          },
+          "richLinkMetadata": {
+            "properties": {
+              "calendarEventLinkData": {
+                "properties": {
+                  "calendarId": {
+                    "type": "string"
+                  },
+                  "eventId": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "chatSpaceLinkData": {
+                "properties": {
+                  "message": {
+                    "type": "string"
+                  },
+                  "space": {
+                    "type": "string"
+                  },
+                  "thread": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "driveLinkData": {
+                "properties": {
+                  "driveDataRef": {
+                    "type": "object"
+                  },
+                  "mimeType": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "meetSpaceLinkData": {
+                "properties": {
+                  "huddleStatus": {
+                    "enum": [
+                      "HUDDLE_STATUS_UNSPECIFIED",
+                      "STARTED",
+                      "ENDED",
+                      "MISSED"
+                    ],
+                    "type": "string"
+                  },
+                  "meetingCode": {
+                    "type": "string"
+                  },
+                  "type": {
+                    "enum": [
+                      "TYPE_UNSPECIFIED",
+                      "MEETING",
+                      "HUDDLE"
+                    ],
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "richLinkType": {
+                "enum": [
+                  "RICH_LINK_TYPE_UNSPECIFIED",
+                  "DRIVE_FILE",
+                  "CHAT_SPACE",
+                  "GMAIL_MESSAGE",
+                  "MEET_SPACE",
+                  "CALENDAR_EVENT"
+                ],
+                "type": "string"
+              },
+              "uri": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "slashCommand": {
+            "properties": {
+              "bot": {
+                "properties": {
+                  "avatarUrl": {
+                    "type": "string"
+                  },
+                  "displayName": {
+                    "type": "string"
+                  },
+                  "domainId": {
+                    "type": "string"
+                  },
+                  "email": {
+                    "type": "string"
+                  },
+                  "isAnonymous": {
+                    "type": "boolean"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "type": {
+                    "enum": [
+                      "TYPE_UNSPECIFIED",
+                      "HUMAN",
+                      "BOT"
+                    ],
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "commandId": {
+                "type": "string"
+              },
+              "commandName": {
+                "type": "string"
+              },
+              "triggersDialog": {
+                "type": "boolean"
+              },
+              "type": {
+                "enum": [
+                  "TYPE_UNSPECIFIED",
+                  "ADD",
+                  "INVOKE"
+                ],
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "startIndex": {
+            "type": "integer"
+          },
+          "type": {
+            "enum": [
+              "ANNOTATION_TYPE_UNSPECIFIED",
+              "USER_MENTION",
+              "SLASH_COMMAND",
+              "RICH_LINK",
+              "CUSTOM_EMOJI"
+            ],
+            "type": "string"
+          },
+          "userMention": {
+            "properties": {
+              "type": {
+                "enum": [
+                  "TYPE_UNSPECIFIED",
+                  "ADD",
+                  "MENTION"
+                ],
+                "type": "string"
+              },
+              "user": {
+                "properties": {
+                  "avatarUrl": {
+                    "type": "string"
+                  },
+                  "displayName": {
+                    "type": "string"
+                  },
+                  "domainId": {
+                    "type": "string"
+                  },
+                  "email": {
+                    "type": "string"
+                  },
+                  "isAnonymous": {
+                    "type": "boolean"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "type": {
+                    "enum": [
+                      "TYPE_UNSPECIFIED",
+                      "HUMAN",
+                      "BOT"
+                    ],
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "argumentText": {
+      "type": "string"
+    },
+    "attachedGifs": {
+      "items": {
+        "properties": {
+          "uri": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "attachment": {
+      "items": {
+        "properties": {
+          "attachmentDataRef": {
+            "properties": {
+              "attachmentUploadToken": {
+                "type": "string"
+              },
+              "resourceName": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "contentName": {
+            "type": "string"
+          },
+          "contentType": {
+            "type": "string"
+          },
+          "downloadUri": {
+            "type": "string"
+          },
+          "driveDataRef": {
+            "properties": {
+              "driveFileId": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "name": {
+            "type": "string"
+          },
+          "source": {
+            "enum": [
+              "SOURCE_UNSPECIFIED",
+              "DRIVE_FILE",
+              "UPLOADED_CONTENT"
+            ],
+            "type": "string"
+          },
+          "thumbnailUri": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "cards": {
+      "items": {
+        "properties": {
+          "cardActions": {
+            "items": {
+              "properties": {
+                "actionLabel": {
+                  "type": "string"
+                },
+                "onClick": {
+                  "properties": {
+                    "action": {
+                      "type": "object"
+                    },
+                    "openLink": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "header": {
+            "properties": {
+              "imageStyle": {
+                "enum": [
+                  "IMAGE_STYLE_UNSPECIFIED",
+                  "IMAGE",
+                  "AVATAR"
+                ],
+                "type": "string"
+              },
+              "imageUrl": {
+                "type": "string"
+              },
+              "subtitle": {
+                "type": "string"
+              },
+              "title": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "name": {
+            "type": "string"
+          },
+          "sections": {
+            "items": {
+              "properties": {
+                "header": {
+                  "type": "string"
+                },
+                "widgets": {
+                  "items": {
+                    "properties": {
+                      "buttons": {
+                        "items": {
+                          "type": "object"
+                        },
+                        "type": "array"
+                      },
+                      "image": {
+                        "type": "object"
+                      },
+                      "keyValue": {
+                        "type": "object"
+                      },
+                      "textParagraph": {
+                        "type": "object"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "type": "array"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "cardsV2": {
+      "items": {
+        "properties": {
+          "card": {
+            "properties": {
+              "cardActions": {
+                "items": {
+                  "properties": {
+                    "actionLabel": {
+                      "type": "string"
+                    },
+                    "onClick": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "displayStyle": {
+                "enum": [
+                  "DISPLAY_STYLE_UNSPECIFIED",
+                  "PEEK",
+                  "REPLACE"
+                ],
+                "type": "string"
+              },
+              "expressionData": {
+                "items": {
+                  "properties": {
+                    "conditions": {
+                      "items": {
+                        "type": "object"
+                      },
+                      "type": "array"
+                    },
+                    "eventActions": {
+                      "items": {
+                        "type": "object"
+                      },
+                      "type": "array"
+                    },
+                    "expression": {
+                      "type": "string"
+                    },
+                    "id": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "fixedFooter": {
+                "properties": {
+                  "primaryButton": {
+                    "type": "object"
+                  },
+                  "secondaryButton": {
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              },
+              "header": {
+                "properties": {
+                  "imageAltText": {
+                    "type": "string"
+                  },
+                  "imageType": {
+                    "enum": [
+                      "SQUARE",
+                      "CIRCLE"
+                    ],
+                    "type": "string"
+                  },
+                  "imageUrl": {
+                    "type": "string"
+                  },
+                  "subtitle": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "name": {
+                "type": "string"
+              },
+              "peekCardHeader": {
+                "properties": {
+                  "imageAltText": {
+                    "type": "string"
+                  },
+                  "imageType": {
+                    "enum": [
+                      "SQUARE",
+                      "CIRCLE"
+                    ],
+                    "type": "string"
+                  },
+                  "imageUrl": {
+                    "type": "string"
+                  },
+                  "subtitle": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sectionDividerStyle": {
+                "enum": [
+                  "DIVIDER_STYLE_UNSPECIFIED",
+                  "SOLID_DIVIDER",
+                  "NO_DIVIDER"
+                ],
+                "type": "string"
+              },
+              "sections": {
+                "items": {
+                  "properties": {
+                    "collapseControl": {
+                      "type": "object"
+                    },
+                    "collapsible": {
+                      "type": "boolean"
+                    },
+                    "header": {
+                      "type": "string"
+                    },
+                    "id": {
+                      "type": "string"
+                    },
+                    "uncollapsibleWidgetsCount": {
+                      "type": "integer"
+                    },
+                    "widgets": {
+                      "items": {
+                        "type": "object"
+                      },
+                      "type": "array"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          },
+          "cardId": {
+            "type": "string"
+          },
+          "ownerUser": {
+            "properties": {
+              "avatarUrl": {
+                "type": "string"
+              },
+              "displayName": {
+                "type": "string"
+              },
+              "domainId": {
+                "type": "string"
+              },
+              "email": {
+                "type": "string"
+              },
+              "isAnonymous": {
+                "type": "boolean"
+              },
+              "name": {
+                "type": "string"
+              },
+              "type": {
+                "enum": [
+                  "TYPE_UNSPECIFIED",
+                  "HUMAN",
+                  "BOT"
+                ],
+                "type": "string"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "clientAssignedMessageId": {
+      "type": "string"
+    },
+    "createTime": {
+      "type": "string"
+    },
+    "deleteTime": {
+      "type": "string"
+    },
+    "deletionMetadata": {
+      "properties": {
+        "deletionType": {
+          "enum": [
+            "DELETION_TYPE_UNSPECIFIED",
+            "CREATOR",
+            "SPACE_OWNER",
+            "ADMIN",
+            "APP_MESSAGE_EXPIRY",
+            "CREATOR_VIA_APP",
+            "SPACE_OWNER_VIA_APP",
+            "SPACE_MEMBER"
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "emojiReactionSummaries": {
+      "items": {
+        "properties": {
+          "emoji": {
+            "properties": {
+              "customEmoji": {
+                "properties": {
+                  "emojiName": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "payload": {
+                    "type": "object"
+                  },
+                  "temporaryImageUri": {
+                    "type": "string"
+                  },
+                  "uid": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "unicode": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "reactionCount": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "fallbackText": {
+      "type": "string"
+    },
+    "formattedText": {
+      "type": "string"
+    },
+    "lastUpdateTime": {
+      "type": "string"
+    },
+    "markupSyntax": {
+      "enum": [
+        "MARKUP_SYNTAX_UNSPECIFIED",
+        "MARKUP_SYNTAX_CHAT",
+        "MARKUP_SYNTAX_MARKDOWN"
+      ],
+      "type": "string"
+    },
+    "matchedUrl": {
+      "properties": {
+        "url": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "name": {
+      "type": "string"
+    },
+    "privateMessageViewer": {
+      "properties": {
+        "avatarUrl": {
+          "type": "string"
+        },
+        "displayName": {
+          "type": "string"
+        },
+        "domainId": {
+          "type": "string"
+        },
+        "email": {
+          "type": "string"
+        },
+        "isAnonymous": {
+          "type": "boolean"
+        },
+        "name": {
+          "type": "string"
+        },
+        "type": {
+          "enum": [
+            "TYPE_UNSPECIFIED",
+            "HUMAN",
+            "BOT"
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "quotedMessageMetadata": {
+      "properties": {
+        "forwardedMetadata": {
+          "properties": {
+            "space": {
+              "type": "string"
+            },
+            "spaceDisplayName": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "lastUpdateTime": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "quoteType": {
+          "enum": [
+            "QUOTE_TYPE_UNSPECIFIED",
+            "REPLY",
+            "FORWARD"
+          ],
+          "type": "string"
+        },
+        "quotedMessageSnapshot": {
+          "properties": {
+            "annotations": {
+              "items": {
+                "properties": {
+                  "customEmojiMetadata": {
+                    "type": "object"
+                  },
+                  "length": {
+                    "type": "integer"
+                  },
+                  "richLinkMetadata": {
+                    "type": "object"
+                  },
+                  "slashCommand": {
+                    "type": "object"
+                  },
+                  "startIndex": {
+                    "type": "integer"
+                  },
+                  "type": {
+                    "enum": [
+                      "ANNOTATION_TYPE_UNSPECIFIED",
+                      "USER_MENTION",
+                      "SLASH_COMMAND",
+                      "RICH_LINK",
+                      "CUSTOM_EMOJI"
+                    ],
+                    "type": "string"
+                  },
+                  "userMention": {
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "attachments": {
+              "items": {
+                "properties": {
+                  "attachmentDataRef": {
+                    "type": "object"
+                  },
+                  "contentName": {
+                    "type": "string"
+                  },
+                  "contentType": {
+                    "type": "string"
+                  },
+                  "downloadUri": {
+                    "type": "string"
+                  },
+                  "driveDataRef": {
+                    "type": "object"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "source": {
+                    "enum": [
+                      "SOURCE_UNSPECIFIED",
+                      "DRIVE_FILE",
+                      "UPLOADED_CONTENT"
+                    ],
+                    "type": "string"
+                  },
+                  "thumbnailUri": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "formattedText": {
+              "type": "string"
+            },
+            "sender": {
+              "type": "string"
+            },
+            "text": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
+    "sender": {
+      "properties": {
+        "avatarUrl": {
+          "type": "string"
+        },
+        "displayName": {
+          "type": "string"
+        },
+        "domainId": {
+          "type": "string"
+        },
+        "email": {
+          "type": "string"
+        },
+        "isAnonymous": {
+          "type": "boolean"
+        },
+        "name": {
+          "type": "string"
+        },
+        "type": {
+          "enum": [
+            "TYPE_UNSPECIFIED",
+            "HUMAN",
+            "BOT"
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "silent": {
+      "type": "boolean"
+    },
+    "slashCommand": {
+      "properties": {
+        "commandId": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "space": {
+      "properties": {
+        "accessSettings": {
+          "properties": {
+            "accessPermissionSettings": {
+              "properties": {
+                "discoverSpaceSetting": {
+                  "type": "object"
+                },
+                "joinSpaceSetting": {
+                  "type": "object"
+                },
+                "viewSpaceMembershipSetting": {
+                  "type": "object"
+                }
+              },
+              "type": "object"
+            },
+            "accessState": {
+              "enum": [
+                "ACCESS_STATE_UNSPECIFIED",
+                "PRIVATE",
+                "DISCOVERABLE"
+              ],
+              "type": "string"
+            },
+            "audience": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "adminInstalled": {
+          "type": "boolean"
+        },
+        "createTime": {
+          "type": "string"
+        },
+        "customer": {
+          "type": "string"
+        },
+        "displayName": {
+          "type": "string"
+        },
+        "externalUserAllowed": {
+          "type": "boolean"
+        },
+        "importMode": {
+          "type": "boolean"
+        },
+        "importModeExpireTime": {
+          "type": "string"
+        },
+        "lastActiveTime": {
+          "type": "string"
+        },
+        "membershipCount": {
+          "properties": {
+            "joinedDirectHumanUserCount": {
+              "type": "integer"
+            },
+            "joinedGroupCount": {
+              "type": "integer"
+            }
+          },
+          "type": "object"
+        },
+        "name": {
+          "type": "string"
+        },
+        "permissionSettings": {
+          "properties": {
+            "manageApps": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "manageMembersAndGroups": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "manageWebhooks": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "modifySpaceDetails": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "postMessages": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "replyMessages": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "toggleHistory": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "useAtMentionAll": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "viewSpaceMembership": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            }
+          },
+          "type": "object"
+        },
+        "predefinedPermissionSettings": {
+          "enum": [
+            "PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED",
+            "COLLABORATION_SPACE",
+            "ANNOUNCEMENT_SPACE"
+          ],
+          "type": "string"
+        },
+        "singleUserBotDm": {
+          "type": "boolean"
+        },
+        "spaceDetails": {
+          "properties": {
+            "description": {
+              "type": "string"
+            },
+            "guidelines": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "spaceHistoryState": {
+          "enum": [
+            "HISTORY_STATE_UNSPECIFIED",
+            "HISTORY_OFF",
+            "HISTORY_ON"
+          ],
+          "type": "string"
+        },
+        "spaceThreadingState": {
+          "enum": [
+            "SPACE_THREADING_STATE_UNSPECIFIED",
+            "THREADED_MESSAGES",
+            "GROUPED_MESSAGES",
+            "UNTHREADED_MESSAGES"
+          ],
+          "type": "string"
+        },
+        "spaceType": {
+          "enum": [
+            "SPACE_TYPE_UNSPECIFIED",
+            "SPACE",
+            "GROUP_CHAT",
+            "DIRECT_MESSAGE"
+          ],
+          "type": "string"
+        },
+        "spaceUri": {
+          "type": "string"
+        },
+        "threaded": {
+          "type": "boolean"
+        },
+        "type": {
+          "enum": [
+            "TYPE_UNSPECIFIED",
+            "ROOM",
+            "DM"
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "text": {
+      "type": "string"
+    },
+    "thread": {
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "threadKey": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "threadReply": {
+      "type": "boolean"
+    }
+  },
+  "type": "object"
+}

Changed6 schema fields changedOct 26, 2026

changedInput schema / properties / allowMissing / description

Previous value: -"Optional. If `true` and the message isn't found, a new message is created and `updateMask` is ignored. The specified message ID must be [client-assigned](https:"New value: +"[query parameter] Optional. If `true` and the message isn't found, a new message is created and `updateMask` is ignored. The specified message ID must be [client-assigned](https:"

changedInput schema / properties / name / description

Previous value: -"Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{m"New value: +"[URL path segment] Identifier. Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{m"

addedInput schema / properties / name / pattern

Added value: +"^spaces/[^/]+/messages/[^/]+$"

changedInput schema / properties / updateMask / description

Previous value: -"Required. The field paths to update. Separate multiple values with commas or use `*` to update all field paths. Currently supported field paths: - `text` - `att"New value: +"[query parameter] Required. The field paths to update. Separate multiple values with commas or use `*` to update all field paths. Currently supported field paths: - `text` - `att"

addedInput schema / properties / updateMask / format
```
Added value: +"google-fieldmask"
```

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "accessoryWidgets": {
+      "items": {
+        "properties": {
+          "buttonList": {
+            "properties": {
+              "buttons": {
+                "items": {
+                  "properties": {
+                    "altText": {
+                      "type": "string"
+                    },
+                    "color": {
+                      "type": "object"
+                    },
+                    "disabled": {
+                      "type": "boolean"
+                    },
+                    "icon": {
+                      "type": "object"
+                    },
+                    "onClick": {
+                      "type": "object"
+                    },
+                    "text": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "enum": [
+                        "TYPE_UNSPECIFIED",
+                        "OUTLINED",
+                        "FILLED",
+                        "FILLED_TONAL",
+                        "BORDERLESS"
+                      ],
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "actionResponse": {
+      "properties": {
+        "dialogAction": {
+          "properties": {
+            "actionStatus": {
+              "properties": {
+                "statusCode": {
+                  "enum": [
+                    "OK",
+                    "CANCELLED",
+                    "UNKNOWN",
+                    "INVALID_ARGUMENT",
+                    "DEADLINE_EXCEEDED",
+                    "NOT_FOUND",
+                    "ALREADY_EXISTS",
+                    "PERMISSION_DENIED",
+                    "UNAUTHENTICATED",
+                    "RESOURCE_EXHAUSTED",
+                    "FAILED_PRECONDITION",
+                    "ABORTED",
+                    "OUT_OF_RANGE",
+                    "UNIMPLEMENTED",
+                    "INTERNAL",
+                    "UNAVAILABLE",
+                    "DATA_LOSS"
+                  ],
+                  "type": "string"
+                },
+                "userFacingMessage": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "dialog": {
+              "properties": {
+                "body": {
+                  "type": "object"
+                }
+              },
+              "type": "object"
+            }
+          },
+          "type": "object"
+        },
+        "type": {
+          "enum": [
+            "TYPE_UNSPECIFIED",
+            "NEW_MESSAGE",
+            "UPDATE_MESSAGE",
+            "UPDATE_USER_MESSAGE_CARDS",
+            "REQUEST_CONFIG",
+            "DIALOG",
+            "UPDATE_WIDGET"
+          ],
+          "type": "string"
+        },
+        "updatedWidget": {
+          "properties": {
+            "suggestions": {
+              "properties": {
+                "items": {
+                  "items": {
+                    "type": "object"
+                  },
+                  "type": "array"
+                }
+              },
+              "type": "object"
+            },
+            "widget": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "url": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "annotations": {
+      "items": {
+        "properties": {
+          "customEmojiMetadata": {
+            "properties": {
+              "customEmoji": {
+                "properties": {
+                  "emojiName": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "payload": {
+                    "type": "object"
+                  },
+                  "temporaryImageUri": {
+                    "type": "string"
+                  },
+                  "uid": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "length": {
+            "type": "integer"
+          },
+          "richLinkMetadata": {
+            "properties": {
+              "calendarEventLinkData": {
+                "properties": {
+                  "calendarId": {
+                    "type": "string"
+                  },
+                  "eventId": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "chatSpaceLinkData": {
+                "properties": {
+                  "message": {
+                    "type": "string"
+                  },
+                  "space": {
+                    "type": "string"
+                  },
+                  "thread": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "driveLinkData": {
+                "properties": {
+                  "driveDataRef": {
+                    "type": "object"
+                  },
+                  "mimeType": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "meetSpaceLinkData": {
+                "properties": {
+                  "huddleStatus": {
+                    "enum": [
+                      "HUDDLE_STATUS_UNSPECIFIED",
+                      "STARTED",
+                      "ENDED",
+                      "MISSED"
+                    ],
+                    "type": "string"
+                  },
+                  "meetingCode": {
+                    "type": "string"
+                  },
+                  "type": {
+                    "enum": [
+                      "TYPE_UNSPECIFIED",
+                      "MEETING",
+                      "HUDDLE"
+                    ],
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "richLinkType": {
+                "enum": [
+                  "RICH_LINK_TYPE_UNSPECIFIED",
+                  "DRIVE_FILE",
+                  "CHAT_SPACE",
+                  "GMAIL_MESSAGE",
+                  "MEET_SPACE",
+                  "CALENDAR_EVENT"
+                ],
+                "type": "string"
+              },
+              "uri": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "slashCommand": {
+            "properties": {
+              "bot": {
+                "properties": {
+                  "avatarUrl": {
+                    "type": "string"
+                  },
+                  "displayName": {
+                    "type": "string"
+                  },
+                  "domainId": {
+                    "type": "string"
+                  },
+                  "email": {
+                    "type": "string"
+                  },
+                  "isAnonymous": {
+                    "type": "boolean"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "type": {
+                    "enum": [
+                      "TYPE_UNSPECIFIED",
+                      "HUMAN",
+                      "BOT"
+                    ],
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "commandId": {
+                "type": "string"
+              },
+              "commandName": {
+                "type": "string"
+              },
+              "triggersDialog": {
+                "type": "boolean"
+              },
+              "type": {
+                "enum": [
+                  "TYPE_UNSPECIFIED",
+                  "ADD",
+                  "INVOKE"
+                ],
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "startIndex": {
+            "type": "integer"
+          },
+          "type": {
+            "enum": [
+              "ANNOTATION_TYPE_UNSPECIFIED",
+              "USER_MENTION",
+              "SLASH_COMMAND",
+              "RICH_LINK",
+              "CUSTOM_EMOJI"
+            ],
+            "type": "string"
+          },
+          "userMention": {
+            "properties": {
+              "type": {
+                "enum": [
+                  "TYPE_UNSPECIFIED",
+                  "ADD",
+                  "MENTION"
+                ],
+                "type": "string"
+              },
+              "user": {
+                "properties": {
+                  "avatarUrl": {
+                    "type": "string"
+                  },
+                  "displayName": {
+                    "type": "string"
+                  },
+                  "domainId": {
+                    "type": "string"
+                  },
+                  "email": {
+                    "type": "string"
+                  },
+                  "isAnonymous": {
+                    "type": "boolean"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "type": {
+                    "enum": [
+                      "TYPE_UNSPECIFIED",
+                      "HUMAN",
+                      "BOT"
+                    ],
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "argumentText": {
+      "type": "string"
+    },
+    "attachedGifs": {
+      "items": {
+        "properties": {
+          "uri": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "attachment": {
+      "items": {
+        "properties": {
+          "attachmentDataRef": {
+            "properties": {
+              "attachmentUploadToken": {
+                "type": "string"
+              },
+              "resourceName": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "contentName": {
+            "type": "string"
+          },
+          "contentType": {
+            "type": "string"
+          },
+          "downloadUri": {
+            "type": "string"
+          },
+          "driveDataRef": {
+            "properties": {
+              "driveFileId": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "name": {
+            "type": "string"
+          },
+          "source": {
+            "enum": [
+              "SOURCE_UNSPECIFIED",
+              "DRIVE_FILE",
+              "UPLOADED_CONTENT"
+            ],
+            "type": "string"
+          },
+          "thumbnailUri": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "cards": {
+      "items": {
+        "properties": {
+          "cardActions": {
+            "items": {
+              "properties": {
+                "actionLabel": {
+                  "type": "string"
+                },
+                "onClick": {
+                  "properties": {
+                    "action": {
+                      "type": "object"
+                    },
+                    "openLink": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "header": {
+            "properties": {
+              "imageStyle": {
+                "enum": [
+                  "IMAGE_STYLE_UNSPECIFIED",
+                  "IMAGE",
+                  "AVATAR"
+                ],
+                "type": "string"
+              },
+              "imageUrl": {
+                "type": "string"
+              },
+              "subtitle": {
+                "type": "string"
+              },
+              "title": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "name": {
+            "type": "string"
+          },
+          "sections": {
+            "items": {
+              "properties": {
+                "header": {
+                  "type": "string"
+                },
+                "widgets": {
+                  "items": {
+                    "properties": {
+                      "buttons": {
+                        "items": {
+                          "type": "object"
+                        },
+                        "type": "array"
+                      },
+                      "image": {
+                        "type": "object"
+                      },
+                      "keyValue": {
+                        "type": "object"
+                      },
+                      "textParagraph": {
+                        "type": "object"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "type": "array"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "cardsV2": {
+      "items": {
+        "properties": {
+          "card": {
+            "properties": {
+              "cardActions": {
+                "items": {
+                  "properties": {
+                    "actionLabel": {
+                      "type": "string"
+                    },
+                    "onClick": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "displayStyle": {
+                "enum": [
+                  "DISPLAY_STYLE_UNSPECIFIED",
+                  "PEEK",
+                  "REPLACE"
+                ],
+                "type": "string"
+              },
+              "expressionData": {
+                "items": {
+                  "properties": {
+                    "conditions": {
+                      "items": {
+                        "type": "object"
+                      },
+                      "type": "array"
+                    },
+                    "eventActions": {
+                      "items": {
+                        "type": "object"
+                      },
+                      "type": "array"
+                    },
+                    "expression": {
+                      "type": "string"
+                    },
+                    "id": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "fixedFooter": {
+                "properties": {
+                  "primaryButton": {
+                    "type": "object"
+                  },
+                  "secondaryButton": {
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              },
+              "header": {
+                "properties": {
+                  "imageAltText": {
+                    "type": "string"
+                  },
+                  "imageType": {
+                    "enum": [
+                      "SQUARE",
+                      "CIRCLE"
+                    ],
+                    "type": "string"
+                  },
+                  "imageUrl": {
+                    "type": "string"
+                  },
+                  "subtitle": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "name": {
+                "type": "string"
+              },
+              "peekCardHeader": {
+                "properties": {
+                  "imageAltText": {
+                    "type": "string"
+                  },
+                  "imageType": {
+                    "enum": [
+                      "SQUARE",
+                      "CIRCLE"
+                    ],
+                    "type": "string"
+                  },
+                  "imageUrl": {
+                    "type": "string"
+                  },
+                  "subtitle": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "sectionDividerStyle": {
+                "enum": [
+                  "DIVIDER_STYLE_UNSPECIFIED",
+                  "SOLID_DIVIDER",
+                  "NO_DIVIDER"
+                ],
+                "type": "string"
+              },
+              "sections": {
+                "items": {
+                  "properties": {
+                    "collapseControl": {
+                      "type": "object"
+                    },
+                    "collapsible": {
+                      "type": "boolean"
+                    },
+                    "header": {
+                      "type": "string"
+                    },
+                    "id": {
+                      "type": "string"
+                    },
+                    "uncollapsibleWidgetsCount": {
+                      "type": "integer"
+                    },
+                    "widgets": {
+                      "items": {
+                        "type": "object"
+                      },
+                      "type": "array"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          },
+          "cardId": {
+            "type": "string"
+          },
+          "ownerUser": {
+            "properties": {
+              "avatarUrl": {
+                "type": "string"
+              },
+              "displayName": {
+                "type": "string"
+              },
+              "domainId": {
+                "type": "string"
+              },
+              "email": {
+                "type": "string"
+              },
+              "isAnonymous": {
+                "type": "boolean"
+              },
+              "name": {
+                "type": "string"
+              },
+              "type": {
+                "enum": [
+                  "TYPE_UNSPECIFIED",
+                  "HUMAN",
+                  "BOT"
+                ],
+                "type": "string"
+              }
+            },
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "clientAssignedMessageId": {
+      "type": "string"
+    },
+    "createTime": {
+      "type": "string"
+    },
+    "deleteTime": {
+      "type": "string"
+    },
+    "deletionMetadata": {
+      "properties": {
+        "deletionType": {
+          "enum": [
+            "DELETION_TYPE_UNSPECIFIED",
+            "CREATOR",
+            "SPACE_OWNER",
+            "ADMIN",
+            "APP_MESSAGE_EXPIRY",
+            "CREATOR_VIA_APP",
+            "SPACE_OWNER_VIA_APP",
+            "SPACE_MEMBER"
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "emojiReactionSummaries": {
+      "items": {
+        "properties": {
+          "emoji": {
+            "properties": {
+              "customEmoji": {
+                "properties": {
+                  "emojiName": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "payload": {
+                    "type": "object"
+                  },
+                  "temporaryImageUri": {
+                    "type": "string"
+                  },
+                  "uid": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "unicode": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "reactionCount": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "fallbackText": {
+      "type": "string"
+    },
+    "formattedText": {
+      "type": "string"
+    },
+    "lastUpdateTime": {
+      "type": "string"
+    },
+    "markupSyntax": {
+      "enum": [
+        "MARKUP_SYNTAX_UNSPECIFIED",
+        "MARKUP_SYNTAX_CHAT",
+        "MARKUP_SYNTAX_MARKDOWN"
+      ],
+      "type": "string"
+    },
+    "matchedUrl": {
+      "properties": {
+        "url": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "name": {
+      "type": "string"
+    },
+    "privateMessageViewer": {
+      "properties": {
+        "avatarUrl": {
+          "type": "string"
+        },
+        "displayName": {
+          "type": "string"
+        },
+        "domainId": {
+          "type": "string"
+        },
+        "email": {
+          "type": "string"
+        },
+        "isAnonymous": {
+          "type": "boolean"
+        },
+        "name": {
+          "type": "string"
+        },
+        "type": {
+          "enum": [
+            "TYPE_UNSPECIFIED",
+            "HUMAN",
+            "BOT"
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "quotedMessageMetadata": {
+      "properties": {
+        "forwardedMetadata": {
+          "properties": {
+            "space": {
+              "type": "string"
+            },
+            "spaceDisplayName": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "lastUpdateTime": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "quoteType": {
+          "enum": [
+            "QUOTE_TYPE_UNSPECIFIED",
+            "REPLY",
+            "FORWARD"
+          ],
+          "type": "string"
+        },
+        "quotedMessageSnapshot": {
+          "properties": {
+            "annotations": {
+              "items": {
+                "properties": {
+                  "customEmojiMetadata": {
+                    "type": "object"
+                  },
+                  "length": {
+                    "type": "integer"
+                  },
+                  "richLinkMetadata": {
+                    "type": "object"
+                  },
+                  "slashCommand": {
+                    "type": "object"
+                  },
+                  "startIndex": {
+                    "type": "integer"
+                  },
+                  "type": {
+                    "enum": [
+                      "ANNOTATION_TYPE_UNSPECIFIED",
+                      "USER_MENTION",
+                      "SLASH_COMMAND",
+                      "RICH_LINK",
+                      "CUSTOM_EMOJI"
+                    ],
+                    "type": "string"
+                  },
+                  "userMention": {
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "attachments": {
+              "items": {
+                "properties": {
+                  "attachmentDataRef": {
+                    "type": "object"
+                  },
+                  "contentName": {
+                    "type": "string"
+                  },
+                  "contentType": {
+                    "type": "string"
+                  },
+                  "downloadUri": {
+                    "type": "string"
+                  },
+                  "driveDataRef": {
+                    "type": "object"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "source": {
+                    "enum": [
+                      "SOURCE_UNSPECIFIED",
+                      "DRIVE_FILE",
+                      "UPLOADED_CONTENT"
+                    ],
+                    "type": "string"
+                  },
+                  "thumbnailUri": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "formattedText": {
+              "type": "string"
+            },
+            "sender": {
+              "type": "string"
+            },
+            "text": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
+    "sender": {
+      "properties": {
+        "avatarUrl": {
+          "type": "string"
+        },
+        "displayName": {
+          "type": "string"
+        },
+        "domainId": {
+          "type": "string"
+        },
+        "email": {
+          "type": "string"
+        },
+        "isAnonymous": {
+          "type": "boolean"
+        },
+        "name": {
+          "type": "string"
+        },
+        "type": {
+          "enum": [
+            "TYPE_UNSPECIFIED",
+            "HUMAN",
+            "BOT"
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "silent": {
+      "type": "boolean"
+    },
+    "slashCommand": {
+      "properties": {
+        "commandId": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "space": {
+      "properties": {
+        "accessSettings": {
+          "properties": {
+            "accessPermissionSettings": {
+              "properties": {
+                "discoverSpaceSetting": {
+                  "type": "object"
+                },
+                "joinSpaceSetting": {
+                  "type": "object"
+                },
+                "viewSpaceMembershipSetting": {
+                  "type": "object"
+                }
+              },
+              "type": "object"
+            },
+            "accessState": {
+              "enum": [
+                "ACCESS_STATE_UNSPECIFIED",
+                "PRIVATE",
+                "DISCOVERABLE"
+              ],
+              "type": "string"
+            },
+            "audience": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "adminInstalled": {
+          "type": "boolean"
+        },
+        "createTime": {
+          "type": "string"
+        },
+        "customer": {
+          "type": "string"
+        },
+        "displayName": {
+          "type": "string"
+        },
+        "externalUserAllowed": {
+          "type": "boolean"
+        },
+        "importMode": {
+          "type": "boolean"
+        },
+        "importModeExpireTime": {
+          "type": "string"
+        },
+        "lastActiveTime": {
+          "type": "string"
+        },
+        "membershipCount": {
+          "properties": {
+            "joinedDirectHumanUserCount": {
+              "type": "integer"
+            },
+            "joinedGroupCount": {
+              "type": "integer"
+            }
+          },
+          "type": "object"
+        },
+        "name": {
+          "type": "string"
+        },
+        "permissionSettings": {
+          "properties": {
+            "manageApps": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "manageMembersAndGroups": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "manageWebhooks": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "modifySpaceDetails": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "postMessages": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "replyMessages": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "toggleHistory": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "useAtMentionAll": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "viewSpaceMembership": {
+              "properties": {
+                "assistantManagersAllowed": {
+                  "type": "boolean"
+                },
+                "managersAllowed": {
+                  "type": "boolean"
+                },
+                "membersAllowed": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            }
+          },
+          "type": "object"
+        },
+        "predefinedPermissionSettings": {
+          "enum": [
+            "PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED",
+            "COLLABORATION_SPACE",
+            "ANNOUNCEMENT_SPACE"
+          ],
+          "type": "string"
+        },
+        "singleUserBotDm": {
+          "type": "boolean"
+        },
+        "spaceDetails": {
+          "properties": {
+            "description": {
+              "type": "string"
+            },
+            "guidelines": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "spaceHistoryState": {
+          "enum": [
+            "HISTORY_STATE_UNSPECIFIED",
+            "HISTORY_OFF",
+            "HISTORY_ON"
+          ],
+          "type": "string"
+        },
+        "spaceThreadingState": {
+          "enum": [
+            "SPACE_THREADING_STATE_UNSPECIFIED",
+            "THREADED_MESSAGES",
+            "GROUPED_MESSAGES",
+            "UNTHREADED_MESSAGES"
+          ],
+          "type": "string"
+        },
+        "spaceType": {
+          "enum": [
+            "SPACE_TYPE_UNSPECIFIED",
+            "SPACE",
+            "GROUP_CHAT",
+            "DIRECT_MESSAGE"
+          ],
+          "type": "string"
+        },
+        "spaceUri": {
+          "type": "string"
+        },
+        "threaded": {
+          "type": "boolean"
+        },
+        "type": {
+          "enum": [
+            "TYPE_UNSPECIFIED",
+            "ROOM",
+            "DM"
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "text": {
+      "type": "string"
+    },
+    "thread": {
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "threadKey": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "threadReply": {
+      "type": "boolean"
+    }
+  },
+  "type": "object"
+}

First observedOct 26, 2026

TDQS

A4.1/5.0

Behavior4/5

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

With no annotations, the description carries the disclosure burden and does much of it: it names the HTTP PUT verb, warns the call is 'refused under --readonly safety profiles', notes authentication requirements, and says the API's response resource is returned as JSON. It omits mutation-side consequences such as what updateMask omitting fields does to existing content, which keeps it below 5.

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?

Core behavior and the patch-vs-update recommendation are front-loaded, and the sibling list at the end aids orientation. However the pasted auth-scope link fragment is truncated mid-URL and adds noise without usable information.

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

Completeness4/5

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

For a large-nested-body mutation tool with an output schema, the description covers what matters: it is a write operation, its safety profile behavior, auth requirements, and where the response comes from. The main remaining gap is explaining updateMask/allowMissing interactions, which matter for a PUT-style update.

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

Parameters3/5

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

Schema coverage is 100%, so every parameter including updateMask, allowMissing, params and body_file is already documented in structured data; the baseline is 3. The description only adds the routing note that the body can be passed via `params` or wholesale via `body_file`, and lists body fields that the schema already enumerates.

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?

States a specific verb and resource ('Updates a message') and immediately distinguishes it from the sibling that does almost the same thing by explaining PATCH vs PUT semantics. An agent can tell update apart from patch, replaceCards and create without opening any schema.

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?

It explicitly recommends the sibling `patch` method over this one and explains the mechanical difference (PATCH request vs PUT request), which is real routing guidance. It falls short of a 5 because it never says when `update` is the required choice — e.g. when full-replacement semantics are actually wanted.

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

Deploy Server