Skip to content

Google: Modifies the labels applied to the thread This applies to all messages in the thread For more information, see Manage threads (https: developers google com workspace gmail api guides threads) — request body — body

Modifies the labels applied to the thread. This applies to all messages in the thread. For more information, see [Manage threads](https://developers.google.com/workspace/gmail/api/guides/threads).: request body, field body. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Modifies the labels applied to the thread This applies to all messages in the thread For more information, see Manage threads (https: developers google com workspace gmail api guides threads) — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
addLabelIdsarrayOptionalA list of IDs of labels to add to this thread. You can add up to 100 labels with each update.
addLabelIds[]stringEach item
removeLabelIdsarrayOptionalA list of IDs of labels to remove from this thread. You can remove up to 100 labels with each update.
removeLabelIds[]stringEach item

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.