grr

Overview Schema Source Related Servers Discussions Admin

chat.spaces.messages.patch

Updates a Google Chat space message using PATCH and updateMask to apply partial field changes without replacing the entire message.

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 PATCH] — 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, replaceCards, search, update.

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

A3.5/5.0

Behavior3/5

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

No annotations are provided, so the description carries the full burden. It discloses the mutation nature, notes it is 'refused under --readonly safety profiles', lists auth/scopes, and states it returns the response resource as JSON. It does not explain what happens to unspecified fields, side effects, or rate limits, leaving meaningful gaps for a mutation tool.

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

Conciseness3/5

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

The key statement ('Updates a message') is front-loaded, which is good. But the body contains a large, partly-truncated dump of Google auth-scope boilerplate ('...auth/ch') that adds noise rather than decision-relevant signal, diluting the otherwise useful content.

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?

An output schema exists, so return values needn't be explained, and the description covers the mutation, body-passing mechanisms, and auth. Combined with schema documentation of updateMask and allowMissing, an agent has enough to call it correctly, though the absence of annotations leaves behavioral detail slightly thin.

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%, giving a baseline of 3, and the description adds value beyond the schema by enumerating representative body fields (accessoryWidgets, actionResponse, annotations, etc.) and clarifying the `params` vs `body_file` mechanisms for supplying the body. It stops short of detailing updateMask semantics, which the schema already covers.

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

Purpose4/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 explicitly differentiates itself from the sibling `update` method via PATCH vs PUT semantics. Passing references to an example and the sibling list reinforce scope, though the core statement is brief before drifting into auth boilerplate.

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

Usage Guidelines3/5

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

Recommends this tool over `update` ('We recommend using the `patch` method'), which is a form of routing guidance. However it gives no when-to-use context vs other siblings like replaceCards, and no prerequisites or when-not guidance; usage must be inferred.

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

Deploy Server