grr

Overview Schema Source Related Servers Discussions Admin

chat.spaces.messages.get

Retrieve details about a Google Chat message by its resource name, including formatted text and metadata. Use it to inspect, verify, or debug a specific message in a space.

Instructions

Returns details about a message. For an example, see Get details about a message. Supports the following types of authentication: - App authentication with one of the following authorization scopes: - https://www.googleapis.com/auth/chat.bot: When using this authorization scope, this method returns details about a message the Chat app has access to, like direct messages and [slash co [HTTP GET]. Returns the requested resource as JSON — request bodies are built from the typed parameters (typed flags win over the params map), or read whole from body_file Siblings over the same resource: create, delete, list, patch, replaceCards, search, update.

Input Schema

Name	Required	Description
`name`	Yes	[URL path segment] Required. Resource name of the message. Format: `spaces/{space}/messages/{message}` If you've set a custom ID for your message, you can use the value from the `
`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.
`markupSyntax`	No	[query parameter] Optional. Specifies the desired output syntax for the Chat message `formatted_text` field. Values: `MARKUP_SYNTAX_UNSPECIFIED` = Represents the unspecified value.; `MARKUP_SYNTAX_CHAT` = Uses Google Chat's markup syntax. See https://developers.google.com/workspace/chat/format-messages#format-texts for more information.; `MARKUP_SYNTAX_MARKDOWN` = Uses Markdown syntax. This syntax is based on the [CommonMark](https://commonmark.org/help/) specification, with additional extensions. See https://developers.google.com/workspace/chat/format-messages#format-texts for more information..

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.

Changed4 schema fields changedOct 26, 2026

changedInput schema / properties / markupSyntax / description

Previous value: -"Optional. Specifies the desired output syntax for the Chat message `formatted_text` field."New value: +"[query parameter] Optional. Specifies the desired output syntax for the Chat message `formatted_text` field. Values: `MARKUP_SYNTAX_UNSPECIFIED` = Represents the unspecified value.; `MARKUP_SYNTAX_CHAT` = Uses Google Chat's markup syntax. See https://developers.google.com/workspace/chat/format-messages#format-texts for more information.; `MARKUP_SYNTAX_MARKDOWN` = Uses Markdown syntax. This syntax is based on the [CommonMark](https://commonmark.org/help/) specification, with additional extensions. See https://developers.google.com/workspace/chat/format-messages#format-texts for more information.."

changedInput schema / properties / name / description

Previous value: -"Required. Resource name of the message. Format: `spaces/{space}/messages/{message}` If you've set a custom ID for your message, you can use the value from the `"New value: +"[URL path segment] Required. Resource name of the message. Format: `spaces/{space}/messages/{message}` If you've set a custom ID for your message, you can use the value from the `"

addedInput schema / properties / name / pattern

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

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

B3.2/5.0

Behavior3/5

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

With no annotations, the description carries the full behavioral burden. It usefully discloses that this is an HTTP GET, returns the resource as JSON, and is governed by Chat app authentication scopes and access limitations. However, the authentication section is truncated and the description does not fully cover permissions, rate limits, or error behavior.

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

Conciseness2/5

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

The purpose is front-loaded, but the description is cluttered with authentication boilerplate, a broken/truncated sentence, and generic request-body details that are not relevant to a GET operation. The sibling list is useful, but overall it is longer and noisier than necessary.

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

Completeness3/5

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

Given the rich schema and the presence of an output schema, the description does not need to explain return fields. It covers the core purpose and some authentication context, but the truncated authentication section and lack of explicit usage guidance leave gaps for an agent selecting among message operations.

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 description coverage is 100%, so the input schema already documents the parameters in detail. The description adds only generic wrapper behavior about typed parameters, the params map, and body_file, without explaining name or markupSyntax beyond what the schema provides. Baseline 3 is appropriate when the schema does the heavy lifting.

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?

The description states a clear verb and resource: 'Returns details about a message.' It also names the sibling operations over the same resource, which helps an agent distinguish get from create, delete, list, patch, search, and update. It does not explicitly explain the get-vs-list/search distinction, but the core purpose is unambiguous.

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?

Usage is only implied by the purpose and the sibling list. The description does not explicitly say when to use this tool instead of list or search, nor does it state prerequisites beyond authentication. An agent can infer retrieval of a single message by resource name, but conditions and exclusions are not spelled out.

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

Deploy Server