diff --git a/src/libs/Phoenix/Generated/Phoenix.AnnotationsClient.ListSessionAnnotationsBySessionIds.g.cs b/src/libs/Phoenix/Generated/Phoenix.AnnotationsClient.ListSessionAnnotationsBySessionIds.g.cs
index 2af6e31..21b4109 100644
--- a/src/libs/Phoenix/Generated/Phoenix.AnnotationsClient.ListSessionAnnotationsBySessionIds.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.AnnotationsClient.ListSessionAnnotationsBySessionIds.g.cs
@@ -67,7 +67,7 @@ partial void ProcessListSessionAnnotationsBySessionIdsResponseContent(
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `session_ids` must be supplied. When combined with `session_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
@@ -121,7 +121,7 @@ partial void ProcessListSessionAnnotationsBySessionIdsResponseContent(
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `session_ids` must be supplied. When combined with `session_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
diff --git a/src/libs/Phoenix/Generated/Phoenix.AnnotationsClient.ListSpanAnnotationsBySpanIds.g.cs b/src/libs/Phoenix/Generated/Phoenix.AnnotationsClient.ListSpanAnnotationsBySpanIds.g.cs
index 22c88a5..1a24e9e 100644
--- a/src/libs/Phoenix/Generated/Phoenix.AnnotationsClient.ListSpanAnnotationsBySpanIds.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.AnnotationsClient.ListSpanAnnotationsBySpanIds.g.cs
@@ -67,7 +67,7 @@ partial void ProcessListSpanAnnotationsBySpanIdsResponseContent(
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `span_ids` must be supplied. When combined with `span_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
@@ -121,7 +121,7 @@ partial void ProcessListSpanAnnotationsBySpanIdsResponseContent(
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `span_ids` must be supplied. When combined with `span_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
diff --git a/src/libs/Phoenix/Generated/Phoenix.AnnotationsClient.ListTraceAnnotationsByTraceIds.g.cs b/src/libs/Phoenix/Generated/Phoenix.AnnotationsClient.ListTraceAnnotationsByTraceIds.g.cs
index 273504e..1fe3e04 100644
--- a/src/libs/Phoenix/Generated/Phoenix.AnnotationsClient.ListTraceAnnotationsByTraceIds.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.AnnotationsClient.ListTraceAnnotationsByTraceIds.g.cs
@@ -67,7 +67,7 @@ partial void ProcessListTraceAnnotationsByTraceIdsResponseContent(
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `trace_ids` must be supplied. When combined with `trace_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
@@ -121,7 +121,7 @@ partial void ProcessListTraceAnnotationsByTraceIdsResponseContent(
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `trace_ids` must be supplied. When combined with `trace_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
diff --git a/src/libs/Phoenix/Generated/Phoenix.IAnnotationsClient.ListSessionAnnotationsBySessionIds.g.cs b/src/libs/Phoenix/Generated/Phoenix.IAnnotationsClient.ListSessionAnnotationsBySessionIds.g.cs
index aa2ad78..a2e8e89 100644
--- a/src/libs/Phoenix/Generated/Phoenix.IAnnotationsClient.ListSessionAnnotationsBySessionIds.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.IAnnotationsClient.ListSessionAnnotationsBySessionIds.g.cs
@@ -18,7 +18,7 @@ public partial interface IAnnotationsClient
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `session_ids` must be supplied. When combined with `session_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
@@ -57,7 +57,7 @@ public partial interface IAnnotationsClient
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `session_ids` must be supplied. When combined with `session_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
diff --git a/src/libs/Phoenix/Generated/Phoenix.IAnnotationsClient.ListSpanAnnotationsBySpanIds.g.cs b/src/libs/Phoenix/Generated/Phoenix.IAnnotationsClient.ListSpanAnnotationsBySpanIds.g.cs
index 032c391..a23513b 100644
--- a/src/libs/Phoenix/Generated/Phoenix.IAnnotationsClient.ListSpanAnnotationsBySpanIds.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.IAnnotationsClient.ListSpanAnnotationsBySpanIds.g.cs
@@ -18,7 +18,7 @@ public partial interface IAnnotationsClient
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `span_ids` must be supplied. When combined with `span_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
@@ -57,7 +57,7 @@ public partial interface IAnnotationsClient
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `span_ids` must be supplied. When combined with `span_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
diff --git a/src/libs/Phoenix/Generated/Phoenix.IAnnotationsClient.ListTraceAnnotationsByTraceIds.g.cs b/src/libs/Phoenix/Generated/Phoenix.IAnnotationsClient.ListTraceAnnotationsByTraceIds.g.cs
index bde8ef0..1efaf1d 100644
--- a/src/libs/Phoenix/Generated/Phoenix.IAnnotationsClient.ListTraceAnnotationsByTraceIds.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.IAnnotationsClient.ListTraceAnnotationsByTraceIds.g.cs
@@ -18,7 +18,7 @@ public partial interface IAnnotationsClient
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `trace_ids` must be supplied. When combined with `trace_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
@@ -57,7 +57,7 @@ public partial interface IAnnotationsClient
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `trace_ids` must be supplied. When combined with `trace_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
diff --git a/src/libs/Phoenix/Generated/Phoenix.ISessionsClient.CreateSessionNote.g.cs b/src/libs/Phoenix/Generated/Phoenix.ISessionsClient.CreateSessionNote.g.cs
index 0c4683a..8df16e6 100644
--- a/src/libs/Phoenix/Generated/Phoenix.ISessionsClient.CreateSessionNote.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.ISessionsClient.CreateSessionNote.g.cs
@@ -6,7 +6,7 @@ public partial interface ISessionsClient
     {
         /// <summary>
         /// Create a session note<br/>
-        /// Add a note annotation to a session. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Structured annotations, by contrast, are keyed by (name, session_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a session you must supply distinct identifiers.
+        /// Add a note annotation to a session. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Callers may supply a non-empty `identifier` to upsert on (session_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -19,7 +19,7 @@ public partial interface ISessionsClient
             global::System.Threading.CancellationToken cancellationToken = default);
         /// <summary>
         /// Create a session note<br/>
-        /// Add a note annotation to a session. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Structured annotations, by contrast, are keyed by (name, session_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a session you must supply distinct identifiers.
+        /// Add a note annotation to a session. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Callers may supply a non-empty `identifier` to upsert on (session_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -32,7 +32,7 @@ public partial interface ISessionsClient
             global::System.Threading.CancellationToken cancellationToken = default);
         /// <summary>
         /// Create a session note<br/>
-        /// Add a note annotation to a session. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Structured annotations, by contrast, are keyed by (name, session_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a session you must supply distinct identifiers.
+        /// Add a note annotation to a session. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Callers may supply a non-empty `identifier` to upsert on (session_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="data"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
diff --git a/src/libs/Phoenix/Generated/Phoenix.ISpansClient.CreateSpanNote.g.cs b/src/libs/Phoenix/Generated/Phoenix.ISpansClient.CreateSpanNote.g.cs
index b2e7f7b..151dc0c 100644
--- a/src/libs/Phoenix/Generated/Phoenix.ISpansClient.CreateSpanNote.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.ISpansClient.CreateSpanNote.g.cs
@@ -6,7 +6,7 @@ public partial interface ISpansClient
     {
         /// <summary>
         /// Create a span note<br/>
-        /// Add a note annotation to a span. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Structured annotations, by contrast, are keyed by (name, span_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a span you must supply distinct identifiers.
+        /// Add a note annotation to a span. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Callers may supply a non-empty `identifier` to upsert on (span_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -19,7 +19,7 @@ public partial interface ISpansClient
             global::System.Threading.CancellationToken cancellationToken = default);
         /// <summary>
         /// Create a span note<br/>
-        /// Add a note annotation to a span. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Structured annotations, by contrast, are keyed by (name, span_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a span you must supply distinct identifiers.
+        /// Add a note annotation to a span. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Callers may supply a non-empty `identifier` to upsert on (span_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -32,7 +32,7 @@ public partial interface ISpansClient
             global::System.Threading.CancellationToken cancellationToken = default);
         /// <summary>
         /// Create a span note<br/>
-        /// Add a note annotation to a span. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Structured annotations, by contrast, are keyed by (name, span_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a span you must supply distinct identifiers.
+        /// Add a note annotation to a span. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Callers may supply a non-empty `identifier` to upsert on (span_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="data"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
diff --git a/src/libs/Phoenix/Generated/Phoenix.ITracesClient.CreateTraceNote.g.cs b/src/libs/Phoenix/Generated/Phoenix.ITracesClient.CreateTraceNote.g.cs
index c0dd728..db4b32d 100644
--- a/src/libs/Phoenix/Generated/Phoenix.ITracesClient.CreateTraceNote.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.ITracesClient.CreateTraceNote.g.cs
@@ -6,7 +6,7 @@ public partial interface ITracesClient
     {
         /// <summary>
         /// Create a trace note<br/>
-        /// Add a note annotation to a trace. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same trace. Structured annotations, by contrast, are keyed by (name, trace_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a trace you must supply distinct identifiers.
+        /// Add a note annotation to a trace. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same trace. Callers may supply a non-empty `identifier` to upsert on (trace_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -19,7 +19,7 @@ public partial interface ITracesClient
             global::System.Threading.CancellationToken cancellationToken = default);
         /// <summary>
         /// Create a trace note<br/>
-        /// Add a note annotation to a trace. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same trace. Structured annotations, by contrast, are keyed by (name, trace_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a trace you must supply distinct identifiers.
+        /// Add a note annotation to a trace. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same trace. Callers may supply a non-empty `identifier` to upsert on (trace_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -32,7 +32,7 @@ public partial interface ITracesClient
             global::System.Threading.CancellationToken cancellationToken = default);
         /// <summary>
         /// Create a trace note<br/>
-        /// Add a note annotation to a trace. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same trace. Structured annotations, by contrast, are keyed by (name, trace_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a trace you must supply distinct identifiers.
+        /// Add a note annotation to a trace. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same trace. Callers may supply a non-empty `identifier` to upsert on (trace_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="data"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
diff --git a/src/libs/Phoenix/Generated/Phoenix.Models.ListSessionAnnotationsBySessionIdsIncludeAnnotationNames.g.cs b/src/libs/Phoenix/Generated/Phoenix.Models.ListSessionAnnotationsBySessionIdsIncludeAnnotationNames.g.cs
index c9c6b09..7721067 100644
--- a/src/libs/Phoenix/Generated/Phoenix.Models.ListSessionAnnotationsBySessionIdsIncludeAnnotationNames.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.Models.ListSessionAnnotationsBySessionIdsIncludeAnnotationNames.g.cs
@@ -4,7 +4,7 @@
 namespace Phoenix
 {
     /// <summary>
-    /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+    /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
     /// </summary>
     public sealed partial class ListSessionAnnotationsBySessionIdsIncludeAnnotationNames
     {
diff --git a/src/libs/Phoenix/Generated/Phoenix.Models.ListSpanAnnotationsBySpanIdsIncludeAnnotationNames.g.cs b/src/libs/Phoenix/Generated/Phoenix.Models.ListSpanAnnotationsBySpanIdsIncludeAnnotationNames.g.cs
index 8d6889b..1cadbc7 100644
--- a/src/libs/Phoenix/Generated/Phoenix.Models.ListSpanAnnotationsBySpanIdsIncludeAnnotationNames.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.Models.ListSpanAnnotationsBySpanIdsIncludeAnnotationNames.g.cs
@@ -4,7 +4,7 @@
 namespace Phoenix
 {
     /// <summary>
-    /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+    /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
     /// </summary>
     public sealed partial class ListSpanAnnotationsBySpanIdsIncludeAnnotationNames
     {
diff --git a/src/libs/Phoenix/Generated/Phoenix.Models.ListTraceAnnotationsByTraceIdsIncludeAnnotationNames.g.cs b/src/libs/Phoenix/Generated/Phoenix.Models.ListTraceAnnotationsByTraceIdsIncludeAnnotationNames.g.cs
index a740ebb..6021d84 100644
--- a/src/libs/Phoenix/Generated/Phoenix.Models.ListTraceAnnotationsByTraceIdsIncludeAnnotationNames.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.Models.ListTraceAnnotationsByTraceIdsIncludeAnnotationNames.g.cs
@@ -4,7 +4,7 @@
 namespace Phoenix
 {
     /// <summary>
-    /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+    /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
     /// </summary>
     public sealed partial class ListTraceAnnotationsByTraceIdsIncludeAnnotationNames
     {
diff --git a/src/libs/Phoenix/Generated/Phoenix.Models.SessionNoteData.g.cs b/src/libs/Phoenix/Generated/Phoenix.Models.SessionNoteData.g.cs
index fee5179..9132e68 100644
--- a/src/libs/Phoenix/Generated/Phoenix.Models.SessionNoteData.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.Models.SessionNoteData.g.cs
@@ -22,6 +22,12 @@ public sealed partial class SessionNoteData
         [global::System.Text.Json.Serialization.JsonRequired]
         public required string Note { get; set; }
 
+        /// <summary>
+        /// Optional caller-supplied identifier. When non-empty, the note is upserted on (session_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note. When omitted or empty, the server stamps a unique 'px-session-note:&lt;uuid&gt;' identifier so each call appends a new note.
+        /// </summary>
+        [global::System.Text.Json.Serialization.JsonPropertyName("identifier")]
+        public string? Identifier { get; set; }
+
         /// <summary>
         /// Additional properties that are not explicitly defined in the schema
         /// </summary>
@@ -37,15 +43,20 @@ public sealed partial class SessionNoteData
         /// <param name="note">
         /// The note text to add to the session
         /// </param>
+        /// <param name="identifier">
+        /// Optional caller-supplied identifier. When non-empty, the note is upserted on (session_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note. When omitted or empty, the server stamps a unique 'px-session-note:&lt;uuid&gt;' identifier so each call appends a new note.
+        /// </param>
 #if NET7_0_OR_GREATER
         [global::System.Diagnostics.CodeAnalysis.SetsRequiredMembers]
 #endif
         public SessionNoteData(
             string sessionId,
-            string note)
+            string note,
+            string? identifier)
         {
             this.SessionId = sessionId ?? throw new global::System.ArgumentNullException(nameof(sessionId));
             this.Note = note ?? throw new global::System.ArgumentNullException(nameof(note));
+            this.Identifier = identifier;
         }
 
         /// <summary>
diff --git a/src/libs/Phoenix/Generated/Phoenix.Models.SpanNoteData.g.cs b/src/libs/Phoenix/Generated/Phoenix.Models.SpanNoteData.g.cs
index e64b0db..cfa8ecc 100644
--- a/src/libs/Phoenix/Generated/Phoenix.Models.SpanNoteData.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.Models.SpanNoteData.g.cs
@@ -22,6 +22,12 @@ public sealed partial class SpanNoteData
         [global::System.Text.Json.Serialization.JsonRequired]
         public required string Note { get; set; }
 
+        /// <summary>
+        /// Optional caller-supplied identifier. When non-empty, the note is upserted on (span_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note. When omitted or empty, the server stamps a unique 'px-span-note:&lt;uuid&gt;' identifier so each call appends a new note.
+        /// </summary>
+        [global::System.Text.Json.Serialization.JsonPropertyName("identifier")]
+        public string? Identifier { get; set; }
+
         /// <summary>
         /// Additional properties that are not explicitly defined in the schema
         /// </summary>
@@ -37,15 +43,20 @@ public sealed partial class SpanNoteData
         /// <param name="note">
         /// The note text to add to the span
         /// </param>
+        /// <param name="identifier">
+        /// Optional caller-supplied identifier. When non-empty, the note is upserted on (span_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note. When omitted or empty, the server stamps a unique 'px-span-note:&lt;uuid&gt;' identifier so each call appends a new note.
+        /// </param>
 #if NET7_0_OR_GREATER
         [global::System.Diagnostics.CodeAnalysis.SetsRequiredMembers]
 #endif
         public SpanNoteData(
             string spanId,
-            string note)
+            string note,
+            string? identifier)
         {
             this.SpanId = spanId ?? throw new global::System.ArgumentNullException(nameof(spanId));
             this.Note = note ?? throw new global::System.ArgumentNullException(nameof(note));
+            this.Identifier = identifier;
         }
 
         /// <summary>
diff --git a/src/libs/Phoenix/Generated/Phoenix.Models.TraceNoteData.g.cs b/src/libs/Phoenix/Generated/Phoenix.Models.TraceNoteData.g.cs
index 47d362e..6bf382b 100644
--- a/src/libs/Phoenix/Generated/Phoenix.Models.TraceNoteData.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.Models.TraceNoteData.g.cs
@@ -22,6 +22,12 @@ public sealed partial class TraceNoteData
         [global::System.Text.Json.Serialization.JsonRequired]
         public required string Note { get; set; }
 
+        /// <summary>
+        /// Optional caller-supplied identifier. When non-empty, the note is upserted on (trace_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note. When omitted or empty, the server stamps a unique 'px-trace-note:&lt;uuid&gt;' identifier so each call appends a new note.
+        /// </summary>
+        [global::System.Text.Json.Serialization.JsonPropertyName("identifier")]
+        public string? Identifier { get; set; }
+
         /// <summary>
         /// Additional properties that are not explicitly defined in the schema
         /// </summary>
@@ -37,15 +43,20 @@ public sealed partial class TraceNoteData
         /// <param name="note">
         /// The note text to add to the trace
         /// </param>
+        /// <param name="identifier">
+        /// Optional caller-supplied identifier. When non-empty, the note is upserted on (trace_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note. When omitted or empty, the server stamps a unique 'px-trace-note:&lt;uuid&gt;' identifier so each call appends a new note.
+        /// </param>
 #if NET7_0_OR_GREATER
         [global::System.Diagnostics.CodeAnalysis.SetsRequiredMembers]
 #endif
         public TraceNoteData(
             string traceId,
-            string note)
+            string note,
+            string? identifier)
         {
             this.TraceId = traceId ?? throw new global::System.ArgumentNullException(nameof(traceId));
             this.Note = note ?? throw new global::System.ArgumentNullException(nameof(note));
+            this.Identifier = identifier;
         }
 
         /// <summary>
diff --git a/src/libs/Phoenix/Generated/Phoenix.SessionsClient.CreateSessionNote.g.cs b/src/libs/Phoenix/Generated/Phoenix.SessionsClient.CreateSessionNote.g.cs
index ac8756a..16af46e 100644
--- a/src/libs/Phoenix/Generated/Phoenix.SessionsClient.CreateSessionNote.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.SessionsClient.CreateSessionNote.g.cs
@@ -43,7 +43,7 @@ partial void ProcessCreateSessionNoteResponseContent(
 
         /// <summary>
         /// Create a session note<br/>
-        /// Add a note annotation to a session. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Structured annotations, by contrast, are keyed by (name, session_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a session you must supply distinct identifiers.
+        /// Add a note annotation to a session. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Callers may supply a non-empty `identifier` to upsert on (session_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -66,7 +66,7 @@ partial void ProcessCreateSessionNoteResponseContent(
         }
         /// <summary>
         /// Create a session note<br/>
-        /// Add a note annotation to a session. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Structured annotations, by contrast, are keyed by (name, session_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a session you must supply distinct identifiers.
+        /// Add a note annotation to a session. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Callers may supply a non-empty `identifier` to upsert on (session_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -553,7 +553,7 @@ partial void ProcessCreateSessionNoteResponseContent(
         }
         /// <summary>
         /// Create a session note<br/>
-        /// Add a note annotation to a session. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Structured annotations, by contrast, are keyed by (name, session_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a session you must supply distinct identifiers.
+        /// Add a note annotation to a session. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Callers may supply a non-empty `identifier` to upsert on (session_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="data"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
diff --git a/src/libs/Phoenix/Generated/Phoenix.SpansClient.CreateSpanNote.g.cs b/src/libs/Phoenix/Generated/Phoenix.SpansClient.CreateSpanNote.g.cs
index 2f28db8..704ce80 100644
--- a/src/libs/Phoenix/Generated/Phoenix.SpansClient.CreateSpanNote.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.SpansClient.CreateSpanNote.g.cs
@@ -43,7 +43,7 @@ partial void ProcessCreateSpanNoteResponseContent(
 
         /// <summary>
         /// Create a span note<br/>
-        /// Add a note annotation to a span. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Structured annotations, by contrast, are keyed by (name, span_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a span you must supply distinct identifiers.
+        /// Add a note annotation to a span. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Callers may supply a non-empty `identifier` to upsert on (span_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -66,7 +66,7 @@ partial void ProcessCreateSpanNoteResponseContent(
         }
         /// <summary>
         /// Create a span note<br/>
-        /// Add a note annotation to a span. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Structured annotations, by contrast, are keyed by (name, span_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a span you must supply distinct identifiers.
+        /// Add a note annotation to a span. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Callers may supply a non-empty `identifier` to upsert on (span_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -553,7 +553,7 @@ partial void ProcessCreateSpanNoteResponseContent(
         }
         /// <summary>
         /// Create a span note<br/>
-        /// Add a note annotation to a span. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Structured annotations, by contrast, are keyed by (name, span_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a span you must supply distinct identifiers.
+        /// Add a note annotation to a span. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Callers may supply a non-empty `identifier` to upsert on (span_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="data"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
diff --git a/src/libs/Phoenix/Generated/Phoenix.TracesClient.CreateTraceNote.g.cs b/src/libs/Phoenix/Generated/Phoenix.TracesClient.CreateTraceNote.g.cs
index 1ba7775..f5ab789 100644
--- a/src/libs/Phoenix/Generated/Phoenix.TracesClient.CreateTraceNote.g.cs
+++ b/src/libs/Phoenix/Generated/Phoenix.TracesClient.CreateTraceNote.g.cs
@@ -43,7 +43,7 @@ partial void ProcessCreateTraceNoteResponseContent(
 
         /// <summary>
         /// Create a trace note<br/>
-        /// Add a note annotation to a trace. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same trace. Structured annotations, by contrast, are keyed by (name, trace_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a trace you must supply distinct identifiers.
+        /// Add a note annotation to a trace. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same trace. Callers may supply a non-empty `identifier` to upsert on (trace_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -66,7 +66,7 @@ partial void ProcessCreateTraceNoteResponseContent(
         }
         /// <summary>
         /// Create a trace note<br/>
-        /// Add a note annotation to a trace. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same trace. Structured annotations, by contrast, are keyed by (name, trace_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a trace you must supply distinct identifiers.
+        /// Add a note annotation to a trace. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same trace. Callers may supply a non-empty `identifier` to upsert on (trace_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -553,7 +553,7 @@ partial void ProcessCreateTraceNoteResponseContent(
         }
         /// <summary>
         /// Create a trace note<br/>
-        /// Add a note annotation to a trace. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same trace. Structured annotations, by contrast, are keyed by (name, trace_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a trace you must supply distinct identifiers.
+        /// Add a note annotation to a trace. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same trace. Callers may supply a non-empty `identifier` to upsert on (trace_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="data"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
diff --git a/src/libs/Phoenix/openapi.json b/src/libs/Phoenix/openapi.json
index 9c07e9f..e67f387 100644
--- a/src/libs/Phoenix/openapi.json
+++ b/src/libs/Phoenix/openapi.json
@@ -379,10 +379,10 @@
                   "type": "null"
                 }
               ],
-              "description": "Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.",
+              "description": "Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).",
               "title": "Include Annotation Names"
             },
-            "description": "Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list."
+            "description": "Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default)."
           },
           {
             "name": "exclude_annotation_names",
@@ -728,10 +728,10 @@
                   "type": "null"
                 }
               ],
-              "description": "Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.",
+              "description": "Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).",
               "title": "Include Annotation Names"
             },
-            "description": "Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list."
+            "description": "Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default)."
           },
           {
             "name": "exclude_annotation_names",
@@ -1077,10 +1077,10 @@
                   "type": "null"
                 }
               ],
-              "description": "Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.",
+              "description": "Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).",
               "title": "Include Annotation Names"
             },
-            "description": "Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list."
+            "description": "Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default)."
           },
           {
             "name": "exclude_annotation_names",
@@ -3416,7 +3416,7 @@
           "traces"
         ],
         "summary": "Create a trace note",
-        "description": "Add a note annotation to a trace. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same trace. Structured annotations, by contrast, are keyed by (name, trace_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a trace you must supply distinct identifiers.",
+        "description": "Add a note annotation to a trace. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same trace. Callers may supply a non-empty `identifier` to upsert on (trace_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.",
         "operationId": "createTraceNote",
         "requestBody": {
           "content": {
@@ -4189,7 +4189,7 @@
           "spans"
         ],
         "summary": "Create a span note",
-        "description": "Add a note annotation to a span. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Structured annotations, by contrast, are keyed by (name, span_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a span you must supply distinct identifiers.",
+        "description": "Add a note annotation to a span. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Callers may supply a non-empty `identifier` to upsert on (span_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.",
         "operationId": "createSpanNote",
         "requestBody": {
           "content": {
@@ -5719,7 +5719,7 @@
           "sessions"
         ],
         "summary": "Create a session note",
-        "description": "Add a note annotation to a session. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Structured annotations, by contrast, are keyed by (name, session_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a session you must supply distinct identifiers.",
+        "description": "Add a note annotation to a session. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Callers may supply a non-empty `identifier` to upsert on (session_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.",
         "operationId": "createSessionNote",
         "requestBody": {
           "content": {
@@ -13207,6 +13207,12 @@
             "minLength": 1,
             "title": "Note",
             "description": "The note text to add to the session"
+          },
+          "identifier": {
+            "type": "string",
+            "title": "Identifier",
+            "description": "Optional caller-supplied identifier. When non-empty, the note is upserted on (session_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note. When omitted or empty, the server stamps a unique 'px-session-note:<uuid>' identifier so each call appends a new note.",
+            "default": ""
           }
         },
         "type": "object",
@@ -13788,6 +13794,12 @@
             "minLength": 1,
             "title": "Note",
             "description": "The note text to add to the span"
+          },
+          "identifier": {
+            "type": "string",
+            "title": "Identifier",
+            "description": "Optional caller-supplied identifier. When non-empty, the note is upserted on (span_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note. When omitted or empty, the server stamps a unique 'px-span-note:<uuid>' identifier so each call appends a new note.",
+            "default": ""
           }
         },
         "type": "object",
@@ -14923,6 +14935,12 @@
             "minLength": 1,
             "title": "Note",
             "description": "The note text to add to the trace"
+          },
+          "identifier": {
+            "type": "string",
+            "title": "Identifier",
+            "description": "Optional caller-supplied identifier. When non-empty, the note is upserted on (trace_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note. When omitted or empty, the server stamps a unique 'px-trace-note:<uuid>' identifier so each call appends a new note.",
+            "default": ""
           }
         },
         "type": "object",