diff --git a/sentry_sdk/tracing_utils.py b/sentry_sdk/tracing_utils.py index b1e2050708..6aa4e4882a 100644 --- a/sentry_sdk/tracing_utils.py +++ b/sentry_sdk/tracing_utils.py @@ -543,6 +543,10 @@ def _sample_rand(self): class Baggage: """ The W3C Baggage header information (see https://www.w3.org/TR/baggage/). + + Before mutating a `Baggage` object, calling code must check that `mutable` is `True`. + Mutating a `Baggage` object that has `mutable` set to `False` is not allowed, but + it is the caller's responsibility to enforce this restriction. """ __slots__ = ("sentry_items", "third_party_items", "mutable")