diff --git a/CLAUDE.md b/CLAUDE.md
index a9ad96a..0f1fb80 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -118,6 +118,8 @@ All crates use `version = "0.0.0"` in their Cargo.toml — this is intentional.
 
 Never manually set version numbers in Cargo.toml files. To release, create a GitHub Release with a semver tag like `v0.1.0` (via the GitHub UI or `gh release create v0.1.0 --generate-notes`).
 
+**Always check the current version before reasoning about version bumps.** The `0.0.0` placeholder in Cargo.toml is a dev sentinel, not the real version. Run `gh release list --limit 5` to see the actual most recent release, then decide the next tag. Don't assume "pre-1.0" or guess from stale context — the project has shipped past 1.0 and is subject to normal semver rules (breaking changes → major bump, new features → minor, fixes → patch). If a PR introduces a breaking change, call out in the PR description which major version the next release should be (current_major + 1).
+
 ## Issue tracking
 
 Issue tracking for lineark development happens in GitHub Issues, not in Linear. Use `gh issue` commands to view, create, and manage issues.
diff --git a/crates/lineark-codegen/src/dep_graph.rs b/crates/lineark-codegen/src/dep_graph.rs
new file mode 100644
index 0000000..4edc217
--- /dev/null
+++ b/crates/lineark-codegen/src/dep_graph.rs
@@ -0,0 +1,115 @@
+//! Schema dependency-graph utilities.
+//!
+//! Used by codegen to decide where `Box<T>` is actually required on
+//! Object / InputObject fields. The high-level rule:
+//!
+//! For a field `Container.f: Target` (a direct, non-list reference to another
+//! Object/InputObject), `Box<Target>` is needed iff `Target` can transitively
+//! reach `Container` in the schema's reference graph — that's exactly the
+//! shape that would otherwise produce an infinite-size Rust struct.
+//!
+//! Edges through lists are *excluded* from the graph: `Vec<T>` is already a
+//! heap pointer with a fixed stack size, so it breaks any size cycle.
+
+use std::collections::{HashMap, HashSet};
+
+/// For each node in `edges`, compute the set of nodes reachable from it
+/// (transitively, including the node itself if there's a cycle back to it).
+pub fn reachability(edges: &HashMap<String, Vec<String>>) -> HashMap<String, HashSet<String>> {
+    let mut result = HashMap::with_capacity(edges.len());
+    for start in edges.keys() {
+        result.insert(start.clone(), reachable_from(start, edges));
+    }
+    result
+}
+
+fn reachable_from(start: &str, edges: &HashMap<String, Vec<String>>) -> HashSet<String> {
+    let mut visited: HashSet<String> = HashSet::new();
+    let mut stack: Vec<String> = match edges.get(start) {
+        Some(succs) => succs.clone(),
+        None => Vec::new(),
+    };
+    while let Some(node) = stack.pop() {
+        if !visited.insert(node.clone()) {
+            continue;
+        }
+        if let Some(succs) = edges.get(&node) {
+            for s in succs {
+                if !visited.contains(s) {
+                    stack.push(s.clone());
+                }
+            }
+        }
+    }
+    visited
+}
+
+/// Returns true iff `target` can reach `container` in the graph — i.e.,
+/// embedding `target` directly inside `container` would form a size cycle.
+pub fn reaches(target: &str, container: &str, reach: &HashMap<String, HashSet<String>>) -> bool {
+    reach.get(target).is_some_and(|r| r.contains(container))
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    fn graph(pairs: &[(&str, &[&str])]) -> HashMap<String, Vec<String>> {
+        pairs
+            .iter()
+            .map(|(k, vs)| (k.to_string(), vs.iter().map(|s| s.to_string()).collect()))
+            .collect()
+    }
+
+    #[test]
+    fn empty_graph_has_no_reach() {
+        let g = graph(&[]);
+        assert!(reachability(&g).is_empty());
+    }
+
+    #[test]
+    fn linear_chain_reach_forward_only() {
+        let g = graph(&[("A", &["B"]), ("B", &["C"]), ("C", &[])]);
+        let r = reachability(&g);
+        assert!(reaches("A", "B", &r));
+        assert!(reaches("A", "C", &r));
+        assert!(reaches("B", "C", &r));
+        assert!(!reaches("B", "A", &r));
+        assert!(!reaches("C", "A", &r));
+        // No cycles → no node reaches itself.
+        assert!(!reaches("A", "A", &r));
+    }
+
+    #[test]
+    fn self_loop_reaches_itself() {
+        let g = graph(&[("A", &["A"])]);
+        let r = reachability(&g);
+        assert!(reaches("A", "A", &r));
+    }
+
+    #[test]
+    fn mutual_recursion_both_reach_each_other() {
+        let g = graph(&[("A", &["B"]), ("B", &["A"])]);
+        let r = reachability(&g);
+        assert!(reaches("A", "B", &r));
+        assert!(reaches("B", "A", &r));
+        assert!(reaches("A", "A", &r));
+        assert!(reaches("B", "B", &r));
+    }
+
+    #[test]
+    fn cycle_not_involving_node_does_not_reach_it() {
+        // A → B → C → B (B,C in cycle; A is upstream and not part of it)
+        let g = graph(&[("A", &["B"]), ("B", &["C"]), ("C", &["B"])]);
+        let r = reachability(&g);
+        assert!(reaches("A", "B", &r));
+        assert!(reaches("A", "C", &r));
+        // B and C reach each other and themselves, but not A.
+        assert!(reaches("B", "C", &r));
+        assert!(reaches("C", "B", &r));
+        assert!(reaches("B", "B", &r));
+        assert!(reaches("C", "C", &r));
+        assert!(!reaches("B", "A", &r));
+        assert!(!reaches("C", "A", &r));
+    }
+}
diff --git a/crates/lineark-codegen/src/emit_inputs.rs b/crates/lineark-codegen/src/emit_inputs.rs
index 7b4cdbc..103ed6c 100644
--- a/crates/lineark-codegen/src/emit_inputs.rs
+++ b/crates/lineark-codegen/src/emit_inputs.rs
@@ -1,15 +1,19 @@
+use crate::dep_graph::{self, reaches};
 use crate::emit_scalars::graphql_type_to_rust;
-use crate::parser::{self, GqlType, InputDef, TypeKind};
+use crate::parser::{self, FieldDef, GqlType, InputDef, TypeKind};
 use heck::ToSnakeCase;
 use proc_macro2::TokenStream;
 use quote::quote;
-use std::collections::HashMap;
+use std::collections::{HashMap, HashSet};
 
 pub fn emit(inputs: &[InputDef], type_kind_map: &HashMap<String, TypeKind>) -> TokenStream {
+    let defaultable = compute_defaultable_inputs(inputs, type_kind_map);
+    let reach = compute_input_reachability(inputs, type_kind_map);
+
     let structs: Vec<TokenStream> = inputs
         .iter()
         .filter(|i| !i.name.is_empty())
-        .map(|i| emit_input_struct(i, type_kind_map))
+        .map(|i| emit_input_struct(i, type_kind_map, &defaultable, &reach))
         .collect();
 
     quote! {
@@ -19,12 +23,114 @@ pub fn emit(inputs: &[InputDef], type_kind_map: &HashMap<String, TypeKind>) -> T
 
         use serde::{Deserialize, Serialize};
         use super::enums::*;
+        use crate::field_update::MaybeUndefined;
 
         #(#structs)*
     }
 }
 
-fn emit_input_struct(input: &InputDef, type_kind_map: &HashMap<String, TypeKind>) -> TokenStream {
+/// Build the InputObject dependency graph (edges through direct, non-list
+/// references only) and compute transitive reachability. Used to decide
+/// per-field whether `Box<T>` is needed for size correctness.
+fn compute_input_reachability(
+    inputs: &[InputDef],
+    type_kind_map: &HashMap<String, TypeKind>,
+) -> HashMap<String, HashSet<String>> {
+    let mut edges: HashMap<String, Vec<String>> = HashMap::with_capacity(inputs.len());
+    for input in inputs {
+        if input.name.is_empty() {
+            continue;
+        }
+        // Dedupe: multiple fields can target the same InputObject, and duplicate
+        // edges would just expand the DFS stack without changing reachability.
+        let mut deps: HashSet<String> = HashSet::new();
+        for field in &input.fields {
+            if let Some(target) = direct_input_target(&field.ty, type_kind_map) {
+                deps.insert(target.to_string());
+            }
+        }
+        edges.insert(input.name.clone(), deps.into_iter().collect());
+    }
+    dep_graph::reachability(&edges)
+}
+
+/// If `ty` is a direct (non-list) reference to an InputObject, return that
+/// type's name. Lists return `None` because `Vec<T>` is sized and breaks
+/// size cycles regardless of `T`.
+fn direct_input_target<'a>(
+    ty: &'a GqlType,
+    type_kind_map: &HashMap<String, TypeKind>,
+) -> Option<&'a str> {
+    match ty {
+        GqlType::NonNull(inner) => direct_input_target(inner, type_kind_map),
+        GqlType::Named(name) => {
+            if matches!(
+                type_kind_map.get(name.as_str()),
+                Some(TypeKind::InputObject)
+            ) {
+                Some(name.as_str())
+            } else {
+                None
+            }
+        }
+        GqlType::List(_) => None,
+    }
+}
+
+/// Compute which input structs can still derive `Default`.
+///
+/// Required (non-null) fields now emit as plain `T` instead of `Option<T>`, so
+/// the struct only derives `Default` if every required field's Rust type also
+/// has `Default`. Generated enums don't derive `Default`, and mutually recursive
+/// input objects need a fixed-point pass to converge.
+fn compute_defaultable_inputs(
+    inputs: &[InputDef],
+    type_kind_map: &HashMap<String, TypeKind>,
+) -> HashSet<String> {
+    let mut defaultable: HashSet<String> = inputs.iter().map(|i| i.name.clone()).collect();
+    loop {
+        let snapshot = defaultable.clone();
+        defaultable.retain(|name| {
+            let Some(input) = inputs.iter().find(|i| i.name == *name) else {
+                return true;
+            };
+            input.fields.iter().all(|f| {
+                // Nullable fields always have Default (MaybeUndefined::Undefined).
+                if !matches!(f.ty, GqlType::NonNull(_)) {
+                    return true;
+                }
+                type_has_default(&f.ty, type_kind_map, &snapshot)
+            })
+        });
+        if defaultable.len() == snapshot.len() {
+            break;
+        }
+    }
+    defaultable
+}
+
+fn type_has_default(
+    ty: &GqlType,
+    type_kind_map: &HashMap<String, TypeKind>,
+    defaultable_inputs: &HashSet<String>,
+) -> bool {
+    match ty {
+        GqlType::NonNull(inner) => type_has_default(inner, type_kind_map, defaultable_inputs),
+        GqlType::List(_) => true,
+        GqlType::Named(name) => match type_kind_map.get(name.as_str()) {
+            Some(TypeKind::Enum) => false,
+            Some(TypeKind::InputObject) => defaultable_inputs.contains(name),
+            _ => true,
+        },
+    }
+}
+
+fn emit_input_struct(
+    input: &InputDef,
+    type_kind_map: &HashMap<String, TypeKind>,
+    defaultable: &HashSet<String>,
+    reach: &HashMap<String, HashSet<String>>,
+) -> TokenStream {
     let name = quote::format_ident!("{}", input.name);
     let doc = parser::doc_comment_tokens(&input.description);
 
@@ -39,50 +145,27 @@ fn emit_input_struct(input: &InputDef, type_kind_map: &HashMap<String, TypeKind>
             let base = f.ty.base_name();
             matches!(
                 type_kind_map.get(base),
-                Some(TypeKind::Scalar) | Some(TypeKind::Enum) | Some(TypeKind::InputObject)
-                    | Some(TypeKind::Union) | Some(TypeKind::Interface) | Some(TypeKind::Object)
+                Some(TypeKind::Scalar)
+                    | Some(TypeKind::Enum)
+                    | Some(TypeKind::InputObject)
+                    | Some(TypeKind::Union)
+                    | Some(TypeKind::Interface)
+                    | Some(TypeKind::Object)
                     | None
             )
         })
-        .map(|f| {
-            let field_name_str = f.name.to_snake_case();
-            let original_name = &f.name;
-            let safe_name = parser::safe_ident(&field_name_str);
-            let field_ident = if safe_name.starts_with("r#") {
-                let raw: TokenStream = safe_name.parse().unwrap();
-                raw
-            } else {
-                let ident = quote::format_ident!("{}", safe_name);
-                quote! { #ident }
-            };
-            let rust_type = resolve_input_type(&f.ty, type_kind_map);
-            let fdoc = parser::doc_comment_tokens(&f.description);
-            // If the snake_case name differs from the original camelCase, add serde rename.
-            // We use rename_all on the struct level, so individual renames are only needed
-            // if to_snake_case -> to_camelCase roundtrip doesn't match.
-            let needs_rename = {
-                let roundtrip = heck::AsLowerCamelCase(&field_name_str).to_string();
-                roundtrip != *original_name
-            };
-            if needs_rename {
-                quote! {
-                    #fdoc
-                    #[serde(rename = #original_name, default, skip_serializing_if = "Option::is_none")]
-                    pub #field_ident: #rust_type,
-                }
-            } else {
-                quote! {
-                    #fdoc
-                    #[serde(default, skip_serializing_if = "Option::is_none")]
-                    pub #field_ident: #rust_type,
-                }
-            }
-        })
+        .map(|f| emit_field(f, type_kind_map, &input.name, reach))
         .collect();
 
+    let derives = if defaultable.contains(&input.name) {
+        quote! { #[derive(Debug, Clone, Default, Serialize, Deserialize)] }
+    } else {
+        quote! { #[derive(Debug, Clone, Serialize, Deserialize)] }
+    };
+
     quote! {
         #doc
-        #[derive(Debug, Clone, Default, Serialize, Deserialize)]
+        #derives
         #[serde(rename_all = "camelCase")]
         pub struct #name {
             #(#fields)*
@@ -90,34 +173,418 @@ fn emit_input_struct(input: &InputDef, type_kind_map: &HashMap<String, TypeKind>
     }
 }
 
-/// All input fields are `Option<T>` for easy Default derivation and the `..Default::default()` pattern.
-fn resolve_input_type(ty: &GqlType, type_kind_map: &HashMap<String, TypeKind>) -> TokenStream {
-    let inner = resolve_inner(ty, type_kind_map);
-    quote! { Option<#inner> }
+fn emit_field(
+    f: &FieldDef,
+    type_kind_map: &HashMap<String, TypeKind>,
+    container: &str,
+    reach: &HashMap<String, HashSet<String>>,
+) -> TokenStream {
+    let field_name_str = f.name.to_snake_case();
+    let original_name = &f.name;
+    let safe_name = parser::safe_ident(&field_name_str);
+    let field_ident = if safe_name.starts_with("r#") {
+        let raw: TokenStream = safe_name.parse().unwrap();
+        raw
+    } else {
+        let ident = quote::format_ident!("{}", safe_name);
+        quote! { #ident }
+    };
+
+    let is_required = matches!(f.ty, GqlType::NonNull(_));
+    let rust_type = resolve_input_type(&f.ty, type_kind_map, container, reach);
+    let fdoc = parser::doc_comment_tokens(&f.description);
+    // If the snake_case name differs from the original camelCase, add serde rename.
+    // We use rename_all on the struct level, so individual renames are only needed
+    // if to_snake_case -> to_camelCase roundtrip doesn't match.
+    let needs_rename = {
+        let roundtrip = heck::AsLowerCamelCase(&field_name_str).to_string();
+        roundtrip != *original_name
+    };
+
+    // Required fields are always serialized; nullable fields use MaybeUndefined's
+    // skip predicate so `Undefined` omits the field from the JSON payload.
+    let serde_attr = match (needs_rename, is_required) {
+        (true, true) => quote! { #[serde(rename = #original_name)] },
+        (false, true) => quote! {},
+        (true, false) => quote! {
+            #[serde(rename = #original_name, default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+        },
+        (false, false) => quote! {
+            #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+        },
+    };
+
+    quote! {
+        #fdoc
+        #serde_attr
+        pub #field_ident: #rust_type,
+    }
+}
+
+/// Resolve a GraphQL input field type into its emitted Rust tokens.
+///
+/// Walks the type tree and applies nullability uniformly:
+///
+/// - At the **outermost** position, nullable wraps in `MaybeUndefined<T>` so
+///   the consumer can distinguish "omit this field" from "send explicit null".
+/// - **Inside a list**, nullable wraps in `Option<T>` — GraphQL list slots are
+///   always materialized (no "omit this slot" wire form), so the three-state
+///   distinction is meaningless one level in.
+/// - Required positions emit plain `T` at any depth.
+///
+/// `Box<T>` is added to a direct InputObject reference only when the field
+/// would otherwise create an infinite-size struct: at depth 0 (where the
+/// containing wrapper is `MaybeUndefined<_>` or plain `T`, both of which need
+/// `T` to be sized) and the target can transitively reach `container` in the
+/// schema's reference graph. Non-cyclic references and references inside lists
+/// (where `Vec<T>` already breaks the size cycle) drop the `Box` entirely.
+///
+/// This handles every shape the GraphQL spec allows (`T`, `T!`, `[T!]!`,
+/// `[T!]`, `[T]!`, `[T]`, and arbitrarily nested lists like `[[T!]!]!`)
+/// without special-casing the schema.
+fn resolve_input_type(
+    ty: &GqlType,
+    type_kind_map: &HashMap<String, TypeKind>,
+    container: &str,
+    reach: &HashMap<String, HashSet<String>>,
+) -> TokenStream {
+    resolve(ty, type_kind_map, /* depth = */ 0, container, reach)
 }
 
-fn resolve_inner(ty: &GqlType, type_kind_map: &HashMap<String, TypeKind>) -> TokenStream {
+fn resolve(
+    ty: &GqlType,
+    type_kind_map: &HashMap<String, TypeKind>,
+    depth: usize,
+    container: &str,
+    reach: &HashMap<String, HashSet<String>>,
+) -> TokenStream {
+    match ty {
+        GqlType::NonNull(inner) => resolve_required(inner, type_kind_map, depth, container, reach),
+        other => {
+            let inner = resolve_required(other, type_kind_map, depth, container, reach);
+            if depth == 0 {
+                quote! { MaybeUndefined<#inner> }
+            } else {
+                quote! { Option<#inner> }
+            }
+        }
+    }
+}
+
+fn resolve_required(
+    ty: &GqlType,
+    type_kind_map: &HashMap<String, TypeKind>,
+    depth: usize,
+    container: &str,
+    reach: &HashMap<String, HashSet<String>>,
+) -> TokenStream {
     match ty {
         GqlType::Named(name) => {
             let kind = type_kind_map.get(name.as_str());
             if matches!(kind, Some(TypeKind::InputObject)) {
                 let ident = quote::format_ident!("{}", name);
-                // Self-reference: input types reference other input types in the same module.
-                quote! { Box<#ident> }
+                // Box only when depth == 0 (above us is `MaybeUndefined<_>` or
+                // plain `T`, both needing sized T) AND the target can reach the
+                // containing struct (true size cycle). Inside a list, Vec breaks
+                // the cycle on its own and Box is unnecessary.
+                let needs_box = depth == 0 && reaches(name, container, reach);
+                if needs_box {
+                    quote! { Box<#ident> }
+                } else {
+                    quote! { #ident }
+                }
             } else if matches!(
                 kind,
                 Some(TypeKind::Union) | Some(TypeKind::Interface) | Some(TypeKind::Object)
             ) {
-                // Union/interface/object types in inputs are serialized as raw JSON.
                 quote! { serde_json::Value }
             } else {
                 graphql_type_to_rust(name)
             }
         }
-        GqlType::NonNull(inner) => resolve_inner(inner, type_kind_map),
+        GqlType::NonNull(inner) => resolve_required(inner, type_kind_map, depth, container, reach),
         GqlType::List(inner) => {
-            let elem = resolve_inner(inner, type_kind_map);
+            let elem = resolve(inner, type_kind_map, depth + 1, container, reach);
             quote! { Vec<#elem> }
         }
     }
 }
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    fn type_kind_map() -> HashMap<String, TypeKind> {
+        let mut m = HashMap::new();
+        m.insert("String".to_string(), TypeKind::Scalar);
+        m
+    }
+
+    /// Render a single field's resolved Rust type with whitespace collapsed,
+    /// so test assertions can compare against a clean expected string without
+    /// matching the exact spacing `quote!` produces. Uses an empty reach map
+    /// so cycles are impossible — `Box` never applies, isolating list/nullability
+    /// rules from Box rules.
+    fn rendered(ty: GqlType) -> String {
+        let reach: HashMap<String, HashSet<String>> = HashMap::new();
+        resolve_input_type(&ty, &type_kind_map(), "Container", &reach)
+            .to_string()
+            .split_whitespace()
+            .collect::<String>()
+    }
+
+    fn named() -> GqlType {
+        GqlType::Named("String".to_string())
+    }
+    fn nn(t: GqlType) -> GqlType {
+        GqlType::NonNull(Box::new(t))
+    }
+    fn list(t: GqlType) -> GqlType {
+        GqlType::List(Box::new(t))
+    }
+
+    /// Each row covers one shape the GraphQL spec allows. The full table is
+    /// in one test so any drift is visible at a glance.
+    #[test]
+    fn input_field_shapes() {
+        // Scalars
+        assert_eq!(rendered(nn(named())), "String", "T!");
+        assert_eq!(rendered(named()), "MaybeUndefined<String>", "T");
+
+        // First-level lists
+        assert_eq!(rendered(nn(list(nn(named())))), "Vec<String>", "[T!]!");
+        assert_eq!(
+            rendered(list(nn(named()))),
+            "MaybeUndefined<Vec<String>>",
+            "[T!]"
+        );
+        assert_eq!(rendered(nn(list(named()))), "Vec<Option<String>>", "[T]!");
+        assert_eq!(
+            rendered(list(named())),
+            "MaybeUndefined<Vec<Option<String>>>",
+            "[T]"
+        );
+
+        // Nested lists — verify the recursion compounds correctly
+        assert_eq!(
+            rendered(nn(list(nn(list(nn(named())))))),
+            "Vec<Vec<String>>",
+            "[[T!]!]!"
+        );
+        assert_eq!(
+            rendered(list(nn(list(named())))),
+            "MaybeUndefined<Vec<Vec<Option<String>>>>",
+            "[[T]!]"
+        );
+        assert_eq!(
+            rendered(nn(list(list(nn(named()))))),
+            "Vec<Option<Vec<String>>>",
+            "[[T!]]!"
+        );
+    }
+
+    /// End-to-end: build an input struct with one field of each shape and
+    /// confirm the emitted code parses as valid Rust and contains the right
+    /// type wrappers + skip-serializing predicate on the right fields.
+    #[test]
+    fn emit_struct_for_all_list_shapes_parses() {
+        let mk_field = |name: &str, ty: GqlType| FieldDef {
+            name: name.to_string(),
+            description: None,
+            ty,
+            arguments: vec![],
+        };
+        let inputs = vec![InputDef {
+            name: "Sample".to_string(),
+            description: None,
+            fields: vec![
+                mk_field("a", nn(named())),
+                mk_field("b", named()),
+                mk_field("c", nn(list(nn(named())))),
+                mk_field("d", list(nn(named()))),
+                mk_field("e", nn(list(named()))),
+                mk_field("f", list(named())),
+            ],
+        }];
+        let output = emit(&inputs, &type_kind_map()).to_string();
+        syn::parse_file(&output).expect("emitted input code must be valid Rust");
+
+        let normalized: String = output.split_whitespace().collect();
+        // Required field: no skip predicate, plain T
+        assert!(normalized.contains("puba:String,"));
+        // Nullable field: MaybeUndefined wrapper + skip predicate
+        assert!(normalized.contains("MaybeUndefined::is_undefined"));
+        assert!(normalized.contains("pubb:MaybeUndefined<String>,"));
+        // Lists honor inner nullability uniformly
+        assert!(normalized.contains("pubc:Vec<String>,"));
+        assert!(normalized.contains("pubd:MaybeUndefined<Vec<String>>,"));
+        assert!(normalized.contains("pube:Vec<Option<String>>,"));
+        assert!(normalized.contains("pubf:MaybeUndefined<Vec<Option<String>>>,"));
+    }
+
+    /// Box is only emitted on InputObject fields when the field would otherwise
+    /// create an infinite-size struct: at depth 0 (where the wrapper —
+    /// `MaybeUndefined<_>` or plain `T` — needs `T` sized) and the target can
+    /// transitively reach the containing struct. List-wrapped fields drop Box
+    /// because `Vec<T>` is sized, and non-cyclic refs drop Box because there's
+    /// no size cycle to break.
+    #[test]
+    fn input_box_only_when_field_creates_size_cycle() {
+        // Schema:
+        //   Container { f1: Filter, f2: [Filter!]!, f3: Loner }
+        //   Filter    { c: Container, kids: [Filter!]! }
+        //   Loner     { name: String }
+        let mut map = HashMap::new();
+        map.insert("String".to_string(), TypeKind::Scalar);
+        map.insert("Container".to_string(), TypeKind::InputObject);
+        map.insert("Filter".to_string(), TypeKind::InputObject);
+        map.insert("Loner".to_string(), TypeKind::InputObject);
+
+        let mk = |name: &str, ty: GqlType| FieldDef {
+            name: name.to_string(),
+            description: None,
+            ty,
+            arguments: vec![],
+        };
+
+        let inputs = vec![
+            InputDef {
+                name: "Container".to_string(),
+                description: None,
+                fields: vec![
+                    mk("f1", GqlType::Named("Filter".to_string())),
+                    mk("f2", nn(list(nn(GqlType::Named("Filter".to_string()))))),
+                    mk("f3", GqlType::Named("Loner".to_string())),
+                ],
+            },
+            InputDef {
+                name: "Filter".to_string(),
+                description: None,
+                fields: vec![
+                    mk("c", GqlType::Named("Container".to_string())),
+                    mk("kids", nn(list(nn(GqlType::Named("Filter".to_string()))))),
+                ],
+            },
+            InputDef {
+                name: "Loner".to_string(),
+                description: None,
+                fields: vec![mk("name", named())],
+            },
+        ];
+
+        let normalized: String = emit(&inputs, &map).to_string().split_whitespace().collect();
+
+        // Container.f1 → Filter, and Filter reaches Container → Box.
+        assert!(
+            normalized.contains("pubf1:MaybeUndefined<Box<Filter>>,"),
+            "Container.f1 should be Boxed (cycle through Filter): {normalized}"
+        );
+        // Container.f2 → list of Filter; Vec breaks the size cycle, no Box.
+        assert!(
+            normalized.contains("pubf2:Vec<Filter>,"),
+            "Container.f2 should not be Boxed (Vec breaks cycle): {normalized}"
+        );
+        // Container.f3 → Loner; Loner cannot reach Container, no Box.
+        assert!(
+            normalized.contains("pubf3:MaybeUndefined<Loner>,"),
+            "Container.f3 should not be Boxed (no cycle): {normalized}"
+        );
+        // Filter.c closes the cycle from the other side → Box.
+        assert!(
+            normalized.contains("pubc:MaybeUndefined<Box<Container>>,"),
+            "Filter.c should be Boxed (cycle): {normalized}"
+        );
+        // Filter.kids → self-list, breaks cycle via Vec → no Box.
+        assert!(
+            normalized.contains("pubkids:Vec<Filter>,"),
+            "Filter.kids should not be Boxed (Vec breaks self-cycle): {normalized}"
+        );
+
+        let pretty = emit(&inputs, &map).to_string();
+        if let Err(e) = syn::parse_file(&pretty) {
+            panic!("emitted code must be valid Rust: {e}\n\n{pretty}");
+        }
+    }
+
+    /// Three-node cycle (A → B → C → A). The 2-node case is covered above; this
+    /// one catches any bug specific to longer cycles — e.g. a DFS that
+    /// accidentally short-circuits at depth 1. A fourth type `Outsider` sits
+    /// upstream of the cycle and must NOT be considered cyclic just because it
+    /// can reach a cyclic node.
+    #[test]
+    fn input_box_handles_three_node_and_longer_cycles() {
+        let mut map = HashMap::new();
+        map.insert("String".to_string(), TypeKind::Scalar);
+        map.insert("A".to_string(), TypeKind::InputObject);
+        map.insert("B".to_string(), TypeKind::InputObject);
+        map.insert("C".to_string(), TypeKind::InputObject);
+        map.insert("Outsider".to_string(), TypeKind::InputObject);
+
+        let mk = |name: &str, ty: GqlType| FieldDef {
+            name: name.to_string(),
+            description: None,
+            ty,
+            arguments: vec![],
+        };
+
+        let inputs = vec![
+            // Cycle: A → B → C → A
+            InputDef {
+                name: "A".to_string(),
+                description: None,
+                fields: vec![mk("b", GqlType::Named("B".to_string()))],
+            },
+            InputDef {
+                name: "B".to_string(),
+                description: None,
+                fields: vec![mk("c", GqlType::Named("C".to_string()))],
+            },
+            InputDef {
+                name: "C".to_string(),
+                description: None,
+                fields: vec![mk("a", GqlType::Named("A".to_string()))],
+            },
+            // Outsider points INTO the cycle but nothing points back.
+            InputDef {
+                name: "Outsider".to_string(),
+                description: None,
+                fields: vec![mk("a", GqlType::Named("A".to_string()))],
+            },
+        ];
+
+        let normalized: String = emit(&inputs, &map).to_string().split_whitespace().collect();
+
+        // Every edge in the cycle needs Box (the analysis is conservative —
+        // Boxing any single edge would suffice, but breaking all of them is
+        // simpler and always correct).
+        assert!(
+            normalized.contains("pubb:MaybeUndefined<Box<B>>,"),
+            "A.b should be Boxed (in cycle A→B→C→A): {normalized}"
+        );
+        assert!(
+            normalized.contains("pubc:MaybeUndefined<Box<C>>,"),
+            "B.c should be Boxed (in cycle): {normalized}"
+        );
+        assert!(
+            normalized.contains("pub\u{0061}:MaybeUndefined<Box<A>>,"),
+            "C.a should be Boxed (closes the cycle): {normalized}"
+        );
+
+        // Outsider.a → A. A cannot reach Outsider, so embedding A in Outsider
+        // is size-safe (A's own cycles are already broken by the Boxes above).
+        // The emit output contains both C.a and Outsider.a as `a: ...Box<A>...,`
+        // so we need to look at the Outsider struct specifically. Easiest way:
+        // the emitted source has exactly four struct bodies; only C's a field
+        // should be boxed. Verify by counting.
+        let box_a_count = normalized.matches("Box<A>").count();
+        assert_eq!(
+            box_a_count, 1,
+            "only C.a should Box A; Outsider.a should not. Got {box_a_count} in: {normalized}"
+        );
+
+        let pretty = emit(&inputs, &map).to_string();
+        if let Err(e) = syn::parse_file(&pretty) {
+            panic!("emitted code must be valid Rust: {e}\n\n{pretty}");
+        }
+    }
+}
diff --git a/crates/lineark-codegen/src/emit_mutations.rs b/crates/lineark-codegen/src/emit_mutations.rs
index 41948df..4a6c444 100644
--- a/crates/lineark-codegen/src/emit_mutations.rs
+++ b/crates/lineark-codegen/src/emit_mutations.rs
@@ -111,19 +111,16 @@ fn emit_mutation(
     for pf in &payload_obj.fields {
         let base = pf.ty.base_name();
         match type_kind_map.get(base) {
-            Some(TypeKind::Scalar) | Some(TypeKind::Enum) => {
-                if pf.name != "lastSyncId" {
-                    scalar_parts.push(pf.name.clone());
-                }
+            Some(TypeKind::Scalar) | Some(TypeKind::Enum) if pf.name != "lastSyncId" => {
+                scalar_parts.push(pf.name.clone());
             }
-            Some(TypeKind::Object) => {
-                // Only treat as entity if the Object type implements Node (has an `id` field).
-                if entity_info.is_none() {
-                    if let Some(obj) = object_map.get(base) {
-                        if obj.fields.iter().any(|f| f.name == "id") {
-                            entity_info =
-                                Some((pf.name.clone(), base.to_string(), is_list_type(&pf.ty)));
-                        }
+            // Only treat as entity if the Object type implements Node (has an `id` field),
+            // and only pick the first such field per payload.
+            Some(TypeKind::Object) if entity_info.is_none() => {
+                if let Some(obj) = object_map.get(base) {
+                    if obj.fields.iter().any(|f| f.name == "id") {
+                        entity_info =
+                            Some((pf.name.clone(), base.to_string(), is_list_type(&pf.ty)));
                     }
                 }
             }
diff --git a/crates/lineark-codegen/src/emit_types.rs b/crates/lineark-codegen/src/emit_types.rs
index 8c76dfc..0d1f571 100644
--- a/crates/lineark-codegen/src/emit_types.rs
+++ b/crates/lineark-codegen/src/emit_types.rs
@@ -1,17 +1,20 @@
+use crate::dep_graph::{self, reaches};
 use crate::emit_queries::{has_required_arguments, EXCLUDED_FIELDS};
 use crate::emit_scalars::graphql_type_to_rust;
 use crate::parser::{self, GqlType, ObjectDef, TypeKind};
 use heck::ToSnakeCase;
 use proc_macro2::TokenStream;
 use quote::quote;
-use std::collections::HashMap;
+use std::collections::{HashMap, HashSet};
 
 pub fn emit(objects: &[ObjectDef], type_kind_map: &HashMap<String, TypeKind>) -> TokenStream {
+    let reach = compute_object_reachability(objects, type_kind_map);
+
     let items: Vec<TokenStream> = objects
         .iter()
         .filter(|o| !o.name.is_empty())
         .map(|o| {
-            let struct_tokens = emit_struct(o, type_kind_map);
+            let struct_tokens = emit_struct(o, type_kind_map, &reach);
             let trait_tokens = emit_graphql_fields_impl(o, type_kind_map);
             quote! { #struct_tokens #trait_tokens }
         })
@@ -30,7 +33,56 @@ pub fn emit(objects: &[ObjectDef], type_kind_map: &HashMap<String, TypeKind>) ->
     }
 }
 
-fn emit_struct(obj: &ObjectDef, type_kind_map: &HashMap<String, TypeKind>) -> TokenStream {
+/// Build the Object dependency graph (edges through direct, non-list field
+/// references only) and compute transitive reachability. The result is used to
+/// decide on a per-field basis whether `Box<T>` is needed.
+fn compute_object_reachability(
+    objects: &[ObjectDef],
+    type_kind_map: &HashMap<String, TypeKind>,
+) -> HashMap<String, HashSet<String>> {
+    let mut edges: HashMap<String, Vec<String>> = HashMap::with_capacity(objects.len());
+    for obj in objects {
+        if obj.name.is_empty() {
+            continue;
+        }
+        // Dedupe: multiple fields can target the same Object type, and duplicate
+        // edges would just expand the DFS stack without changing reachability.
+        let mut deps: HashSet<String> = HashSet::new();
+        for field in &obj.fields {
+            if let Some(target) = direct_object_target(&field.ty, type_kind_map) {
+                deps.insert(target.to_string());
+            }
+        }
+        edges.insert(obj.name.clone(), deps.into_iter().collect());
+    }
+    dep_graph::reachability(&edges)
+}
+
+/// If `ty` is a direct (non-list) reference to an Object type, return that
+/// type's name. Lists return `None` because `Vec<T>` already breaks size
+/// cycles, so list-wrapped references aren't size-relevant edges.
+fn direct_object_target<'a>(
+    ty: &'a GqlType,
+    type_kind_map: &HashMap<String, TypeKind>,
+) -> Option<&'a str> {
+    match ty {
+        GqlType::NonNull(inner) => direct_object_target(inner, type_kind_map),
+        GqlType::Named(name) => {
+            if matches!(type_kind_map.get(name.as_str()), Some(TypeKind::Object)) {
+                Some(name.as_str())
+            } else {
+                None
+            }
+        }
+        GqlType::List(_) => None,
+    }
+}
+
+fn emit_struct(
+    obj: &ObjectDef,
+    type_kind_map: &HashMap<String, TypeKind>,
+    reach: &HashMap<String, HashSet<String>>,
+) -> TokenStream {
     let name = quote::format_ident!("{}", obj.name);
     let doc = parser::doc_comment_tokens(&obj.description);
 
@@ -48,7 +100,7 @@ fn emit_struct(obj: &ObjectDef, type_kind_map: &HashMap<String, TypeKind>) -> To
                 let ident = quote::format_ident!("{}", safe_name);
                 quote! { #ident }
             };
-            let rust_type = resolve_type(&f.ty, type_kind_map);
+            let rust_type = resolve_type(&f.ty, type_kind_map, &obj.name, reach);
             let fdoc = parser::doc_comment_tokens(&f.description);
             quote! {
                 #fdoc
@@ -78,41 +130,72 @@ fn is_includable_field(ty: &GqlType, type_kind_map: &HashMap<String, TypeKind>)
     )
 }
 
-/// Resolve a GraphQL type to its Rust type tokens.
-/// All output type fields are wrapped in `Option<T>`.
-/// Uses `Box<T>` for Object-typed fields to avoid infinite-size types
-/// from mutual recursion (e.g., Integration <-> Organization).
-fn resolve_type(ty: &GqlType, type_kind_map: &HashMap<String, TypeKind>) -> TokenStream {
-    let inner = resolve_inner_type(ty, type_kind_map);
-    let base = ty.base_name();
-    if matches!(type_kind_map.get(base), Some(TypeKind::Object)) {
+/// Resolve a GraphQL output field type to its Rust type tokens.
+///
+/// **Outermost** is always wrapped in `Option<T>` regardless of the schema's
+/// required marker — this lets consumers define lean structs via
+/// `#[derive(GraphQLFields)]` that omit fields they don't select, with the
+/// missing field deserializing as `None`.
+///
+/// **`Box<T>`** is added only when actually required for sizedness: when the
+/// field is a direct (non-list) reference to an Object that can transitively
+/// reach `container` in the schema's reference graph. Non-cyclic Object
+/// references emit as `Option<T>` directly, saving a heap allocation per
+/// instance. List-wrapped Object references never need `Box` because `Vec<T>`
+/// is already heap-allocated and sized.
+///
+/// **Inside lists**, nullability is honored faithfully: nullable elements
+/// become `Option<T>`, required elements stay bare `T`. GraphQL list slots
+/// are always materialized on the wire, so there's no "field omitted"
+/// concept inside a list — `Option` is the right shape.
+fn resolve_type(
+    ty: &GqlType,
+    type_kind_map: &HashMap<String, TypeKind>,
+    container: &str,
+    reach: &HashMap<String, HashSet<String>>,
+) -> TokenStream {
+    let inner = resolve_required(ty, type_kind_map);
+    let needs_box = direct_object_target(ty, type_kind_map)
+        .is_some_and(|target| reaches(target, container, reach));
+    if needs_box {
         quote! { Option<Box<#inner>> }
     } else {
         quote! { Option<#inner> }
     }
 }
 
-/// Resolve the inner type (without the outer Option wrapper).
-fn resolve_inner_type(ty: &GqlType, type_kind_map: &HashMap<String, TypeKind>) -> TokenStream {
+/// Resolve a type as if it were required at its current position. Strips
+/// outer `NonNull` markers, recurses into lists via [`resolve_list_element`].
+fn resolve_required(ty: &GqlType, type_kind_map: &HashMap<String, TypeKind>) -> TokenStream {
     match ty {
-        GqlType::Named(name) => {
-            let base = name.as_str();
-            match type_kind_map.get(base) {
-                Some(TypeKind::Object) => {
-                    let ident = quote::format_ident!("{}", name);
-                    quote! { #ident }
-                }
-                _ => graphql_type_to_rust(name),
+        GqlType::Named(name) => match type_kind_map.get(name.as_str()) {
+            Some(TypeKind::Object) => {
+                let ident = quote::format_ident!("{}", name);
+                quote! { #ident }
             }
-        }
-        GqlType::NonNull(inner) => resolve_inner_type(inner, type_kind_map),
+            _ => graphql_type_to_rust(name),
+        },
+        GqlType::NonNull(inner) => resolve_required(inner, type_kind_map),
         GqlType::List(inner) => {
-            let elem = resolve_inner_type(inner, type_kind_map);
+            let elem = resolve_list_element(inner, type_kind_map);
             quote! { Vec<#elem> }
         }
     }
 }
 
+/// Resolve a single list element. Nullable elements wrap in `Option<T>`,
+/// required elements stay bare. Mutually recurses with [`resolve_required`]
+/// to handle nested lists.
+fn resolve_list_element(ty: &GqlType, type_kind_map: &HashMap<String, TypeKind>) -> TokenStream {
+    match ty {
+        GqlType::NonNull(inner) => resolve_required(inner, type_kind_map),
+        other => {
+            let payload = resolve_required(other, type_kind_map);
+            quote! { Option<#payload> }
+        }
+    }
+}
+
 /// Generate `impl GraphQLFields for T` — returns all scalar/enum field names.
 /// Sets `type FullType = Self` so full types validate against themselves.
 fn emit_graphql_fields_impl(
@@ -203,7 +286,9 @@ mod tests {
     }
 
     #[test]
-    fn emit_includes_object_fields_with_box() {
+    fn emit_includes_object_fields_without_unnecessary_box() {
+        // Single Issue type with a Team field. Team has no schema definition
+        // here, so it cannot reach back to Issue → no cycle, no Box.
         let type_kind_map = make_type_kind_map();
         let objects = vec![ObjectDef {
             name: "Issue".to_string(),
@@ -225,9 +310,12 @@ mod tests {
         }];
         let output = emit(&objects, &type_kind_map).to_string();
         assert!(output.contains("pub id"));
-        // Object fields are included and wrapped in Box to prevent infinite-size types
         assert!(output.contains("pub team"));
-        assert!(output.contains("Box"));
+        // No cycle in the graph → no Box wrapping.
+        assert!(
+            !output.contains("Box"),
+            "no Box should be emitted when there is no size cycle: {output}"
+        );
     }
 
     #[test]
@@ -323,6 +411,172 @@ mod tests {
         assert!(output.contains("label_ids"));
     }
 
+    /// Render a single field's type for `output_field_shapes` — there is no
+    /// container to reach back to, so cycles are impossible and `Box` never
+    /// applies. This isolates the list/nullability rules from the Box rules.
+    fn rendered_output(ty: GqlType) -> String {
+        let map = make_type_kind_map();
+        let reach: HashMap<String, HashSet<String>> = HashMap::new();
+        resolve_type(&ty, &map, "Container", &reach)
+            .to_string()
+            .split_whitespace()
+            .collect::<String>()
+    }
+
+    fn n(t: GqlType) -> GqlType {
+        GqlType::NonNull(Box::new(t))
+    }
+    fn l(t: GqlType) -> GqlType {
+        GqlType::List(Box::new(t))
+    }
+    fn s() -> GqlType {
+        GqlType::Named("String".to_string())
+    }
+
+    /// Output convention: outermost is **always** wrapped in `Option<>`
+    /// (lean-struct selection allows any field to be missing). Inside lists,
+    /// element nullability is honored faithfully.
+    #[test]
+    fn output_field_shapes() {
+        // Outer wrap is Option regardless of `!` — this is the lean-struct convention.
+        assert_eq!(rendered_output(n(s())), "Option<String>", "T!");
+        assert_eq!(rendered_output(s()), "Option<String>", "T");
+
+        // First-level lists
+        assert_eq!(
+            rendered_output(n(l(n(s())))),
+            "Option<Vec<String>>",
+            "[T!]!"
+        );
+        assert_eq!(rendered_output(l(n(s()))), "Option<Vec<String>>", "[T!]");
+        assert_eq!(
+            rendered_output(n(l(s()))),
+            "Option<Vec<Option<String>>>",
+            "[T]!"
+        );
+        assert_eq!(
+            rendered_output(l(s())),
+            "Option<Vec<Option<String>>>",
+            "[T]"
+        );
+
+        // Nested lists
+        assert_eq!(
+            rendered_output(n(l(n(l(n(s())))))),
+            "Option<Vec<Vec<String>>>",
+            "[[T!]!]!"
+        );
+        assert_eq!(
+            rendered_output(l(n(l(s())))),
+            "Option<Vec<Vec<Option<String>>>>",
+            "[[T]!]"
+        );
+        assert_eq!(
+            rendered_output(n(l(l(n(s()))))),
+            "Option<Vec<Option<Vec<String>>>>",
+            "[[T!]]!"
+        );
+    }
+
+    /// Box is only emitted when the field would otherwise create an infinite-size
+    /// Rust struct: target must be a *direct* (non-list) Object reference whose
+    /// type can transitively reach the containing struct. Everything else gets a
+    /// plain `Option<T>`.
+    #[test]
+    fn box_only_when_field_creates_size_cycle() {
+        // Schema:
+        //   Container { team: Team }       // direct ref
+        //   Container { teams: [Team!]! }  // list-wrapped — Vec breaks cycles
+        //   Team { container: Container }  // closes the cycle Container ↔ Team
+        //   Loner { name: String }         // unrelated, never referenced back
+        let mut map = make_type_kind_map();
+        map.insert("Container".to_string(), TypeKind::Object);
+        map.insert("Loner".to_string(), TypeKind::Object);
+
+        let objects = vec![
+            ObjectDef {
+                name: "Container".to_string(),
+                description: None,
+                fields: vec![
+                    FieldDef {
+                        name: "team".to_string(),
+                        description: None,
+                        ty: GqlType::Named("Team".to_string()),
+                        arguments: vec![],
+                    },
+                    FieldDef {
+                        name: "teams".to_string(),
+                        description: None,
+                        ty: n(l(n(GqlType::Named("Team".to_string())))),
+                        arguments: vec![],
+                    },
+                    FieldDef {
+                        name: "loner".to_string(),
+                        description: None,
+                        ty: GqlType::Named("Loner".to_string()),
+                        arguments: vec![],
+                    },
+                ],
+            },
+            ObjectDef {
+                name: "Team".to_string(),
+                description: None,
+                fields: vec![FieldDef {
+                    name: "container".to_string(),
+                    description: None,
+                    ty: GqlType::Named("Container".to_string()),
+                    arguments: vec![],
+                }],
+            },
+            ObjectDef {
+                name: "Loner".to_string(),
+                description: None,
+                fields: vec![FieldDef {
+                    name: "name".to_string(),
+                    description: None,
+                    ty: GqlType::Named("String".to_string()),
+                    arguments: vec![],
+                }],
+            },
+        ];
+
+        let output: String = emit(&objects, &map)
+            .to_string()
+            .split_whitespace()
+            .collect();
+
+        // Container.team is in a cycle (Container → Team → Container) → Box.
+        assert!(
+            output.contains("pubteam:Option<Box<Team>>,"),
+            "Container.team should be Boxed (cycle): {output}"
+        );
+        // Container.teams uses a Vec → Vec breaks the size cycle, no Box.
+        assert!(
+            output.contains("pubteams:Option<Vec<Team>>,"),
+            "Container.teams should not be Boxed (Vec breaks cycle): {output}"
+        );
+        // Container.loner: Loner has no path back to Container → no Box.
+        assert!(
+            output.contains("publoner:Option<Loner>,"),
+            "Container.loner should not be Boxed (no cycle): {output}"
+        );
+        // Team.container closes the cycle from the other side → Box.
+        assert!(
+            output.contains("pubcontainer:Option<Box<Container>>,"),
+            "Team.container should be Boxed (cycle): {output}"
+        );
+        // Loner.name is a scalar → no Box.
+        assert!(
+            output.contains("pubname:Option<String>,"),
+            "Loner.name should be plain Option<String>: {output}"
+        );
+
+        let pretty = emit(&objects, &map).to_string();
+        if let Err(e) = syn::parse_file(&pretty) {
+            panic!("emitted code must be valid Rust: {e}\n\n{pretty}");
+        }
+    }
+
     #[test]
     fn emit_graphql_fields_selection() {
         let type_kind_map = make_type_kind_map();
diff --git a/crates/lineark-codegen/src/main.rs b/crates/lineark-codegen/src/main.rs
index 91d3567..dfcfae3 100644
--- a/crates/lineark-codegen/src/main.rs
+++ b/crates/lineark-codegen/src/main.rs
@@ -1,3 +1,4 @@
+mod dep_graph;
 mod emit_enums;
 mod emit_inputs;
 mod emit_mutations;
diff --git a/crates/lineark-sdk/README.md b/crates/lineark-sdk/README.md
index 5ae96b6..df9fde4 100644
--- a/crates/lineark-sdk/README.md
+++ b/crates/lineark-sdk/README.md
@@ -152,13 +152,41 @@ use lineark_sdk::generated::inputs::IssueCreateInput;
 use lineark_sdk::generated::types::Issue;
 
 let payload = client.issue_create::<Issue>(IssueCreateInput {
-    title: Some("Fix the bug".to_string()),
-    team_id: Some("team-uuid".to_string()),
-    priority: Some(2),
+    team_id: "team-uuid".to_string(),              // required
+    title: "Fix the bug".to_string().into(),       // nullable → MaybeUndefined
+    priority: 2.into(),                            // nullable → MaybeUndefined
     ..Default::default()
 }).await?;
 ```
 
+### Three-state fields on update/create inputs
+
+Nullable input fields use [`MaybeUndefined<T>`](crate::MaybeUndefined) so you
+can distinguish "leave unchanged" from "explicit null" — GraphQL's nullable
+inputs carry both meanings, and `Option<T>` + `skip_serializing_if` can only
+express the first.
+
+| Intent | Value | Wire form |
+|---|---|---|
+| Leave unchanged | `MaybeUndefined::Undefined` (the default) | field omitted |
+| Clear on the server | `MaybeUndefined::Null` | `"field": null` |
+| Set to a value | `MaybeUndefined::Value(v)` or `v.into()` | `"field": v` |
+
+```rust
+use lineark_sdk::generated::inputs::ProjectUpdateInput;
+use lineark_sdk::MaybeUndefined;
+
+// Rename a project AND clear its lead in a single mutation.
+let input = ProjectUpdateInput {
+    name: "New name".to_string().into(),
+    lead_id: MaybeUndefined::Null,
+    ..Default::default()
+};
+client.project_update::<Project>(input, project_id).await?;
+```
+
+Required fields (schema type ends with `!`) stay as plain `T` — no wrapper.
+
 | Method | Description |
 |--------|-------------|
 | `issue_create(input)` | Create an issue |
diff --git a/crates/lineark-sdk/src/field_update.rs b/crates/lineark-sdk/src/field_update.rs
new file mode 100644
index 0000000..3450040
--- /dev/null
+++ b/crates/lineark-sdk/src/field_update.rs
@@ -0,0 +1,222 @@
+//! Three-state wrapper for nullable input fields.
+//!
+//! GraphQL distinguishes between an omitted field ("don't change this") and an
+//! explicit `null` ("clear this field"). `Option<T>` + `skip_serializing_if`
+//! can only express the first. [`MaybeUndefined<T>`] carries both, so
+//! generated input types can drive the Linear API faithfully without hand-rolled
+//! JSON patches on the consumer side.
+//!
+//! Codegen emits nullable input fields as:
+//!
+//! ```rust,ignore
+//! #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+//! pub lead_id: MaybeUndefined<String>,
+//! ```
+//!
+//! Consumers choose one of:
+//!
+//! | Intent                    | Value                          | Wire form       |
+//! |---------------------------|--------------------------------|-----------------|
+//! | Leave unchanged           | `MaybeUndefined::Undefined`    | field omitted   |
+//! | Clear on the server       | `MaybeUndefined::Null`         | `"field": null` |
+//! | Set to a value            | `MaybeUndefined::Value(v)`     | `"field": v`    |
+
+use serde::{Deserialize, Deserializer, Serialize, Serializer};
+
+/// A three-state field value: undefined (omitted), null (explicit clear), or a concrete value.
+///
+/// See the [module documentation](self) for the rationale and wire-format mapping.
+///
+/// # Struct-context contract
+///
+/// The [`Undefined`](MaybeUndefined::Undefined) / [`Null`](MaybeUndefined::Null)
+/// distinction is preserved on the wire **only** when this value sits in a
+/// struct field carrying
+/// `#[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]`
+/// — which is what codegen emits for every nullable input field. In any other
+/// context (`serde_json::to_value(MaybeUndefined::<T>::Undefined)`, a bare
+/// value inside a `Vec<MaybeUndefined<T>>`, etc.) `Undefined` cannot be
+/// "omitted" — there's no containing struct to omit it from — and serializes
+/// as JSON `null`, collapsing the distinction. Use this type *only* as a
+/// struct field paired with the skip predicate above.
+///
+/// # Derive bounds
+///
+/// The [`Eq`] and [`Hash`] impls are conditional on `T: Eq + Hash`. Types
+/// containing non-`Eq` scalars (notably `f64`) therefore can't derive those
+/// traits transitively — this is expected and matches `Option<T>`.
+#[derive(Debug, Clone, PartialEq, Eq, Hash)]
+pub enum MaybeUndefined<T> {
+    /// Field is absent from the serialized output.
+    Undefined,
+    /// Field is serialized as JSON `null` (clears the value on the server).
+    Null,
+    /// Field is serialized as the wrapped value.
+    Value(T),
+}
+
+impl<T> MaybeUndefined<T> {
+    /// Returns `true` if the value is [`MaybeUndefined::Undefined`].
+    ///
+    /// Codegen uses this as the `skip_serializing_if` predicate so `Undefined`
+    /// fields are omitted from the serialized output entirely.
+    pub fn is_undefined(&self) -> bool {
+        matches!(self, Self::Undefined)
+    }
+}
+
+// Manual impl (not `#[derive(Default)]`) so the `Default` bound on `T` is
+// avoided — consumers need `MaybeUndefined::<T>::default()` to work for any T,
+// not just those that themselves implement `Default`.
+#[allow(clippy::derivable_impls)]
+impl<T> Default for MaybeUndefined<T> {
+    fn default() -> Self {
+        Self::Undefined
+    }
+}
+
+impl<T> From<T> for MaybeUndefined<T> {
+    fn from(v: T) -> Self {
+        Self::Value(v)
+    }
+}
+
+/// Lifts an `Option<T>` into the three-state world, collapsing `None` to
+/// [`Undefined`](MaybeUndefined::Undefined).
+///
+/// This is the right default for **constructing** input values: a CLI flag
+/// that wasn't passed (`Option::None`) means "leave the field unchanged", so
+/// it maps to `Undefined`. If you instead want `None` to clear the field on
+/// the server, use [`MaybeUndefined::Null`] explicitly.
+///
+/// Note the intentional asymmetry with [`Deserialize`]: when round-tripping
+/// through JSON, an absent field deserializes to `Undefined` (via the
+/// `#[serde(default)]` on the field), while an explicit JSON `null`
+/// deserializes to `Null`. That matches GraphQL's wire semantics. `Option<T>`
+/// doesn't carry the "absent" vs "null" distinction, so `From<Option<T>>`
+/// can't preserve it either.
+impl<T> From<Option<T>> for MaybeUndefined<T> {
+    fn from(o: Option<T>) -> Self {
+        match o {
+            Some(v) => Self::Value(v),
+            None => Self::Undefined,
+        }
+    }
+}
+
+impl<T: Serialize> Serialize for MaybeUndefined<T> {
+    fn serialize<S: Serializer>(&self, s: S) -> Result<S::Ok, S::Error> {
+        match self {
+            // Unreachable in normal use: codegen emits
+            // `skip_serializing_if = "MaybeUndefined::is_undefined"`, so serde
+            // never asks us to serialize the Undefined variant on struct fields.
+            Self::Undefined => s.serialize_none(),
+            Self::Null => s.serialize_none(),
+            Self::Value(v) => v.serialize(s),
+        }
+    }
+}
+
+/// Maps the three JSON inputs a struct field can present as follows:
+///
+/// | Input                          | Result      |
+/// |--------------------------------|-------------|
+/// | field absent from JSON         | `Undefined` (via `#[serde(default)]`) |
+/// | field present with `null`      | `Null`      |
+/// | field present with a value `v` | `Value(v)`  |
+///
+/// Absent-field handling is driven by `#[serde(default)]` on the struct
+/// field, not by this impl — serde only calls `deserialize` when the key is
+/// present. Codegen emits that attribute on every nullable input field, which
+/// is what preserves the three-state distinction on round-trip.
+///
+/// Note the intentional asymmetry with [`From<Option<T>>`]: `None → Undefined`
+/// during construction (a missing CLI flag shouldn't touch the server),
+/// but JSON `null → Null` during deserialization (the server *did* send
+/// `null`).
+impl<'de, T: Deserialize<'de>> Deserialize<'de> for MaybeUndefined<T> {
+    fn deserialize<D: Deserializer<'de>>(d: D) -> Result<Self, D::Error> {
+        Option::<T>::deserialize(d).map(|o| match o {
+            Some(v) => Self::Value(v),
+            None => Self::Null,
+        })
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use serde::{Deserialize, Serialize};
+
+    #[derive(Debug, Default, Serialize, Deserialize, PartialEq, Eq)]
+    struct Host {
+        #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+        field: MaybeUndefined<String>,
+    }
+
+    #[test]
+    fn default_is_undefined() {
+        let m: MaybeUndefined<String> = MaybeUndefined::default();
+        assert!(matches!(m, MaybeUndefined::Undefined));
+        assert!(m.is_undefined());
+    }
+
+    #[test]
+    fn from_value_is_value() {
+        let m: MaybeUndefined<String> = MaybeUndefined::from("hi".to_string());
+        assert_eq!(m, MaybeUndefined::Value("hi".to_string()));
+    }
+
+    #[test]
+    fn from_option_maps_correctly() {
+        let some: MaybeUndefined<i32> = MaybeUndefined::from(Some(5));
+        let none: MaybeUndefined<i32> = MaybeUndefined::from(Option::<i32>::None);
+        assert_eq!(some, MaybeUndefined::Value(5));
+        assert_eq!(none, MaybeUndefined::Undefined);
+    }
+
+    #[test]
+    fn serialize_value_emits_value() {
+        let host = Host {
+            field: MaybeUndefined::Value("hello".to_string()),
+        };
+        assert_eq!(
+            serde_json::to_string(&host).unwrap(),
+            r#"{"field":"hello"}"#
+        );
+    }
+
+    #[test]
+    fn serialize_null_emits_null() {
+        let host = Host {
+            field: MaybeUndefined::Null,
+        };
+        assert_eq!(serde_json::to_string(&host).unwrap(), r#"{"field":null}"#);
+    }
+
+    #[test]
+    fn serialize_undefined_is_skipped() {
+        let host = Host {
+            field: MaybeUndefined::Undefined,
+        };
+        assert_eq!(serde_json::to_string(&host).unwrap(), r#"{}"#);
+    }
+
+    #[test]
+    fn deserialize_value_is_value() {
+        let host: Host = serde_json::from_str(r#"{"field":"hello"}"#).unwrap();
+        assert_eq!(host.field, MaybeUndefined::Value("hello".to_string()));
+    }
+
+    #[test]
+    fn deserialize_null_is_null() {
+        let host: Host = serde_json::from_str(r#"{"field":null}"#).unwrap();
+        assert_eq!(host.field, MaybeUndefined::Null);
+    }
+
+    #[test]
+    fn deserialize_absent_is_undefined() {
+        let host: Host = serde_json::from_str(r#"{}"#).unwrap();
+        assert_eq!(host.field, MaybeUndefined::Undefined);
+    }
+}
diff --git a/crates/lineark-sdk/src/generated/client_impl.rs b/crates/lineark-sdk/src/generated/client_impl.rs
index 2cc9a11..a0350da 100644
--- a/crates/lineark-sdk/src/generated/client_impl.rs
+++ b/crates/lineark-sdk/src/generated/client_impl.rs
@@ -13,19 +13,19 @@ use crate::error::LinearError;
 use crate::field_selection::GraphQLFields;
 use serde::de::DeserializeOwned;
 impl Client {
-    /// All issue workflow states.
+    /// All issue workflow states (issue statuses). Returns a paginated list of workflow states visible to the authenticated user, across all teams they have access to.
     ///
     /// Full type: [`WorkflowState`](super::types::WorkflowState)
     pub fn workflow_states<T>(&self) -> WorkflowStatesQueryBuilder<'_, T> {
         crate::generated::queries::workflow_states(self)
     }
-    /// All users for the organization.
+    /// All users in the workspace. Supports filtering, sorting, and pagination.
     ///
     /// Full type: [`User`](super::types::User)
     pub fn users<T>(&self) -> UsersQueryBuilder<'_, T> {
         crate::generated::queries::users(self)
     }
-    /// The currently authenticated user.
+    /// The currently authenticated user making the API request.
     ///
     /// Full type: [`User`](super::types::User)
     pub async fn whoami<T: DeserializeOwned + GraphQLFields<FullType = super::types::User>>(
@@ -33,13 +33,13 @@ impl Client {
     ) -> Result<T, LinearError> {
         crate::generated::queries::whoami::<T>(self).await
     }
-    /// All projects.
+    /// Returns all projects in the workspace, with optional filtering and sorting.
     ///
     /// Full type: [`Project`](super::types::Project)
     pub fn projects<T>(&self) -> ProjectsQueryBuilder<'_, T> {
         crate::generated::queries::projects(self)
     }
-    /// One specific project.
+    /// Returns a single project by its identifier or URL slug.
     ///
     /// Full type: [`Project`](super::types::Project)
     pub async fn project<T: DeserializeOwned + GraphQLFields<FullType = super::types::Project>>(
@@ -48,13 +48,13 @@ impl Client {
     ) -> Result<T, LinearError> {
         crate::generated::queries::project::<T>(self, id).await
     }
-    /// All teams whose issues can be accessed by the user. This might be different from `administrableTeams`, which also includes teams whose settings can be changed by the user.
+    /// All teams whose issues the user can access. This includes public teams and private teams the user is a member of. This may differ from `administrableTeams`, which returns teams whose settings the user can change but whose issues they don't necessarily have access to.
     ///
     /// Full type: [`Team`](super::types::Team)
     pub fn teams<T>(&self) -> TeamsQueryBuilder<'_, T> {
         crate::generated::queries::teams(self)
     }
-    /// One specific team.
+    /// Fetches a specific team by its ID.
     ///
     /// Full type: [`Team`](super::types::Team)
     pub async fn team<T: DeserializeOwned + GraphQLFields<FullType = super::types::Team>>(
@@ -63,25 +63,25 @@ impl Client {
     ) -> Result<T, LinearError> {
         crate::generated::queries::team::<T>(self, id).await
     }
-    /// Search issues.
+    /// Search issues by text query using full-text and vector search. Results are ranked by relevance unless an orderBy parameter is specified. Supports optional issue filters and comment inclusion. Rate-limited to 30 requests per minute.
     ///
     /// Full type: [`IssueSearchResult`](super::types::IssueSearchResult)
     pub fn search_issues<T>(&self, term: impl Into<String>) -> SearchIssuesQueryBuilder<'_, T> {
         crate::generated::queries::search_issues(self, term)
     }
-    /// All project statuses.
+    /// Returns all project statuses in the workspace.
     ///
     /// Full type: [`ProjectStatus`](super::types::ProjectStatus)
     pub fn project_statuses<T>(&self) -> ProjectStatusesQueryBuilder<'_, T> {
         crate::generated::queries::project_statuses(self)
     }
-    /// All milestones for the project.
+    /// Returns all project milestones in the workspace, with optional filtering.
     ///
     /// Full type: [`ProjectMilestone`](super::types::ProjectMilestone)
     pub fn project_milestones<T>(&self) -> ProjectMilestonesQueryBuilder<'_, T> {
         crate::generated::queries::project_milestones(self)
     }
-    /// One specific project milestone.
+    /// Returns a single project milestone by its identifier.
     ///
     /// Full type: [`ProjectMilestone`](super::types::ProjectMilestone)
     pub async fn project_milestone<
@@ -92,19 +92,19 @@ impl Client {
     ) -> Result<T, LinearError> {
         crate::generated::queries::project_milestone::<T>(self, id).await
     }
-    /// All project labels.
+    /// Returns all project labels in the workspace, with optional filtering.
     ///
     /// Full type: [`ProjectLabel`](super::types::ProjectLabel)
     pub fn project_labels<T>(&self) -> ProjectLabelsQueryBuilder<'_, T> {
         crate::generated::queries::project_labels(self)
     }
-    /// All issues.
+    /// All issues. Returns a paginated list of issues visible to the authenticated user. Can be filtered by various criteria including team, assignee, state, labels, project, and cycle.
     ///
     /// Full type: [`Issue`](super::types::Issue)
     pub fn issues<T>(&self) -> IssuesQueryBuilder<'_, T> {
         crate::generated::queries::issues(self)
     }
-    /// One specific issue.
+    /// One specific issue, looked up by its unique identifier.
     ///
     /// Full type: [`Issue`](super::types::Issue)
     pub async fn issue<T: DeserializeOwned + GraphQLFields<FullType = super::types::Issue>>(
@@ -124,13 +124,13 @@ impl Client {
     ) -> Result<Option<T>, LinearError> {
         crate::generated::queries::issue_vcs_branch_search::<T>(self, branch_name).await
     }
-    /// All issue relationships.
+    /// All issue relations. Returns a paginated list of all issue relations (blocks, blocked by, relates to, duplicates) visible to the authenticated user.
     ///
     /// Full type: [`IssueRelation`](super::types::IssueRelation)
     pub fn issue_relations<T>(&self) -> IssueRelationsQueryBuilder<'_, T> {
         crate::generated::queries::issue_relations(self)
     }
-    /// One specific issue relation.
+    /// One specific issue relation, looked up by its unique identifier.
     ///
     /// Full type: [`IssueRelation`](super::types::IssueRelation)
     pub async fn issue_relation<
@@ -141,19 +141,19 @@ impl Client {
     ) -> Result<T, LinearError> {
         crate::generated::queries::issue_relation::<T>(self, id).await
     }
-    /// All issue labels.
+    /// All issue labels. Returns a paginated list of labels visible to the authenticated user, including both workspace-level and team-scoped labels.
     ///
     /// Full type: [`IssueLabel`](super::types::IssueLabel)
     pub fn issue_labels<T>(&self) -> IssueLabelsQueryBuilder<'_, T> {
         crate::generated::queries::issue_labels(self)
     }
-    /// All documents in the workspace.
+    /// All documents the user has access to in the workspace.
     ///
     /// Full type: [`Document`](super::types::Document)
     pub fn documents<T>(&self) -> DocumentsQueryBuilder<'_, T> {
         crate::generated::queries::documents(self)
     }
-    /// One specific document.
+    /// A specific document by ID or slug.
     ///
     /// Full type: [`Document`](super::types::Document)
     pub async fn document<
@@ -164,13 +164,13 @@ impl Client {
     ) -> Result<T, LinearError> {
         crate::generated::queries::document::<T>(self, id).await
     }
-    /// All cycles.
+    /// All cycles accessible to the user.
     ///
     /// Full type: [`Cycle`](super::types::Cycle)
     pub fn cycles<T>(&self) -> CyclesQueryBuilder<'_, T> {
         crate::generated::queries::cycles(self)
     }
-    /// One specific cycle.
+    /// One specific cycle, looked up by ID or slug.
     ///
     /// Full type: [`Cycle`](super::types::Cycle)
     pub async fn cycle<T: DeserializeOwned + GraphQLFields<FullType = super::types::Cycle>>(
@@ -205,61 +205,6 @@ impl Client {
     ) -> Result<serde_json::Value, LinearError> {
         crate::generated::mutations::image_upload_from_url(self, url).await
     }
-    /// Creates a new comment.
-    ///
-    /// Full type: [`Comment`](super::types::Comment)
-    pub async fn comment_create<
-        T: serde::de::DeserializeOwned
-            + crate::field_selection::GraphQLFields<FullType = super::types::Comment>,
-    >(
-        &self,
-        input: CommentCreateInput,
-    ) -> Result<T, LinearError> {
-        crate::generated::mutations::comment_create::<T>(self, input).await
-    }
-    /// Updates a comment.
-    ///
-    /// Full type: [`Comment`](super::types::Comment)
-    pub async fn comment_update<
-        T: serde::de::DeserializeOwned
-            + crate::field_selection::GraphQLFields<FullType = super::types::Comment>,
-    >(
-        &self,
-        skip_edited_at: Option<bool>,
-        input: CommentUpdateInput,
-        id: String,
-    ) -> Result<T, LinearError> {
-        crate::generated::mutations::comment_update::<T>(self, skip_edited_at, input, id).await
-    }
-    /// Deletes a comment.
-    pub async fn comment_delete(&self, id: String) -> Result<serde_json::Value, LinearError> {
-        crate::generated::mutations::comment_delete(self, id).await
-    }
-    /// Resolves a comment.
-    ///
-    /// Full type: [`Comment`](super::types::Comment)
-    pub async fn comment_resolve<
-        T: serde::de::DeserializeOwned
-            + crate::field_selection::GraphQLFields<FullType = super::types::Comment>,
-    >(
-        &self,
-        resolving_comment_id: Option<String>,
-        id: String,
-    ) -> Result<T, LinearError> {
-        crate::generated::mutations::comment_resolve::<T>(self, resolving_comment_id, id).await
-    }
-    /// Unresolves a comment.
-    ///
-    /// Full type: [`Comment`](super::types::Comment)
-    pub async fn comment_unresolve<
-        T: serde::de::DeserializeOwned
-            + crate::field_selection::GraphQLFields<FullType = super::types::Comment>,
-    >(
-        &self,
-        id: String,
-    ) -> Result<T, LinearError> {
-        crate::generated::mutations::comment_unresolve::<T>(self, id).await
-    }
     /// Creates a new project.
     ///
     /// Full type: [`Project`](super::types::Project)
@@ -286,7 +231,7 @@ impl Client {
     ) -> Result<T, LinearError> {
         crate::generated::mutations::project_update::<T>(self, input, id).await
     }
-    /// Deletes (trashes) a project.
+    /// Deletes (trashes) a project. The project can be restored later with projectUnarchive.
     ///
     /// Full type: [`Project`](super::types::Project)
     pub async fn project_delete<
@@ -298,7 +243,7 @@ impl Client {
     ) -> Result<T, LinearError> {
         crate::generated::mutations::project_delete::<T>(self, id).await
     }
-    /// Creates a new team. The user who creates the team will automatically be added as a member to the newly created team.
+    /// Creates a new team. The user who creates the team will automatically be added as a member and owner of the newly created team. Default workflow states, labels, and other team resources are created alongside the team.
     ///
     /// Full type: [`Team`](super::types::Team)
     pub async fn team_create<
@@ -311,7 +256,7 @@ impl Client {
     ) -> Result<T, LinearError> {
         crate::generated::mutations::team_create::<T>(self, copy_settings_from_team_id, input).await
     }
-    /// Updates a team.
+    /// Updates a team's settings, properties, or configuration. Requires team owner or workspace admin permissions for most changes.
     ///
     /// Full type: [`Team`](super::types::Team)
     pub async fn team_update<
@@ -325,11 +270,11 @@ impl Client {
     ) -> Result<T, LinearError> {
         crate::generated::mutations::team_update::<T>(self, mapping, input, id).await
     }
-    /// Deletes a team.
+    /// Archives a team and schedules its data for deletion. Requires team owner or workspace admin permissions.
     pub async fn team_delete(&self, id: String) -> Result<serde_json::Value, LinearError> {
         crate::generated::mutations::team_delete(self, id).await
     }
-    /// Creates a new team membership.
+    /// Creates a new team membership, adding a user to a team. Validates that the user is not already a member, the team is not archived or retired, and the requesting user has permission to add members.
     ///
     /// Full type: [`TeamMembership`](super::types::TeamMembership)
     pub async fn team_membership_create<
@@ -341,7 +286,7 @@ impl Client {
     ) -> Result<T, LinearError> {
         crate::generated::mutations::team_membership_create::<T>(self, input).await
     }
-    /// Deletes a team membership.
+    /// Deletes a team membership, removing the user from the team. Users can remove their own membership, or team owners and workspace admins can remove other members.
     pub async fn team_membership_delete(
         &self,
         also_leave_parent_teams: Option<bool>,
@@ -535,7 +480,7 @@ impl Client {
     ) -> Result<T, LinearError> {
         crate::generated::mutations::document_update::<T>(self, input, id).await
     }
-    /// Deletes (trashes) a document.
+    /// Deletes (trashes) a document. The document is marked as trashed and archived, but not permanently removed.
     ///
     /// Full type: [`Document`](super::types::Document)
     pub async fn document_delete<
@@ -547,4 +492,59 @@ impl Client {
     ) -> Result<T, LinearError> {
         crate::generated::mutations::document_delete::<T>(self, id).await
     }
+    /// Creates a new comment.
+    ///
+    /// Full type: [`Comment`](super::types::Comment)
+    pub async fn comment_create<
+        T: serde::de::DeserializeOwned
+            + crate::field_selection::GraphQLFields<FullType = super::types::Comment>,
+    >(
+        &self,
+        input: CommentCreateInput,
+    ) -> Result<T, LinearError> {
+        crate::generated::mutations::comment_create::<T>(self, input).await
+    }
+    /// Updates a comment.
+    ///
+    /// Full type: [`Comment`](super::types::Comment)
+    pub async fn comment_update<
+        T: serde::de::DeserializeOwned
+            + crate::field_selection::GraphQLFields<FullType = super::types::Comment>,
+    >(
+        &self,
+        skip_edited_at: Option<bool>,
+        input: CommentUpdateInput,
+        id: String,
+    ) -> Result<T, LinearError> {
+        crate::generated::mutations::comment_update::<T>(self, skip_edited_at, input, id).await
+    }
+    /// Deletes a comment.
+    pub async fn comment_delete(&self, id: String) -> Result<serde_json::Value, LinearError> {
+        crate::generated::mutations::comment_delete(self, id).await
+    }
+    /// Resolves a comment thread. Marks the root comment as resolved by the current user.
+    ///
+    /// Full type: [`Comment`](super::types::Comment)
+    pub async fn comment_resolve<
+        T: serde::de::DeserializeOwned
+            + crate::field_selection::GraphQLFields<FullType = super::types::Comment>,
+    >(
+        &self,
+        resolving_comment_id: Option<String>,
+        id: String,
+    ) -> Result<T, LinearError> {
+        crate::generated::mutations::comment_resolve::<T>(self, resolving_comment_id, id).await
+    }
+    /// Unresolves a previously resolved comment thread. Clears the resolved state on the root comment.
+    ///
+    /// Full type: [`Comment`](super::types::Comment)
+    pub async fn comment_unresolve<
+        T: serde::de::DeserializeOwned
+            + crate::field_selection::GraphQLFields<FullType = super::types::Comment>,
+    >(
+        &self,
+        id: String,
+    ) -> Result<T, LinearError> {
+        crate::generated::mutations::comment_unresolve::<T>(self, id).await
+    }
 }
diff --git a/crates/lineark-sdk/src/generated/enums.rs b/crates/lineark-sdk/src/generated/enums.rs
index cf8d773..c1824f8 100644
--- a/crates/lineark-sdk/src/generated/enums.rs
+++ b/crates/lineark-sdk/src/generated/enums.rs
@@ -64,6 +64,249 @@ pub enum AgentSessionType {
     #[serde(other)]
     Unknown,
 }
+/// The action performed on the entity (leave empty if just found)
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum AiConversationEntityCardWidgetArgsAction {
+    #[serde(rename = "created")]
+    Created,
+    #[serde(rename = "updated")]
+    Updated,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
+/// `Internal` The entity type
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum AiConversationEntityCardWidgetArgsType {
+    Issue,
+    Project,
+    Initiative,
+    InitiativeUpdate,
+    ProjectUpdate,
+    WorkflowDefinition,
+    Team,
+    Template,
+    Customer,
+    CustomerNeed,
+    Document,
+    CustomView,
+    Dashboard,
+    PullRequest,
+    Release,
+    ReleasePipeline,
+    AiPrompt,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
+/// The action performed on the entities (leave empty if just found)
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum AiConversationEntityListWidgetArgsAction {
+    #[serde(rename = "created")]
+    Created,
+    #[serde(rename = "updated")]
+    Updated,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
+/// `Internal` The entity type
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum AiConversationEntityListWidgetArgsEntitiesType {
+    Issue,
+    Project,
+    Initiative,
+    InitiativeUpdate,
+    ProjectUpdate,
+    WorkflowDefinition,
+    Team,
+    Template,
+    Customer,
+    CustomerNeed,
+    Document,
+    CustomView,
+    Dashboard,
+    PullRequest,
+    Release,
+    ReleasePipeline,
+    AiPrompt,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
+/// The initial source of an AI conversation.
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum AiConversationInitialSource {
+    #[serde(rename = "slack")]
+    Slack,
+    #[serde(rename = "microsoftTeams")]
+    MicrosoftTeams,
+    #[serde(rename = "mcp")]
+    Mcp,
+    #[serde(rename = "directChat")]
+    DirectChat,
+    #[serde(rename = "comment")]
+    Comment,
+    #[serde(rename = "pullRequestComment")]
+    PullRequestComment,
+    #[serde(rename = "workflow")]
+    Workflow,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
+/// The phase during which a conversation part was generated.
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum AiConversationPartPhase {
+    #[serde(rename = "commentary")]
+    Commentary,
+    #[serde(rename = "answer")]
+    Answer,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
+/// The type of a part in an AI conversation.
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum AiConversationPartType {
+    #[serde(rename = "prompt")]
+    Prompt,
+    #[serde(rename = "toolCall")]
+    ToolCall,
+    #[serde(rename = "reasoning")]
+    Reasoning,
+    #[serde(rename = "text")]
+    Text,
+    #[serde(rename = "widget")]
+    Widget,
+    #[serde(rename = "widgetPlaceholder")]
+    WidgetPlaceholder,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum AiConversationQueryUpdatesToolCallArgsUpdateType {
+    ProjectUpdate,
+    InitiativeUpdate,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum AiConversationQueryViewToolCallArgsMode {
+    #[serde(rename = "list")]
+    List,
+    #[serde(rename = "insight")]
+    Insight,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
+/// The status of an AI conversation.
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum AiConversationStatus {
+    #[serde(rename = "active")]
+    Active,
+    #[serde(rename = "complete")]
+    Complete,
+    #[serde(rename = "awaitingInput")]
+    AwaitingInput,
+    #[serde(rename = "error")]
+    Error,
+    #[serde(rename = "pending")]
+    Pending,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
+/// The name of a tool that was called in an AI conversation.
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum AiConversationTool {
+    SearchEntities,
+    RetrieveEntities,
+    QueryView,
+    QueryActivity,
+    QueryUpdates,
+    SuggestValues,
+    CreateEntity,
+    UpdateEntity,
+    DeleteEntity,
+    RestoreEntity,
+    Research,
+    CodeIntelligence,
+    GetPullRequestDiff,
+    GetPullRequestFile,
+    HandoffToCodingSession,
+    TranscribeVideo,
+    TranscribeMedia,
+    SearchDocumentation,
+    WebSearch,
+    GetSlackConversationHistory,
+    GetMicrosoftTeamsConversationHistory,
+    NavigateToPage,
+    InvokeMcpTool,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
+/// The name of a widget in an AI conversation.
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum AiConversationWidgetName {
+    EntityCard,
+    EntityList,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
+/// `Internal` The status of a prompt workflow.
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum AiPromptProgressStatus {
+    #[serde(rename = "created")]
+    Created,
+    #[serde(rename = "inProgress")]
+    InProgress,
+    #[serde(rename = "finished")]
+    Finished,
+    #[serde(rename = "failed")]
+    Failed,
+    #[serde(rename = "canceled")]
+    Canceled,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
+/// The type of AI prompt workflow.
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum AiPromptType {
+    #[serde(rename = "productIntelligence")]
+    ProductIntelligence,
+    #[serde(rename = "internalResearch")]
+    InternalResearch,
+    #[serde(rename = "projectUpdates")]
+    ProjectUpdates,
+    #[serde(rename = "initiativeUpdates")]
+    InitiativeUpdates,
+    #[serde(rename = "agentGuidance")]
+    AgentGuidance,
+    #[serde(rename = "codeIntelligence")]
+    CodeIntelligence,
+    #[serde(rename = "aiConversation")]
+    AiConversation,
+    #[serde(rename = "slackIssueIntake")]
+    SlackIssueIntake,
+    #[serde(rename = "intercomIssueIntake")]
+    IntercomIssueIntake,
+    #[serde(rename = "gongIssueIntake")]
+    GongIssueIntake,
+    #[serde(rename = "zendeskIssueIntake")]
+    ZendeskIssueIntake,
+    #[serde(rename = "microsoftTeamsIssueIntake")]
+    MicrosoftTeamsIssueIntake,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
 #[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub enum AuthenticationSessionType {
     #[serde(rename = "web")]
@@ -220,7 +463,7 @@ pub enum FrequencyResolutionType {
     #[serde(other)]
     Unknown,
 }
-/// The various states of a pull/merge request.
+/// The Git events that can trigger an automation rule. Each value corresponds to a pull/merge request lifecycle event (e.g., branch created, PR opened for review, PR merged).
 #[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub enum GitAutomationStates {
     #[serde(rename = "draft")]
@@ -363,6 +606,8 @@ pub enum IntegrationService {
     Slack,
     #[serde(rename = "slackAsks")]
     SlackAsks,
+    #[serde(rename = "asksWeb")]
+    AsksWeb,
     #[serde(rename = "slackCustomViewNotifications")]
     SlackCustomViewNotifications,
     #[serde(rename = "slackOrgProjectUpdatesPost")]
@@ -391,6 +636,10 @@ pub enum IntegrationService {
     McpServer,
     #[serde(rename = "microsoftTeams")]
     MicrosoftTeams,
+    #[serde(rename = "microsoftPersonal")]
+    MicrosoftPersonal,
+    #[serde(rename = "microsoftTeamsProjectPost")]
+    MicrosoftTeamsProjectPost,
     /// Catch-all for unknown/new variants added by Linear.
     #[serde(other)]
     Unknown,
@@ -410,6 +659,35 @@ pub enum IssueRelationType {
     #[serde(other)]
     Unknown,
 }
+/// Issue update fields that are disallowed for users with only shared access.
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum IssueSharedAccessDisallowedField {
+    #[serde(rename = "projectId")]
+    ProjectId,
+    #[serde(rename = "teamId")]
+    TeamId,
+    #[serde(rename = "cycleId")]
+    CycleId,
+    #[serde(rename = "projectMilestoneId")]
+    ProjectMilestoneId,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
+/// Policy controlling whether and by whom issues in a team can be shared with non-team-members.
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum IssueSharingPolicy {
+    #[serde(rename = "disabled")]
+    Disabled,
+    #[serde(rename = "adminsOnly")]
+    AdminsOnly,
+    #[serde(rename = "allMembers")]
+    AllMembers,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
+/// The state of an issue suggestion, indicating whether it is active, accepted, or dismissed.
 #[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub enum IssueSuggestionState {
     #[serde(rename = "active")]
@@ -424,6 +702,7 @@ pub enum IssueSuggestionState {
     #[serde(other)]
     Unknown,
 }
+/// The type of an issue suggestion, indicating what kind of entity is being suggested (e.g., similar issue, assignee, label, team, project).
 #[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub enum IssueSuggestionType {
     #[serde(rename = "team")]
@@ -665,6 +944,21 @@ pub enum ProjectUpdateReminderFrequency {
     #[serde(other)]
     Unknown,
 }
+/// `ALPHA` How a pull request check should be opened in the client.
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
+pub enum PullRequestCheckPresentation {
+    #[serde(rename = "jobLogs")]
+    JobLogs,
+    #[serde(rename = "runLogs")]
+    RunLogs,
+    #[serde(rename = "markdown")]
+    Markdown,
+    #[serde(rename = "externalOnly")]
+    ExternalOnly,
+    /// Catch-all for unknown/new variants added by Linear.
+    #[serde(other)]
+    Unknown,
+}
 /// The method used to merge a pull request.
 #[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub enum PullRequestMergeMethod {
@@ -741,7 +1035,7 @@ pub enum ReleaseChannel {
     #[serde(other)]
     Unknown,
 }
-/// A type of release pipeline.
+/// The type of a release pipeline, which determines how releases are created and managed. Continuous pipelines create a new completed release for each sync. Scheduled pipelines accumulate issues into a started release that is explicitly completed.
 #[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub enum ReleasePipelineType {
     #[serde(rename = "continuous")]
@@ -752,7 +1046,7 @@ pub enum ReleasePipelineType {
     #[serde(other)]
     Unknown,
 }
-/// A type of release stage.
+/// The type of a release stage, which determines the release's lifecycle state. Types include planned, started, completed, and canceled. Each pipeline must have at least one stage of each type, though only started stages may have multiple instances.
 #[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub enum ReleaseStageType {
     #[serde(rename = "planned")]
@@ -767,6 +1061,7 @@ pub enum ReleaseStageType {
     #[serde(other)]
     Unknown,
 }
+/// Which day count to use for SLA calculations.
 #[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub enum SLADayCountType {
     #[serde(rename = "all")]
@@ -884,6 +1179,8 @@ pub enum TriageRuleErrorType {
     Default,
     #[serde(rename = "labelGroupConflict")]
     LabelGroupConflict,
+    #[serde(rename = "codingAgentQuotaExceeded")]
+    CodingAgentQuotaExceeded,
     /// Catch-all for unknown/new variants added by Linear.
     #[serde(other)]
     Unknown,
@@ -965,6 +1262,10 @@ pub enum UserFlagType {
     TryTriageDismissed,
     #[serde(rename = "tryGithubDismissed")]
     TryGithubDismissed,
+    #[serde(rename = "tryCursorDismissed")]
+    TryCursorDismissed,
+    #[serde(rename = "tryCodexDismissed")]
+    TryCodexDismissed,
     #[serde(rename = "rewindBannerDismissed")]
     RewindBannerDismissed,
     #[serde(rename = "helpIslandFeatureInsightsDismissed")]
@@ -991,8 +1292,16 @@ pub enum UserFlagType {
     CommandMenuClearShortcutTip,
     #[serde(rename = "slackBotWelcomeMessageShown")]
     SlackBotWelcomeMessageShown,
+    #[serde(rename = "teamsBotWelcomeMessageShown")]
+    TeamsBotWelcomeMessageShown,
     #[serde(rename = "slackAgentPromoFromCreateNewIssueShown")]
     SlackAgentPromoFromCreateNewIssueShown,
+    #[serde(rename = "agentExamplesDismissed")]
+    AgentExamplesDismissed,
+    #[serde(rename = "agentHomePageNotice")]
+    AgentHomePageNotice,
+    #[serde(rename = "agentHomeHeadlineSeen")]
+    AgentHomeHeadlineSeen,
     #[serde(rename = "all")]
     All,
     /// Catch-all for unknown/new variants added by Linear.
@@ -1014,7 +1323,7 @@ pub enum UserFlagUpdateOperation {
     #[serde(other)]
     Unknown,
 }
-/// The different permission roles available to users on an organization.
+/// The different permission roles available to users in a workspace.
 #[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub enum UserRoleType {
     #[serde(rename = "owner")]
@@ -1074,7 +1383,7 @@ pub enum UserSettingsThemePreset {
     #[serde(other)]
     Unknown,
 }
-/// The type of view preferences (either user or organization level preferences).
+/// The type of view preferences (either user or workspace level preferences).
 #[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub enum ViewPreferencesType {
     #[serde(rename = "organization")]
@@ -1114,6 +1423,8 @@ pub enum ViewType {
     Release,
     #[serde(rename = "continuousPipelineReleases")]
     ContinuousPipelineReleases,
+    #[serde(rename = "scheduledPipelineReleases")]
+    ScheduledPipelineReleases,
     #[serde(rename = "project")]
     Project,
     #[serde(rename = "projectDocuments")]
@@ -1186,6 +1497,8 @@ pub enum ViewType {
     CreatedReviews,
     #[serde(rename = "agents")]
     Agents,
+    #[serde(rename = "focus")]
+    Focus,
     #[serde(rename = "feedAll")]
     FeedAll,
     #[serde(rename = "feedCreated")]
@@ -1234,6 +1547,8 @@ pub enum WorkflowTriggerType {
     Issue,
     #[serde(rename = "project")]
     Project,
+    #[serde(rename = "release")]
+    Release,
     /// Catch-all for unknown/new variants added by Linear.
     #[serde(other)]
     Unknown,
@@ -1242,12 +1557,16 @@ pub enum WorkflowTriggerType {
 pub enum WorkflowType {
     #[serde(rename = "sla")]
     Sla,
-    #[serde(rename = "custom")]
-    Custom,
+    #[serde(rename = "automation")]
+    Automation,
     #[serde(rename = "viewSubscription")]
     ViewSubscription,
     #[serde(rename = "triage")]
     Triage,
+    #[serde(rename = "triageAutomation")]
+    TriageAutomation,
+    #[serde(rename = "release")]
+    Release,
     /// Catch-all for unknown/new variants added by Linear.
     #[serde(other)]
     Unknown,
diff --git a/crates/lineark-sdk/src/generated/inputs.rs b/crates/lineark-sdk/src/generated/inputs.rs
index 2e9113e..9c67d02 100644
--- a/crates/lineark-sdk/src/generated/inputs.rs
+++ b/crates/lineark-sdk/src/generated/inputs.rs
@@ -2,9300 +2,9760 @@
 //!
 //! Generated by lineark-codegen — do not edit.
 use super::enums::*;
+use crate::field_update::MaybeUndefined;
 use serde::{Deserialize, Serialize};
 /// Activity collection filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ActivityCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Filters that the activity's user must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub user: MaybeUndefined<Box<UserFilter>>,
     /// Compound filters, all of which need to be matched by the activity.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ActivityCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ActivityCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the activity.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ActivityCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ActivityCollectionFilter>>,
     /// Filters that needs to be matched by some activities.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<ActivityFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<Box<ActivityFilter>>,
     /// Filters that needs to be matched by all activities.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<ActivityFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<Box<ActivityFilter>>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
 }
 /// Activity filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ActivityFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Filters that the activity's user must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub user: MaybeUndefined<Box<UserFilter>>,
     /// Compound filters, all of which need to be matched by the activity.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ActivityFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ActivityFilter>>,
     /// Compound filters, one of which need to be matched by the activity.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ActivityFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ActivityFilter>>,
 }
+/// Input for creating an agent activity.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AgentActivityCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The agent session this activity belongs to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub agent_session_id: Option<String>,
+    pub agent_session_id: String,
     /// An optional modifier that provides additional instructions on how the activity should be interpreted.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub signal: Option<AgentActivitySignal>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub signal: MaybeUndefined<AgentActivitySignal>,
     /// Metadata about this agent activity's signal.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub signal_metadata: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub signal_metadata: MaybeUndefined<serde_json::Value>,
     /// `Internal` Metadata about user-provided contextual information for this agent activity.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub contextual_metadata: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub contextual_metadata: MaybeUndefined<serde_json::Value>,
     /// The content payload of the agent activity. This object is not strictly typed.
     /// See <https://linear.app/developers/agent-interaction#activity-content-payload> for typing details.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub content: Option<serde_json::Value>,
+    pub content: serde_json::Value,
     /// Whether the activity is ephemeral, and should disappear after the next activity. Defaults to false.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ephemeral: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ephemeral: MaybeUndefined<bool>,
 }
 /// `Internal` Input for creating prompt-type agent activities (created by users).
-#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AgentActivityCreatePromptInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The agent session this activity belongs to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub agent_session_id: Option<String>,
+    pub agent_session_id: String,
     /// An optional modifier that provides additional instructions on how the activity should be interpreted.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub signal: Option<AgentActivitySignal>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub signal: MaybeUndefined<AgentActivitySignal>,
     /// Metadata about this agent activity's signal.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub signal_metadata: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub signal_metadata: MaybeUndefined<serde_json::Value>,
     /// `Internal` Metadata about user-provided contextual information for this agent activity.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub contextual_metadata: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub contextual_metadata: MaybeUndefined<serde_json::Value>,
     /// The content payload of the prompt agent activity.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub content: Option<Box<AgentActivityPromptCreateInputContent>>,
+    pub content: AgentActivityPromptCreateInputContent,
     /// The comment that contains the content of this activity.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub source_comment_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub source_comment_id: MaybeUndefined<String>,
 }
 /// Agent activity filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AgentActivityFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the agent session ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub agent_session_id: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub agent_session_id: MaybeUndefined<StringComparator>,
     /// Comparator for the agent activity's content type.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<StringComparator>,
     /// Filters that the source comment must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub source_comment: Option<Box<NullableCommentFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub source_comment: MaybeUndefined<NullableCommentFilter>,
     /// Compound filters, all of which need to be matched by the agent activity.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<AgentActivityFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<AgentActivityFilter>>,
     /// Compound filters, one of which need to be matched by the agent activity.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<AgentActivityFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<AgentActivityFilter>>,
 }
 /// `Internal` Input for creating prompt-type agent activities (created by users).
-#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AgentActivityPromptCreateInputContent {
     /// The type of activity.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<AgentActivityType>,
+    pub r#type: AgentActivityType,
     /// A message requesting additional information or action from user in markdown format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body: MaybeUndefined<String>,
     /// `Internal` The prompt content as a ProseMirror document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body_data: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body_data: MaybeUndefined<serde_json::Value>,
 }
+/// `Internal` Input for creating an agent session on behalf of the current user.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AgentSessionCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The issue that this session will be associated with. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_id: MaybeUndefined<String>,
     /// The app user (agent) to create a session for.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub app_user_id: Option<String>,
+    pub app_user_id: String,
     /// `Internal` Serialized JSON representing the page contexts this session is related to. Used for direct chat sessions to provide context about the current page (e.g., Issue, Project).
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub context: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub context: MaybeUndefined<serde_json::Value>,
 }
+/// Input for creating an agent session on a root comment.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AgentSessionCreateOnComment {
     /// The root comment that this session will be associated with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub comment_id: Option<String>,
+    pub comment_id: String,
     /// The URL of an external agent-hosted page associated with this session.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_link: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_link: MaybeUndefined<String>,
     /// URLs of external resources associated with this session.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_urls: Option<Vec<Box<AgentSessionExternalUrlInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_urls: MaybeUndefined<Vec<AgentSessionExternalUrlInput>>,
 }
+/// Input for creating an agent session on an issue.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AgentSessionCreateOnIssue {
     /// The issue that this session will be associated with. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_id: Option<String>,
+    pub issue_id: String,
     /// The URL of an external agent-hosted page associated with this session.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_link: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_link: MaybeUndefined<String>,
     /// URLs of external resources associated with this session.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_urls: Option<Vec<Box<AgentSessionExternalUrlInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_urls: MaybeUndefined<Vec<AgentSessionExternalUrlInput>>,
 }
 /// Input for an external URL associated with an agent session.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AgentSessionExternalUrlInput {
     /// The URL of the external resource.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub url: Option<String>,
+    pub url: String,
     /// Label for the URL.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label: Option<String>,
+    pub label: String,
 }
+/// Input for updating the external URLs of an agent session.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AgentSessionUpdateExternalUrlInput {
     /// The URL of an external agent-hosted page associated with this session.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_link: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_link: MaybeUndefined<String>,
     /// URLs of external resources associated with this session. Replaces existing URLs.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_urls: Option<Vec<Box<AgentSessionExternalUrlInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_urls: MaybeUndefined<Vec<AgentSessionExternalUrlInput>>,
     /// URLs of external resources to be added to this session.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub added_external_urls: Option<Vec<Box<AgentSessionExternalUrlInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub added_external_urls: MaybeUndefined<Vec<AgentSessionExternalUrlInput>>,
     /// URLs to be removed from this session.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub removed_external_urls: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub removed_external_urls: MaybeUndefined<Vec<String>>,
 }
+/// Input for updating an agent session.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AgentSessionUpdateInput {
     /// The URL of an external agent-hosted page associated with this session. Only updatable by the OAuth application that owns the session.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_link: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_link: MaybeUndefined<String>,
     /// URLs of external resources associated with this session. Replaces existing URLs. Only updatable by the OAuth application that owns the session. If supplied, addedExternalUrls and removedExternalUrls are ignored.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_urls: Option<Vec<Box<AgentSessionExternalUrlInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_urls: MaybeUndefined<Vec<AgentSessionExternalUrlInput>>,
     /// URLs of external resources to be added to this session. Only updatable by the OAuth application that owns the session.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub added_external_urls: Option<Vec<Box<AgentSessionExternalUrlInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub added_external_urls: MaybeUndefined<Vec<AgentSessionExternalUrlInput>>,
     /// URLs to be removed from this session. Only updatable by the OAuth application that owns the session.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub removed_external_urls: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub removed_external_urls: MaybeUndefined<Vec<String>>,
     /// A dynamically updated list of the agent's execution strategy. Only updatable by the OAuth application that owns the session.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub plan: Option<serde_json::Value>,
-    /// `Internal` The time the agent session was dismissed. Only updatable by internal clients.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub dismissed_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub plan: MaybeUndefined<serde_json::Value>,
+    /// `Internal` The time at which the agent session was dismissed. Set to null to un-dismiss. Only updatable by internal clients.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub dismissed_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
     /// `Internal` User-specific state for the agent session. Only updatable by internal clients.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user_state: Option<Vec<Box<AgentSessionUserStateInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub user_state: MaybeUndefined<Vec<AgentSessionUserStateInput>>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AgentSessionUserStateInput {
     /// The ID of the user this state belongs to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user_id: Option<String>,
+    pub user_id: String,
     /// The time at which the user most recently viewed the session.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub last_read_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub last_read_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
 }
+/// `Internal` AI prompt progress filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
-pub struct AirbyteConfigurationInput {
-    /// Linear export API key.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub api_key: Option<String>,
+pub struct AiPromptProgressFilter {
+    /// Comparator for the identifier.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
+    /// Comparator for the created at date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
+    /// Comparator for the updated at date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
+    /// `Internal` Comparator for the AI prompt workflow type.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<AiPromptTypeComparator>,
+    /// `Internal` Comparator for the AI prompt workflow status.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status: MaybeUndefined<AiPromptProgressStatusComparator>,
+    /// `Internal` Compound filters, all of which need to be matched by the AI prompt progress.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<AiPromptProgressFilter>>,
+    /// `Internal` Compound filters, one of which need to be matched by the AI prompt progress.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<AiPromptProgressFilter>>,
+}
+/// `Internal` Comparator for the AI prompt workflow status.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct AiPromptProgressStatusComparator {
+    /// Equals constraint.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<AiPromptProgressStatus>,
+    /// Not-equals constraint.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<AiPromptProgressStatus>,
+    /// In-array constraint.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<AiPromptProgressStatus>>,
+    /// Not-in-array constraint.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<AiPromptProgressStatus>>,
+    /// Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
 }
-/// Customer approximate need count sorting options.
+/// `Internal` Filter for AI prompt progress subscription events.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
-pub struct ApproximateNeedCountSort {
-    /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
-    /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+pub struct AiPromptProgressSubscriptionFilter {
+    /// `Internal` Filter by issue ID.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_id: MaybeUndefined<IDComparator>,
+    /// `Internal` Filter by comment ID.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub comment_id: MaybeUndefined<IDComparator>,
+    /// `Internal` Filter by pull request comment ID.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub pull_request_comment_id: MaybeUndefined<IDComparator>,
+    /// `Internal` Filter by prompt workflow type.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<AiPromptTypeComparator>,
+    /// `Internal` Filter by prompt workflow status.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status: MaybeUndefined<AiPromptProgressStatusComparator>,
 }
+/// `Internal` Comparator for the AI prompt workflow type.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
-pub struct AsksWebPageCreateInput {
-    /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
-    /// The identifier of the Asks web settings this page belongs to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub asks_web_settings_id: Option<String>,
-    /// The title of the page.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub title: Option<String>,
-    /// The description of the page.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
-    /// The auto-reply message for issue created. If not set, the default reply will be used.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_created_auto_reply: Option<String>,
-    /// Whether the auto-reply for issue created is enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_created_auto_reply_enabled: Option<bool>,
-    /// The auto-reply message for issue completed. If not set, the default reply will be used.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_completed_auto_reply: Option<String>,
-    /// Whether the auto-reply for issue completed is enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_completed_auto_reply_enabled: Option<bool>,
-    /// The auto-reply message for issue canceled. If not set, the default reply will be used.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_canceled_auto_reply: Option<String>,
-    /// Whether the auto-reply for issue canceled is enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_canceled_auto_reply_enabled: Option<bool>,
-}
-#[derive(Debug, Clone, Default, Serialize, Deserialize)]
-#[serde(rename_all = "camelCase")]
-pub struct AsksWebPageUpdateInput {
-    /// The title of the page.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub title: Option<String>,
-    /// The description of the page.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
-    /// The auto-reply message for issue created. If not set, the default reply will be used.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_created_auto_reply: Option<String>,
-    /// Whether the auto-reply for issue created is enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_created_auto_reply_enabled: Option<bool>,
-    /// The auto-reply message for issue completed. If not set, the default reply will be used.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_completed_auto_reply: Option<String>,
-    /// Whether the auto-reply for issue completed is enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_completed_auto_reply_enabled: Option<bool>,
-    /// The auto-reply message for issue canceled. If not set, the default reply will be used.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_canceled_auto_reply: Option<String>,
-    /// Whether the auto-reply for issue canceled is enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_canceled_auto_reply_enabled: Option<bool>,
-}
-#[derive(Debug, Clone, Default, Serialize, Deserialize)]
-#[serde(rename_all = "camelCase")]
-pub struct AsksWebSettingsCreateInput {
-    /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
-    /// The custom domain for the Asks web form. If null, the default Linear-hosted domain will be used.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub domain: Option<String>,
+pub struct AiPromptTypeComparator {
+    /// Equals constraint.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<AiPromptType>,
+    /// Not-equals constraint.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<AiPromptType>,
+    /// In-array constraint.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<AiPromptType>>,
+    /// Not-in-array constraint.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<AiPromptType>>,
+    /// Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
-pub struct AsksWebSettingsEmailIntakeAddressInput {
-    /// The sender name for outgoing emails.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sender_name: Option<String>,
-    /// The email address for forwarding.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub forwarding_email_address: Option<String>,
+pub struct AirbyteConfigurationInput {
+    /// Linear export API key.
+    pub api_key: String,
 }
+/// Customer approximate need count sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
-pub struct AsksWebSettingsUpdateInput {
-    /// The custom domain for the Asks web form. If null, the default Linear-hosted domain will be used.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub domain: Option<String>,
+pub struct ApproximateNeedCountSort {
+    /// Whether nulls should be sorted first or last
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
+    /// The order for the individual sort
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Issue assignee sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AssigneeSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Attachment collection filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AttachmentCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the title.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub title: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub title: MaybeUndefined<StringComparator>,
     /// Comparator for the subtitle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subtitle: Option<Box<NullableStringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subtitle: MaybeUndefined<NullableStringComparator>,
     /// Comparator for the url.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub url: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub url: MaybeUndefined<StringComparator>,
     /// Filters that the attachments creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<NullableUserFilter>>,
     /// Comparator for the source type.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub source_type: Option<Box<SourceTypeComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub source_type: MaybeUndefined<SourceTypeComparator>,
     /// Compound filters, all of which need to be matched by the attachment.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<AttachmentCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<AttachmentCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the attachment.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<AttachmentCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<AttachmentCollectionFilter>>,
     /// Filters that needs to be matched by some attachments.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<AttachmentFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<Box<AttachmentFilter>>,
     /// Filters that needs to be matched by all attachments.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<AttachmentFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<Box<AttachmentFilter>>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
 }
+/// Input for creating a new issue attachment.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AttachmentCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The attachment title.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub title: Option<String>,
+    pub title: String,
     /// The attachment subtitle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subtitle: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subtitle: MaybeUndefined<String>,
     /// Attachment location which is also used as an unique identifier for the attachment. If another attachment is created with the same `url` value, existing record is updated instead.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub url: Option<String>,
+    pub url: String,
     /// The issue to associate the attachment with. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_id: Option<String>,
+    pub issue_id: String,
     /// An icon url to display with the attachment. Should be of jpg or png format. Maximum of 1MB in size. Dimensions should be 20x20px for optimal display quality.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub icon_url: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub icon_url: MaybeUndefined<String>,
     /// Attachment metadata object with string and number values.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub metadata: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub metadata: MaybeUndefined<serde_json::Value>,
     /// Indicates if attachments for the same source application should be grouped in the Linear UI.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub group_by_source: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub group_by_source: MaybeUndefined<bool>,
     /// Create a linked comment with markdown body.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub comment_body: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub comment_body: MaybeUndefined<String>,
     /// `Internal` Create a linked comment with Prosemirror body. Please use `commentBody` instead.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub comment_body_data: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub comment_body_data: MaybeUndefined<serde_json::Value>,
     /// Create attachment as a user with the provided name. This option is only available to OAuth applications creating attachments in `actor=application` mode.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub create_as_user: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub create_as_user: MaybeUndefined<String>,
 }
 /// Attachment filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AttachmentFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the title.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub title: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub title: MaybeUndefined<StringComparator>,
     /// Comparator for the subtitle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subtitle: Option<Box<NullableStringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subtitle: MaybeUndefined<NullableStringComparator>,
     /// Comparator for the url.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub url: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub url: MaybeUndefined<StringComparator>,
     /// Filters that the attachments creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<NullableUserFilter>>,
     /// Comparator for the source type.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub source_type: Option<Box<SourceTypeComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub source_type: MaybeUndefined<SourceTypeComparator>,
     /// Compound filters, all of which need to be matched by the attachment.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<AttachmentFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<AttachmentFilter>>,
     /// Compound filters, one of which need to be matched by the attachment.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<AttachmentFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<AttachmentFilter>>,
 }
+/// Input for updating an existing issue attachment.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AttachmentUpdateInput {
     /// The attachment title.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub title: Option<String>,
+    pub title: String,
     /// The attachment subtitle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subtitle: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subtitle: MaybeUndefined<String>,
     /// Attachment metadata object with string and number values.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub metadata: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub metadata: MaybeUndefined<serde_json::Value>,
     /// An icon url to display with the attachment. Should be of jpg or png format. Maximum of 1MB in size. Dimensions should be 20x20px for optimal display quality.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub icon_url: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub icon_url: MaybeUndefined<String>,
 }
 /// Audit entry filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct AuditEntryFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the type.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<StringComparator>,
     /// Comparator for the IP address.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ip: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ip: MaybeUndefined<StringComparator>,
     /// Comparator for the country code.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub country_code: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub country_code: MaybeUndefined<StringComparator>,
     /// Filters that the audit entry actor must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub actor: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub actor: MaybeUndefined<NullableUserFilter>,
     /// Compound filters, all of which need to be matched by the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<AuditEntryFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<AuditEntryFilter>>,
     /// Compound filters, one of which need to be matched by the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<AuditEntryFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<AuditEntryFilter>>,
 }
 /// Comparator for booleans.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct BooleanComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<bool>,
     /// Not equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<bool>,
 }
+/// A candidate code repository to consider when generating repository suggestions for an issue.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CandidateRepository {
     /// The full name of the repository in owner/name format (e.g., 'acme/backend').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub repository_full_name: Option<String>,
+    pub repository_full_name: String,
     /// Hostname of the Git service (e.g., 'github.com', 'github.company.com').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub hostname: Option<String>,
+    pub hostname: String,
 }
 /// Comment filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CommentCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the comment's body.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body: MaybeUndefined<StringComparator>,
     /// Filters that the comment's creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub user: MaybeUndefined<Box<UserFilter>>,
     /// Filters that the comment's issue must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue: Option<Box<NullableIssueFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue: MaybeUndefined<Box<NullableIssueFilter>>,
     /// Filters that the comment's project update must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_update: Option<Box<NullableProjectUpdateFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_update: MaybeUndefined<Box<NullableProjectUpdateFilter>>,
     /// Filters that the comment parent must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent: Option<Box<NullableCommentFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent: MaybeUndefined<Box<NullableCommentFilter>>,
     /// Filters that the comment's document content must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub document_content: Option<Box<NullableDocumentContentFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub document_content: MaybeUndefined<Box<NullableDocumentContentFilter>>,
+    /// `Internal` Filters that the comment's project must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<Box<NullableProjectFilter>>,
+    /// `Internal` Filters that the comment's initiative must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative: MaybeUndefined<Box<NullableInitiativeFilter>>,
     /// Filters that the comment's reactions must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub reactions: Option<Box<ReactionCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reactions: MaybeUndefined<ReactionCollectionFilter>,
     /// Filters that the comment's customer needs must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub needs: Option<Box<CustomerNeedCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub needs: MaybeUndefined<Box<CustomerNeedCollectionFilter>>,
     /// Compound filters, all of which need to be matched by the comment.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<CommentCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<CommentCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the comment.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<CommentCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<CommentCollectionFilter>>,
     /// Filters that needs to be matched by some comments.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<CommentFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<Box<CommentFilter>>,
     /// Filters that needs to be matched by all comments.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<CommentFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<Box<CommentFilter>>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
 }
+/// Input for creating a new comment.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CommentCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The comment content in markdown format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body: MaybeUndefined<String>,
     /// `Internal` The comment content as a Prosemirror document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body_data: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body_data: MaybeUndefined<serde_json::Value>,
     /// The issue to associate the comment with. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_id: MaybeUndefined<String>,
     /// The project update to associate the comment with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_update_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_update_id: MaybeUndefined<String>,
     /// The initiative update to associate the comment with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_update_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_update_id: MaybeUndefined<String>,
     /// The post to associate the comment with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub post_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub post_id: MaybeUndefined<String>,
     /// The document content to associate the comment with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub document_content_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub document_content_id: MaybeUndefined<String>,
+    /// `Internal` The project to associate the comment with.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
+    /// `Internal` The initiative to associate the comment with.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_id: MaybeUndefined<String>,
     /// The parent comment under which to nest a current comment.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent_id: MaybeUndefined<String>,
     /// Create comment as a user with the provided name. This option is only available to OAuth applications creating comments in `actor=app` mode.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub create_as_user: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub create_as_user: MaybeUndefined<String>,
     /// Provide an external user avatar URL. Can only be used in conjunction with the `createAsUser` options. This option is only available to OAuth applications creating comments in `actor=app` mode.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub display_icon_url: Option<String>,
-    /// The date when the comment was created (e.g. if importing from another system). Must be a date in the past. If none is provided, the backend will generate the time as now.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub display_icon_url: MaybeUndefined<String>,
+    /// The time at which the comment was created (e.g. if importing from another system). Must be a time in the past. If none is provided, the backend will generate the time as now.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
     /// Flag to prevent auto subscription to the issue the comment is created on.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub do_not_subscribe_to_issue: Option<bool>,
-    /// Flag to indicate this comment should be created on the issue's synced Slack comment thread. If no synced Slack comment thread exists, the mutation will fail.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub create_on_synced_slack_thread: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub do_not_subscribe_to_issue: MaybeUndefined<bool>,
+    /// Flag to indicate this comment should be created on the issue's synced Slack comment thread. If no synced Slack comment thread exists, the mutation will fail. If there are multiple synced Slack threads on the issue, the oldest one will be targeted.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub create_on_synced_slack_thread: MaybeUndefined<bool>,
     /// The text that this comment references. Only defined for inline comments.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub quoted_text: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub quoted_text: MaybeUndefined<String>,
     /// `INTERNAL` The identifiers of the users subscribing to this comment thread.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subscriber_ids: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subscriber_ids: MaybeUndefined<Vec<String>>,
 }
 /// Comment filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CommentFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the comment's body.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body: MaybeUndefined<StringComparator>,
     /// Filters that the comment's creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub user: MaybeUndefined<Box<UserFilter>>,
     /// Filters that the comment's issue must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue: Option<Box<NullableIssueFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue: MaybeUndefined<Box<NullableIssueFilter>>,
     /// Filters that the comment's project update must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_update: Option<Box<NullableProjectUpdateFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_update: MaybeUndefined<Box<NullableProjectUpdateFilter>>,
     /// Filters that the comment parent must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent: Option<Box<NullableCommentFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent: MaybeUndefined<Box<NullableCommentFilter>>,
     /// Filters that the comment's document content must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub document_content: Option<Box<NullableDocumentContentFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub document_content: MaybeUndefined<Box<NullableDocumentContentFilter>>,
+    /// `Internal` Filters that the comment's project must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<Box<NullableProjectFilter>>,
+    /// `Internal` Filters that the comment's initiative must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative: MaybeUndefined<Box<NullableInitiativeFilter>>,
     /// Filters that the comment's reactions must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub reactions: Option<Box<ReactionCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reactions: MaybeUndefined<ReactionCollectionFilter>,
     /// Filters that the comment's customer needs must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub needs: Option<Box<CustomerNeedCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub needs: MaybeUndefined<Box<CustomerNeedCollectionFilter>>,
     /// Compound filters, all of which need to be matched by the comment.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<CommentFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<CommentFilter>>,
     /// Compound filters, one of which need to be matched by the comment.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<CommentFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<CommentFilter>>,
 }
+/// Input for updating an existing comment.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CommentUpdateInput {
     /// The comment content.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body: MaybeUndefined<String>,
     /// `Internal` The comment content as a Prosemirror document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body_data: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body_data: MaybeUndefined<serde_json::Value>,
     /// `INTERNAL` The user who resolved this thread.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub resolving_user_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub resolving_user_id: MaybeUndefined<String>,
     /// `INTERNAL` The child comment that resolves this thread.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub resolving_comment_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub resolving_comment_id: MaybeUndefined<String>,
     /// The text that this comment references. Only defined for inline comments.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub quoted_text: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub quoted_text: MaybeUndefined<String>,
     /// `INTERNAL` The identifiers of the users subscribing to this comment.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subscriber_ids: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subscriber_ids: MaybeUndefined<Vec<String>>,
     /// `INTERNAL` Flag to prevent auto subscription to the issue the comment is updated on.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub do_not_subscribe_to_issue: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub do_not_subscribe_to_issue: MaybeUndefined<bool>,
 }
 /// Issue completion date sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CompletedAtSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
+/// Input for submitting a support contact message from an authenticated user.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ContactCreateInput {
-    /// The type of support contact.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<String>,
-    /// The message the user sent.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub message: Option<String>,
-    /// User's operating system.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub operating_system: Option<String>,
-    /// User's browser information.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub browser: Option<String>,
-    /// User's device information.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub device: Option<String>,
-    /// User's Linear client information.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub client_version: Option<String>,
-    /// How disappointed the user would be if they could no longer use Linear.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub disappointment_rating: Option<i64>,
-}
-/// `INTERNAL` Input for sending a message to the Linear Sales team.
+    /// The type of support contact (e.g., bug report, feature request, general feedback).
+    pub r#type: String,
+    /// The feedback or support message submitted by the user.
+    pub message: String,
+    /// The user's operating system name and version (e.g., 'macOS 14.0').
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub operating_system: MaybeUndefined<String>,
+    /// The user's browser name and version (e.g., 'Chrome 120').
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub browser: MaybeUndefined<String>,
+    /// The user's device type or model information.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub device: MaybeUndefined<String>,
+    /// The version of the Linear client application the user is running.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub client_version: MaybeUndefined<String>,
+    /// How disappointed the user would be if they could no longer use Linear. Scale: 0 = not disappointed, 1 = somewhat disappointed, 2 = very disappointed, 3 = extremely disappointed.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub disappointment_rating: MaybeUndefined<i64>,
+}
+/// `INTERNAL` Input for submitting a sales or pricing inquiry to the Linear sales team. Small companies are routed to Intercom support, while larger companies are routed to HubSpot.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ContactSalesCreateInput {
-    /// Name of the person requesting information.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
-    /// Work email of the person requesting information.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub email: Option<String>,
-    /// Size of the company.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub company_size: Option<String>,
-    /// The message the user sent.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub message: Option<String>,
-    /// The URL this request was sent from.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub url: Option<String>,
-    /// PostHog distinct ID for analytics correlation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub distinct_id: Option<String>,
-    /// Session ID for analytics correlation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub session_id: Option<String>,
+    /// Full name of the person submitting the sales inquiry.
+    pub name: String,
+    /// Work email address of the person submitting the sales inquiry.
+    pub email: String,
+    /// The size of the inquiring company (e.g., '1-19', '20-99', '100-499'). Used to route the inquiry to the appropriate sales channel.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub company_size: MaybeUndefined<String>,
+    /// An optional message from the user describing their needs or questions.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub message: MaybeUndefined<String>,
+    /// The page URL from which the sales inquiry was submitted, for attribution tracking.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub url: MaybeUndefined<String>,
+    /// PostHog distinct ID for correlating this inquiry with anonymous analytics events.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub distinct_id: MaybeUndefined<String>,
+    /// PostHog session ID for correlating this inquiry with the user's browsing session.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub session_id: MaybeUndefined<String>,
 }
 /// `Internal` Comparator for content.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ContentComparator {
     /// `Internal` Contains constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub contains: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub contains: MaybeUndefined<String>,
     /// `Internal` Not-contains constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_contains: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_contains: MaybeUndefined<String>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CreateOrganizationInput {
     /// The name of the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The URL key of the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub url_key: Option<String>,
+    pub url_key: String,
     /// Whether the organization should allow email domain access.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub domain_access: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub domain_access: MaybeUndefined<bool>,
     /// The timezone of the organization, passed in by client.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub timezone: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub timezone: MaybeUndefined<String>,
     /// JSON serialized UTM parameters associated with the creation of the workspace.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub utm: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub utm: MaybeUndefined<String>,
 }
 /// Issue creation date sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CreatedAtSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
+/// Input for creating a new custom view. A name is required. Optionally scope the view to a team, project, or initiative.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomViewCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The name of the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The description of the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The icon of the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub icon: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub icon: MaybeUndefined<String>,
     /// The color of the icon of the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// The id of the team associated with the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
     /// The id of the project associated with the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
     /// The id of the initiative associated with the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_id: MaybeUndefined<String>,
     /// The owner of the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner_id: MaybeUndefined<String>,
     /// The filter applied to issues in the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub filter_data: Option<Box<IssueFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub filter_data: MaybeUndefined<IssueFilter>,
     /// The project filter applied to issues in the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_filter_data: Option<Box<ProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_filter_data: MaybeUndefined<ProjectFilter>,
     /// `ALPHA` The initiative filter applied to issues in the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_filter_data: Option<Box<InitiativeFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_filter_data: MaybeUndefined<InitiativeFilter>,
     /// The feed item filter applied to issues in the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub feed_item_filter_data: Option<Box<FeedItemFilter>>,
-    /// Whether the custom view is shared with everyone in the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub shared: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub feed_item_filter_data: MaybeUndefined<FeedItemFilter>,
+    /// Whether the custom view is shared with everyone in the workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub shared: MaybeUndefined<bool>,
 }
 /// Custom view creation date sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomViewCreatedAtSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Custom view filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomViewFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the custom view name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the custom view model name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub model_name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub model_name: MaybeUndefined<StringComparator>,
     /// Filters that the custom view's team must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team: Option<Box<NullableTeamFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team: MaybeUndefined<NullableTeamFilter>,
     /// Filters that the custom view creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<UserFilter>,
     /// Comparator for whether the custom view is shared.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub shared: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub shared: MaybeUndefined<BooleanComparator>,
     /// `INTERNAL` Filter based on whether the custom view has a facet.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_facet: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_facet: MaybeUndefined<bool>,
     /// Compound filters, all of which need to be matched by the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<CustomViewFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<CustomViewFilter>>,
     /// Compound filters, one of which need to be matched by the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<CustomViewFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<CustomViewFilter>>,
 }
 /// Custom view name sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomViewNameSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Custom view shared status sorting options. Ascending order puts shared views last.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomViewSharedSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomViewSortInput {
     /// Sort by custom view name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<CustomViewNameSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<CustomViewNameSort>,
     /// Sort by custom view creation date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<CustomViewCreatedAtSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<CustomViewCreatedAtSort>,
     /// Sort by custom view shared status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub shared: Option<Box<CustomViewSharedSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub shared: MaybeUndefined<CustomViewSharedSort>,
     /// Sort by custom view update date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<CustomViewUpdatedAtSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<CustomViewUpdatedAtSort>,
 }
+/// Input for updating an existing custom view. All fields are optional; only provided fields will be updated.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomViewUpdateInput {
     /// The name of the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The description of the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The icon of the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub icon: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub icon: MaybeUndefined<String>,
     /// The color of the icon of the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// The id of the team associated with the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
     /// `Internal` The id of the project associated with the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
     /// `Internal` The id of the initiative associated with the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_id: MaybeUndefined<String>,
     /// The owner of the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner_id: MaybeUndefined<String>,
     /// The filter applied to issues in the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub filter_data: Option<Box<IssueFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub filter_data: MaybeUndefined<IssueFilter>,
     /// The project filter applied to issues in the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_filter_data: Option<Box<ProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_filter_data: MaybeUndefined<ProjectFilter>,
     /// `ALPHA` The initiative filter applied to issues in the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_filter_data: Option<Box<InitiativeFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_filter_data: MaybeUndefined<InitiativeFilter>,
     /// The feed item filter applied to issues in the custom view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub feed_item_filter_data: Option<Box<FeedItemFilter>>,
-    /// Whether the custom view is shared with everyone in the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub shared: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub feed_item_filter_data: MaybeUndefined<FeedItemFilter>,
+    /// Whether the custom view is shared with everyone in the workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub shared: MaybeUndefined<bool>,
 }
 /// Custom view update date sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomViewUpdatedAtSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Issue customer count sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerCountSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
+/// Input for creating a new customer in the workspace.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
-    /// The name of the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
-    /// The domains associated with this customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub domains: Option<Vec<String>>,
-    /// The ids of the customers in external systems.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_ids: Option<Vec<String>>,
-    /// The ID of the Slack channel used to interact with the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_channel_id: Option<String>,
-    /// The user who owns the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner_id: Option<String>,
-    /// The status of the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status_id: Option<String>,
-    /// The annual revenue generated by the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub revenue: Option<i64>,
-    /// The size of the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub size: Option<i64>,
-    /// The tier of the customer customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub tier_id: Option<String>,
-    /// The URL of the customer's logo.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub logo_url: Option<String>,
-    /// The main source of the customer, for customers with multiple sources. Must be one of externalIds.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub main_source_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
+    /// The display name of the customer organization.
+    pub name: String,
+    /// The email domains associated with this customer (e.g., 'acme.com'). Public email domains are not allowed. Defaults to an empty array.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub domains: MaybeUndefined<Vec<String>>,
+    /// Identifiers for this customer in external systems (e.g., CRM IDs). Defaults to an empty array.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_ids: MaybeUndefined<Vec<String>>,
+    /// The ID of the Slack channel to link to this customer.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_channel_id: MaybeUndefined<String>,
+    /// The identifier of the user to assign as the owner of the customer.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner_id: MaybeUndefined<String>,
+    /// The identifier of the customer status to set.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status_id: MaybeUndefined<String>,
+    /// The annual revenue generated by the customer, in dollars.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub revenue: MaybeUndefined<i64>,
+    /// The size of the customer organization (e.g., number of employees).
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub size: MaybeUndefined<i64>,
+    /// The identifier of the customer tier to assign.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub tier_id: MaybeUndefined<String>,
+    /// The URL of the customer's logo image.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub logo_url: MaybeUndefined<String>,
+    /// The primary external source ID for customers with multiple sources. Must be one of the values provided in externalIds.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub main_source_id: MaybeUndefined<String>,
 }
 /// Customer creation date sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerCreatedAtSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Customer filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the customer name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the customer slack channel ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_channel_id: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_channel_id: MaybeUndefined<StringComparator>,
     /// Comparator for the customer's domains.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub domains: Option<Box<StringArrayComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub domains: MaybeUndefined<StringArrayComparator>,
     /// Comparator for the customer's external IDs.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_ids: Option<Box<StringArrayComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_ids: MaybeUndefined<StringArrayComparator>,
     /// Filters that the customer owner must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner: MaybeUndefined<NullableUserFilter>,
     /// Filters that the customer's needs must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub needs: Option<Box<CustomerNeedCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub needs: MaybeUndefined<CustomerNeedCollectionFilter>,
     /// Comparator for the customer generated revenue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub revenue: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub revenue: MaybeUndefined<NumberComparator>,
     /// Comparator for the customer size.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub size: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub size: MaybeUndefined<NumberComparator>,
     /// Filters that the customer's status must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status: Option<Box<CustomerStatusFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status: MaybeUndefined<CustomerStatusFilter>,
     /// Filters that the customer's tier must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub tier: Option<Box<CustomerTierFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub tier: MaybeUndefined<CustomerTierFilter>,
     /// Compound filters, all of which need to be matched by the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<CustomerFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<CustomerFilter>>,
     /// Compound filters, one of which need to be matched by the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<CustomerFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<CustomerFilter>>,
 }
 /// Issue customer important count sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerImportantCountSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Customer needs filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerNeedCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the customer need priority.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority: MaybeUndefined<NumberComparator>,
     /// Filters that the need's project must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project: Option<Box<NullableProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<Box<NullableProjectFilter>>,
     /// Filters that the need's issue must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue: Option<Box<NullableIssueFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue: MaybeUndefined<Box<NullableIssueFilter>>,
     /// Filters that the need's comment must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub comment: Option<Box<NullableCommentFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub comment: MaybeUndefined<Box<NullableCommentFilter>>,
     /// Filters that the need's customer must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer: Option<Box<NullableCustomerFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer: MaybeUndefined<Box<NullableCustomerFilter>>,
     /// Compound filters, all of which need to be matched by the customer needs.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<CustomerNeedCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<CustomerNeedCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the customer needs.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<CustomerNeedCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<CustomerNeedCollectionFilter>>,
     /// Filters that needs to be matched by some customer needs.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<CustomerNeedFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<Box<CustomerNeedFilter>>,
     /// Filters that needs to be matched by all customer needs.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<CustomerNeedFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<Box<CustomerNeedFilter>>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
 }
+/// Input for creating a customer need from an existing issue attachment. If the attachment already has an archived need, it will be unarchived instead.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerNeedCreateFromAttachmentInput {
-    /// The attachment this need is created from.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub attachment_id: Option<String>,
+    /// The UUID of the existing issue attachment to create a customer need from.
+    pub attachment_id: String,
 }
+/// Input for creating a customer need linked to an issue or project. Either issueId or projectId must be provided.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerNeedCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
-    /// The uuid of the customer the need belongs to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_id: Option<String>,
-    /// The external ID of the customer the need belongs to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_external_id: Option<String>,
-    /// The issue this need is referencing. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_id: Option<String>,
-    /// `INTERNAL` The project this need is referencing.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
-    /// The comment this need is referencing.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub comment_id: Option<String>,
-    /// The attachment this need is referencing.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub attachment_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
+    /// The UUID of the customer this need belongs to. Cannot be used together with customerExternalId.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_id: MaybeUndefined<String>,
+    /// The external system ID of the customer this need belongs to. Cannot be used together with customerId.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_external_id: MaybeUndefined<String>,
+    /// The issue to link this need to. Accepts a UUID or issue identifier (e.g., 'LIN-123'). Either issueId or projectId must be provided.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_id: MaybeUndefined<String>,
+    /// `INTERNAL` The project to link this need to. Either issueId or projectId must be provided.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
+    /// The UUID of an existing comment to associate with this need for additional context.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub comment_id: MaybeUndefined<String>,
+    /// The UUID of an existing attachment to associate with this need as its source.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub attachment_id: MaybeUndefined<String>,
     /// Whether the customer need is important or not. 0 = Not important, 1 = Important.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority: Option<f64>,
-    /// The content of the need in markdown format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body: Option<String>,
-    /// `Internal` The content of the need as a Prosemirror document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body_data: Option<serde_json::Value>,
-    /// Optional URL for the attachment associated with the customer need.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub attachment_url: Option<String>,
-    /// Create need as a user with the provided name. This option is only available to OAuth applications creating needs in `actor=app` mode.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub create_as_user: Option<String>,
-    /// Provide an external user avatar URL. Can only be used in conjunction with the `createAsUser` options. This option is only available to OAuth applications creating needs in `actor=app` mode.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub display_icon_url: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority: MaybeUndefined<f64>,
+    /// The body content of the need in Markdown format. Cannot be used together with bodyData.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body: MaybeUndefined<String>,
+    /// `Internal` The body content of the need as a Prosemirror document JSON string. Cannot be used together with body.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body_data: MaybeUndefined<serde_json::Value>,
+    /// A URL to create an attachment from and associate with this customer need as its source.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub attachment_url: MaybeUndefined<String>,
+    /// Create the need attributed to an external user with the provided name. This option is only available to OAuth applications creating needs in `actor=app` mode.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub create_as_user: MaybeUndefined<String>,
+    /// Avatar URL for the external user specified in `createAsUser`. Can only be used in conjunction with `createAsUser`. This option is only available to OAuth applications creating needs in `actor=app` mode.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub display_icon_url: MaybeUndefined<String>,
 }
 /// Customer filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerNeedFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the customer need priority.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority: MaybeUndefined<NumberComparator>,
     /// Filters that the need's project must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project: Option<Box<NullableProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<Box<NullableProjectFilter>>,
     /// Filters that the need's issue must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue: Option<Box<NullableIssueFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue: MaybeUndefined<Box<NullableIssueFilter>>,
     /// Filters that the need's comment must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub comment: Option<Box<NullableCommentFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub comment: MaybeUndefined<Box<NullableCommentFilter>>,
     /// Filters that the need's customer must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer: Option<Box<NullableCustomerFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer: MaybeUndefined<Box<NullableCustomerFilter>>,
     /// Compound filters, all of which need to be matched by the customer need.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<CustomerNeedFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<CustomerNeedFilter>>,
     /// Compound filters, one of which need to be matched by the customer need.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<CustomerNeedFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<CustomerNeedFilter>>,
 }
+/// Input for updating a customer need. Supports reassigning the customer, moving to a different issue or project, changing priority, and updating body content.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerNeedUpdateInput {
-    /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
-    /// The uuid of the customer the need belongs to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_id: Option<String>,
-    /// The external ID of the customer the need belongs to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_external_id: Option<String>,
-    /// The issue this need is referencing. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_id: Option<String>,
-    /// `INTERNAL` The project this need is referencing.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    /// An optional identifier in UUID v4 format. If provided, will be set as the customer need's ID.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
+    /// The UUID of the customer to reassign this need to. Cannot be used together with customerExternalId.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_id: MaybeUndefined<String>,
+    /// The external system ID of the customer to reassign this need to. Cannot be used together with customerId.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_external_id: MaybeUndefined<String>,
+    /// The issue to move this need to. Accepts a UUID or issue identifier (e.g., 'LIN-123'). The need's attachment will also be moved to the target issue.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_id: MaybeUndefined<String>,
+    /// `INTERNAL` The project to move this need to.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
     /// Whether the customer need is important or not. 0 = Not important, 1 = Important.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority: Option<f64>,
-    /// Whether to also update the priority of needs from the same customer on the same issue/project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub apply_priority_to_related_needs: Option<bool>,
-    /// The content of the need in markdown format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body: Option<String>,
-    /// `Internal` The content of the need as a Prosemirror document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body_data: Option<serde_json::Value>,
-    /// Optional URL for the attachment associated with the customer need.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub attachment_url: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority: MaybeUndefined<f64>,
+    /// When true and priority is also set, applies the same priority update to all other needs from the same customer on the same issue or project.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub apply_priority_to_related_needs: MaybeUndefined<bool>,
+    /// The updated body content of the need in Markdown format. Set to null to clear the body. Cannot be used together with bodyData.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body: MaybeUndefined<String>,
+    /// `Internal` The updated body content of the need as a Prosemirror document JSON string. Set to null to clear the body. Cannot be used together with body.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body_data: MaybeUndefined<serde_json::Value>,
+    /// A URL to create a new attachment from and set as the source for this customer need. Replaces any existing manually-added attachment.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub attachment_url: MaybeUndefined<String>,
 }
 /// Issue customer revenue sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerRevenueSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Issue customer sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Customer sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerSortInput {
     /// Sort by name
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<NameSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<NameSort>,
     /// Sort by customer creation date
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<CustomerCreatedAtSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<CustomerCreatedAtSort>,
     /// Sort by owner name
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner: Option<Box<OwnerSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner: MaybeUndefined<OwnerSort>,
     /// Sort by customer status
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status: Option<Box<CustomerStatusSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status: MaybeUndefined<CustomerStatusSort>,
     /// Sort by customer generated revenue
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub revenue: Option<Box<RevenueSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub revenue: MaybeUndefined<RevenueSort>,
     /// Sort by customer size
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub size: Option<Box<SizeSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub size: MaybeUndefined<SizeSort>,
     /// Sort by customer tier
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub tier: Option<Box<TierSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub tier: MaybeUndefined<TierSort>,
     /// Sort by approximate customer need count
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub approximate_need_count: Option<Box<ApproximateNeedCountSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub approximate_need_count: MaybeUndefined<ApproximateNeedCountSort>,
 }
+/// Input for creating a customer status in the workspace's customer lifecycle flow.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerStatusCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
-    /// The name of the status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
-    /// The UI color of the status as a HEX string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
-    /// Description of the status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
-    /// The position of the status in the workspace's customer flow.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub position: Option<f64>,
-    /// The display name of the status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub display_name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
+    /// The internal name of the status. At least one of name or displayName must be provided.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
+    /// The color of the status indicator in the UI, as a HEX string (e.g., '#ff0000').
+    pub color: String,
+    /// An optional description explaining what this status represents.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
+    /// The sort position of the status in the workspace's customer lifecycle flow. If omitted or colliding, a position is automatically assigned at the end.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub position: MaybeUndefined<f64>,
+    /// The user-facing display name of the status. At least one of name or displayName must be provided.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub display_name: MaybeUndefined<String>,
 }
 /// Customer status filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerStatusFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the customer status name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the customer status description.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<StringComparator>,
     /// Comparator for the customer status position.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub position: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub position: MaybeUndefined<NumberComparator>,
     /// Comparator for the customer status type.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<StringComparator>,
     /// Comparator for the customer status color.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<StringComparator>,
     /// Compound filters, all of which need to be matched by the customer status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<CustomerStatusFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<CustomerStatusFilter>>,
     /// Compound filters, one of which needs to be matched by the customer status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<CustomerStatusFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<CustomerStatusFilter>>,
 }
 /// Customer status sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerStatusSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
+/// Input for updating an existing customer status.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerStatusUpdateInput {
-    /// The name of the status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
-    /// The UI color of the status as a HEX string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
-    /// Description of the status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
-    /// The position of the status in the workspace's customer flow.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub position: Option<f64>,
-    /// The display name of the status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub display_name: Option<String>,
-}
+    /// The updated internal name of the status.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
+    /// The updated color of the status indicator in the UI, as a HEX string.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
+    /// The updated description of the status.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
+    /// The updated sort position of the status in the workspace's customer lifecycle flow.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub position: MaybeUndefined<f64>,
+    /// The updated user-facing display name of the status.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub display_name: MaybeUndefined<String>,
+}
+/// Input for creating a customer tier in the workspace's customer tier ordering.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerTierCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
-    /// The name of the tier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
-    /// The UI color of the tier as a HEX string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
-    /// Description of the tier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
-    /// The position of the tier in the workspace's customer flow.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub position: Option<f64>,
-    /// The display name of the tier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub display_name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
+    /// The internal name of the tier. Must be unique within the workspace. At least one of name or displayName must be provided.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
+    /// The color of the tier indicator in the UI, as a HEX string (e.g., '#ff0000').
+    pub color: String,
+    /// An optional description explaining what this tier represents.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
+    /// The sort position of the tier in the workspace's customer tier ordering. If omitted or colliding, a position is automatically assigned at the end.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub position: MaybeUndefined<f64>,
+    /// The user-facing display name of the tier. At least one of name or displayName must be provided.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub display_name: MaybeUndefined<String>,
 }
 /// Customer tier filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerTierFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the customer tier display name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub display_name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub display_name: MaybeUndefined<StringComparator>,
     /// Comparator for the customer tier description.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<StringComparator>,
     /// Comparator for the customer tier position.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub position: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub position: MaybeUndefined<NumberComparator>,
     /// Comparator for the customer tier color.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<StringComparator>,
     /// Compound filters, all of which need to be matched by the customer tier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<CustomerTierFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<CustomerTierFilter>>,
     /// Compound filters, one of which needs to be matched by the customer tier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<CustomerTierFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<CustomerTierFilter>>,
 }
+/// Input for updating an existing customer tier.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerTierUpdateInput {
-    /// The name of the tier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
-    /// The UI color of the tier as a HEX string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
-    /// Description of the tier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
-    /// The position of the tier in the workspace's customer flow.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub position: Option<f64>,
-    /// The display name of the tier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub display_name: Option<String>,
-}
+    /// The updated internal name of the tier.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
+    /// The updated color of the tier indicator in the UI, as a HEX string.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
+    /// The updated description of the tier.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
+    /// The updated sort position of the tier in the workspace's customer tier ordering.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub position: MaybeUndefined<f64>,
+    /// The updated user-facing display name of the tier.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub display_name: MaybeUndefined<String>,
+}
+/// Input for updating an existing customer.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerUpdateInput {
-    /// The name of the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
-    /// The domains associated with this customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub domains: Option<Vec<String>>,
-    /// The ids of the customers in external systems.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_ids: Option<Vec<String>>,
-    /// The ID of the Slack channel used to interact with the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_channel_id: Option<String>,
-    /// The user who owns the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner_id: Option<String>,
-    /// The status of the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status_id: Option<String>,
-    /// The annual revenue generated by the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub revenue: Option<i64>,
-    /// The size of the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub size: Option<i64>,
-    /// The tier of the customer customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub tier_id: Option<String>,
-    /// The URL of the customer's logo.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub logo_url: Option<String>,
-    /// The main source of the customer, for customers with multiple sources. Must be one of externalIds.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub main_source_id: Option<String>,
-}
+    /// The updated name of the customer.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
+    /// The updated list of email domains associated with this customer. Replaces the existing domains.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub domains: MaybeUndefined<Vec<String>>,
+    /// The updated list of external system identifiers for this customer. New IDs will be appended with source metadata.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_ids: MaybeUndefined<Vec<String>>,
+    /// The ID of the Slack channel to link to this customer. Set to null to unlink the current channel.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_channel_id: MaybeUndefined<String>,
+    /// The identifier of the user to assign as the owner of the customer.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner_id: MaybeUndefined<String>,
+    /// The identifier of the customer status to set.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status_id: MaybeUndefined<String>,
+    /// The annual revenue generated by the customer, in dollars.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub revenue: MaybeUndefined<i64>,
+    /// The size of the customer organization (e.g., number of employees).
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub size: MaybeUndefined<i64>,
+    /// The identifier of the customer tier to assign.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub tier_id: MaybeUndefined<String>,
+    /// The URL of the customer's logo image.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub logo_url: MaybeUndefined<String>,
+    /// The primary external source ID for customers with multiple sources. Must be one of the values in externalIds.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub main_source_id: MaybeUndefined<String>,
+}
+/// Input for upserting a customer. Matches against existing customers using id, externalId, slackChannelId, or domains. Creates a new customer if no match is found.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CustomerUpsertInput {
-    /// The identifier in UUID v4 format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
-    /// The name of the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
-    /// The domains associated with this customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub domains: Option<Vec<String>>,
-    /// The id of the customers in external systems.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_id: Option<String>,
-    /// The ID of the Slack channel used to interact with the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_channel_id: Option<String>,
-    /// The user who owns the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner_id: Option<String>,
-    /// The status of the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status_id: Option<String>,
-    /// The annual revenue generated by the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub revenue: Option<i64>,
-    /// The size of the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub size: Option<i64>,
-    /// The tier of the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub tier_id: Option<String>,
-    /// The URL of the customer's logo.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub logo_url: Option<String>,
-    /// The name tier of the customer. Will be created if doesn't exist
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub tier_name: Option<String>,
-}
+    /// The identifier in UUID v4 format. Used to match an existing customer for upsert.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
+    /// The name of the customer. Required when creating a new customer.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
+    /// The email domains associated with this customer.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub domains: MaybeUndefined<Vec<String>>,
+    /// An external system identifier for this customer. Used for matching existing customers during upsert.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_id: MaybeUndefined<String>,
+    /// The ID of the Slack channel to link to this customer.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_channel_id: MaybeUndefined<String>,
+    /// The identifier of the user to assign as the owner of the customer.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner_id: MaybeUndefined<String>,
+    /// The identifier of the customer status to set.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status_id: MaybeUndefined<String>,
+    /// The annual revenue generated by the customer, in dollars.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub revenue: MaybeUndefined<i64>,
+    /// The size of the customer organization (e.g., number of employees).
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub size: MaybeUndefined<i64>,
+    /// The identifier of the customer tier to assign. Cannot be used together with tierName.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub tier_id: MaybeUndefined<String>,
+    /// The URL of the customer's logo image.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub logo_url: MaybeUndefined<String>,
+    /// The name of the customer tier to assign. A new tier will be created if one with this name does not exist. Cannot be used together with tierId.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub tier_name: MaybeUndefined<String>,
+}
+/// Input for creating a new cycle.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CycleCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The custom name of the cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The description of the cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The team to associate the cycle with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
-    /// The start date of the cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub starts_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The end date of the cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ends_at: Option<chrono::DateTime<chrono::Utc>>,
+    pub team_id: String,
+    /// The start time of the cycle.
+    pub starts_at: chrono::DateTime<chrono::Utc>,
+    /// The end time of the cycle.
+    pub ends_at: chrono::DateTime<chrono::Utc>,
     /// The completion time of the cycle. If null, the cycle hasn't been completed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub completed_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
 }
 /// Cycle filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CycleFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the cycle number.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub number: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub number: MaybeUndefined<NumberComparator>,
     /// Comparator for the cycle name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the cycle start date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub starts_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub starts_at: MaybeUndefined<DateComparator>,
     /// Comparator for the cycle ends at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ends_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ends_at: MaybeUndefined<DateComparator>,
     /// Comparator for the cycle completed at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub completed_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<DateComparator>,
     /// Comparator for the filtering active cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_active: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_active: MaybeUndefined<BooleanComparator>,
     /// Comparator for filtering for whether the cycle is currently in cooldown.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_in_cooldown: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_in_cooldown: MaybeUndefined<BooleanComparator>,
     /// Comparator for the filtering next cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_next: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_next: MaybeUndefined<BooleanComparator>,
     /// Comparator for the filtering previous cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_previous: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_previous: MaybeUndefined<BooleanComparator>,
     /// Comparator for the filtering future cycles.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_future: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_future: MaybeUndefined<BooleanComparator>,
     /// Comparator for the filtering past cycles.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_past: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_past: MaybeUndefined<BooleanComparator>,
     /// Filters that the cycles team must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team: Option<Box<TeamFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team: MaybeUndefined<Box<TeamFilter>>,
     /// Filters that the cycles issues must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issues: Option<Box<IssueCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issues: MaybeUndefined<Box<IssueCollectionFilter>>,
     /// Comparator for the inherited cycle ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub inherited_from_id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub inherited_from_id: MaybeUndefined<IDComparator>,
     /// Compound filters, all of which need to be matched by the cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<CycleFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<CycleFilter>>,
     /// Compound filters, one of which need to be matched by the cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<CycleFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<CycleFilter>>,
 }
 /// Comparator for period when issue was added to a cycle.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CyclePeriodComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<CyclePeriod>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<CyclePeriod>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<CyclePeriod>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<CyclePeriod>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<CyclePeriod>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<CyclePeriod>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<CyclePeriod>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<CyclePeriod>>,
     /// Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
 }
-/// Input for shifting all cycles from a certain cycle onwards by a certain number of days
+/// Input for shifting all cycles from a certain cycle onwards by a certain number of days.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CycleShiftAllInput {
     /// The cycle ID at which to start the shift.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    pub id: String,
     /// The number of days to shift the cycles by.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub days_to_shift: Option<f64>,
+    pub days_to_shift: f64,
 }
 /// Issue cycle sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CycleSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
     /// When set to true, cycles will be ordered with a custom order. Current cycle comes first, followed by upcoming cycles in ASC order, followed by previous cycles in DESC order.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub current_cycle_first: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub current_cycle_first: MaybeUndefined<bool>,
 }
+/// Input for updating an existing cycle.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct CycleUpdateInput {
     /// The custom name of the cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The description of the cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
-    /// The start date of the cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub starts_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The end date of the cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ends_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The end date of the cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub completed_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
+    /// The start time of the cycle.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub starts_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
+    /// The end time of the cycle.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ends_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
+    /// The completion time of the cycle. If null, the cycle hasn't been completed.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
 }
 /// Comparator for dates.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct DateComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<serde_json::Value>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<serde_json::Value>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<serde_json::Value>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<serde_json::Value>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<serde_json::Value>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<serde_json::Value>>,
     /// Less-than constraint. Matches any values that are less than the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lt: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lt: MaybeUndefined<serde_json::Value>,
     /// Less-than-or-equal constraint. Matches any values that are less than or equal to the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lte: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lte: MaybeUndefined<serde_json::Value>,
     /// Greater-than constraint. Matches any values that are greater than the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub gt: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub gt: MaybeUndefined<serde_json::Value>,
     /// Greater-than-or-equal constraint. Matches any values that are greater than or equal to the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub gte: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub gte: MaybeUndefined<serde_json::Value>,
 }
 /// Issue delegate sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct DelegateSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
+/// Input for confirming workspace deletion with a verification code.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct DeleteOrganizationInput {
     /// The deletion code to confirm operation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub deletion_code: Option<String>,
-}
-/// Document content history filtering options.
-#[derive(Debug, Clone, Default, Serialize, Deserialize)]
-#[serde(rename_all = "camelCase")]
-pub struct DocumentContentHistoryFilter {
-    /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
-    /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
-    /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    pub deletion_code: String,
 }
+/// Input for creating a new document.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct DocumentCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The title of the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub title: Option<String>,
+    pub title: String,
     /// The icon of the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub icon: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub icon: MaybeUndefined<String>,
     /// The color of the icon.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// The document content as markdown.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub content: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub content: MaybeUndefined<String>,
     /// Related project for the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
     /// `Internal` Related initiative for the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_id: MaybeUndefined<String>,
     /// `Internal` Related team for the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
     /// Related issue for the document. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_id: MaybeUndefined<String>,
     /// `Internal` Related release for the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub release_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub release_id: MaybeUndefined<String>,
     /// `Internal` Related cycle for the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_id: MaybeUndefined<String>,
     /// `Internal` The resource folder containing the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub resource_folder_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub resource_folder_id: MaybeUndefined<String>,
     /// The ID of the last template applied to the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub last_applied_template_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub last_applied_template_id: MaybeUndefined<String>,
     /// The order of the item in the resources list.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
     /// `INTERNAL` The identifiers of the users subscribing to this document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subscriber_ids: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subscriber_ids: MaybeUndefined<Vec<String>>,
 }
 /// Document filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct DocumentFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the document title.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub title: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub title: MaybeUndefined<StringComparator>,
     /// Comparator for the document slug ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slug_id: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slug_id: MaybeUndefined<StringComparator>,
     /// Filters that the document's creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<UserFilter>>,
     /// Filters that the document's project must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project: Option<Box<ProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<Box<ProjectFilter>>,
     /// Filters that the document's issue must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue: Option<Box<IssueFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue: MaybeUndefined<Box<IssueFilter>>,
     /// Filters that the document's initiative must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative: Option<Box<InitiativeFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative: MaybeUndefined<Box<InitiativeFilter>>,
+    /// Filters that the document's cycle must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle: MaybeUndefined<Box<CycleFilter>>,
+    /// Filters that the document's release must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub release: MaybeUndefined<Box<ReleaseFilter>>,
     /// Compound filters, all of which need to be matched by the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<DocumentFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<DocumentFilter>>,
     /// Compound filters, one of which need to be matched by the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<DocumentFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<DocumentFilter>>,
 }
+/// Input for updating an existing document.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct DocumentUpdateInput {
     /// The title of the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub title: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub title: MaybeUndefined<String>,
     /// The icon of the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub icon: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub icon: MaybeUndefined<String>,
     /// The color of the icon.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// The document content as markdown.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub content: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub content: MaybeUndefined<String>,
     /// Related project for the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
     /// `Internal` Related initiative for the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_id: MaybeUndefined<String>,
     /// `Internal` Related team for the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
     /// Related issue for the document. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_id: MaybeUndefined<String>,
     /// `Internal` Related release for the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub release_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub release_id: MaybeUndefined<String>,
     /// `Internal` Related cycle for the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_id: MaybeUndefined<String>,
     /// `Internal` The resource folder containing the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub resource_folder_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub resource_folder_id: MaybeUndefined<String>,
     /// The ID of the last template applied to the document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub last_applied_template_id: Option<String>,
-    /// The time at which the document was hidden.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub hidden_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub last_applied_template_id: MaybeUndefined<String>,
+    /// The time at which the document was hidden. Set to null to unhide.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub hidden_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
     /// The order of the item in the resources list.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
-    /// Whether the document has been trashed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub trashed: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
+    /// Whether the document has been trashed. Set to true to trash, or null to restore from trash.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub trashed: MaybeUndefined<bool>,
     /// `INTERNAL` The identifiers of the users subscribing to this document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subscriber_ids: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subscriber_ids: MaybeUndefined<Vec<String>>,
 }
 /// Issue due date sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct DueDateSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
+/// Input for creating a new email intake address.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct EmailIntakeAddressCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The type of the email address. If not provided, the backend will default to team or template.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<EmailIntakeAddressType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<EmailIntakeAddressType>,
     /// The email address used to forward emails to the intake address.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub forwarding_email_address: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub forwarding_email_address: MaybeUndefined<String>,
     /// The name to be used for outgoing emails.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sender_name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sender_name: MaybeUndefined<String>,
     /// The identifier or key of the team this email address will intake issues for.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
     /// The identifier of the template this email address will intake issues for.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub template_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub template_id: MaybeUndefined<String>,
     /// Whether email replies are enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub replies_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub replies_enabled: MaybeUndefined<bool>,
     /// Whether the commenter's name is included in the email replies.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub use_user_names_in_replies: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub use_user_names_in_replies: MaybeUndefined<bool>,
     /// Whether the issue created auto-reply is enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_created_auto_reply_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_created_auto_reply_enabled: MaybeUndefined<bool>,
     /// The auto-reply message for issue created.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_created_auto_reply: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_created_auto_reply: MaybeUndefined<String>,
     /// Whether the issue completed auto-reply is enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_completed_auto_reply_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_completed_auto_reply_enabled: MaybeUndefined<bool>,
     /// The auto-reply message for issue completed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_completed_auto_reply: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_completed_auto_reply: MaybeUndefined<String>,
     /// Whether the issue canceled auto-reply is enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_canceled_auto_reply_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_canceled_auto_reply_enabled: MaybeUndefined<bool>,
     /// The auto-reply message for issue canceled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_canceled_auto_reply: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_canceled_auto_reply: MaybeUndefined<String>,
     /// Whether customer requests are enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_requests_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_requests_enabled: MaybeUndefined<bool>,
+    /// Whether to reopen completed or canceled issues when a substantive email reply is received.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reopen_on_reply: MaybeUndefined<bool>,
 }
+/// Input for updating an existing email intake address.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct EmailIntakeAddressUpdateInput {
     /// Whether the email address is currently enabled. If set to false, the email address will be disabled and no longer accept incoming emails.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enabled: MaybeUndefined<bool>,
     /// The email address used to forward emails to the intake address.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub forwarding_email_address: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub forwarding_email_address: MaybeUndefined<String>,
     /// The name to be used for outgoing emails.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sender_name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sender_name: MaybeUndefined<String>,
     /// The identifier or key of the team this email address will intake issues for.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
     /// The identifier of the template this email address will intake issues for.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub template_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub template_id: MaybeUndefined<String>,
     /// Whether email replies are enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub replies_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub replies_enabled: MaybeUndefined<bool>,
     /// Whether the commenter's name is included in the email replies.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub use_user_names_in_replies: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub use_user_names_in_replies: MaybeUndefined<bool>,
     /// Whether the issue created auto-reply is enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_created_auto_reply_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_created_auto_reply_enabled: MaybeUndefined<bool>,
     /// The auto-reply message for issue created.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_created_auto_reply: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_created_auto_reply: MaybeUndefined<String>,
     /// Whether the issue completed auto-reply is enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_completed_auto_reply_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_completed_auto_reply_enabled: MaybeUndefined<bool>,
     /// Custom auto-reply message for issue completed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_completed_auto_reply: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_completed_auto_reply: MaybeUndefined<String>,
     /// Whether the issue canceled auto-reply is enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_canceled_auto_reply_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_canceled_auto_reply_enabled: MaybeUndefined<bool>,
     /// Custom auto-reply message for issue canceled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_canceled_auto_reply: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_canceled_auto_reply: MaybeUndefined<String>,
     /// Whether customer requests are enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_requests_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_requests_enabled: MaybeUndefined<bool>,
+    /// Whether to reopen completed or canceled issues when a substantive email reply is received.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reopen_on_reply: MaybeUndefined<bool>,
 }
+/// Input for unsubscribing a user from a specific email notification type.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct EmailUnsubscribeInput {
     /// Email type to unsubscribe from.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<String>,
+    pub r#type: String,
     /// The user's email validation token.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub token: Option<String>,
+    pub token: String,
     /// The identifier of the user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user_id: Option<String>,
+    pub user_id: String,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct EmailUserAccountAuthChallengeInput {
     /// The email for which to generate the magic login code.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub email: Option<String>,
+    pub email: String,
     /// Whether the login was requested from the desktop app.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_desktop: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_desktop: MaybeUndefined<bool>,
     /// Auth code for the client initiating the sequence.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub client_auth_code: Option<String>,
-    /// The organization invite link to associate with this authentication.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub invite_link: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub client_auth_code: MaybeUndefined<String>,
+    /// The workspace invite link to associate with this authentication.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub invite_link: MaybeUndefined<String>,
     /// Whether to only return the login code. This is used by mobile apps to skip showing the login link.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub login_code_only: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub login_code_only: MaybeUndefined<bool>,
     /// Response from the login challenge.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub challenge_response: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub challenge_response: MaybeUndefined<String>,
+    /// PostHog session ID for attribution tracking.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub session_id: MaybeUndefined<String>,
 }
+/// Input for creating a new custom emoji.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct EmojiCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The name of the custom emoji.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The URL for the emoji.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub url: Option<String>,
+    pub url: String,
 }
+/// Input for creating a new external link on an entity. A URL, label, and exactly one parent entity (initiative, project, team, release, or cycle) are required.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct EntityExternalLinkCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The URL of the link.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub url: Option<String>,
+    pub url: String,
     /// The label for the link.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label: Option<String>,
+    pub label: String,
     /// The initiative associated with the link.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_id: MaybeUndefined<String>,
     /// The project associated with the link.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
     /// `Internal` The team associated with the link.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
     /// `Internal` The release associated with the link.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub release_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub release_id: MaybeUndefined<String>,
     /// `Internal` The cycle associated with the link.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_id: MaybeUndefined<String>,
     /// `Internal` The resource folder containing the link.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub resource_folder_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub resource_folder_id: MaybeUndefined<String>,
     /// The order of the item in the entities resources list.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
 }
+/// Input for updating an existing external link. All fields are optional; only provided fields will be updated.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct EntityExternalLinkUpdateInput {
     /// The URL of the link.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub url: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub url: MaybeUndefined<String>,
     /// The label for the link.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub label: MaybeUndefined<String>,
     /// The order of the item in the entities resources list.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
     /// `Internal` The resource folder containing the link.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub resource_folder_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub resource_folder_id: MaybeUndefined<String>,
 }
 /// Comparator for estimates.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct EstimateComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<f64>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<f64>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<f64>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<f64>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<f64>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<f64>>,
     /// Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Less-than constraint. Matches any values that are less than the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lt: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lt: MaybeUndefined<f64>,
     /// Less-than-or-equal constraint. Matches any values that are less than or equal to the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lte: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lte: MaybeUndefined<f64>,
     /// Greater-than constraint. Matches any values that are greater than the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub gt: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub gt: MaybeUndefined<f64>,
     /// Greater-than-or-equal constraint. Matches any values that are greater than or equal to the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub gte: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub gte: MaybeUndefined<f64>,
     /// Compound filters, all of which need to be matched by the estimate.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<NullableNumberComparator>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<NullableNumberComparator>>,
     /// Compound filters, one of which need to be matched by the estimate.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<NullableNumberComparator>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<NullableNumberComparator>>,
 }
 /// Issue estimate sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct EstimateSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
+/// Input for tracking an anonymous analytics event.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct EventTrackingInput {
+    /// The event name to track.
+    pub event: String,
+    /// Optional properties for the event.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub properties: MaybeUndefined<serde_json::Value>,
+    /// Client session ID for PostHog session correlation.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub session_id: MaybeUndefined<String>,
+}
+/// Input for creating a favorite. Exactly one target entity must be specified (e.g., issueId, projectId, customViewId, folderName, etc.).
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct FavoriteCreateInput {
     /// The identifier. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The name of the favorite folder.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub folder_name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub folder_name: MaybeUndefined<String>,
     /// The parent folder of the favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent_id: MaybeUndefined<String>,
     /// The identifier of the issue to favorite. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_id: MaybeUndefined<String>,
     /// The identifier of the facet to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub facet_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub facet_id: MaybeUndefined<String>,
     /// The identifier of the project to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
     /// The tab of the project to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_tab: Option<ProjectTab>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_tab: MaybeUndefined<ProjectTab>,
     /// The type of the predefined view to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub predefined_view_type: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub predefined_view_type: MaybeUndefined<String>,
     /// The identifier of team for the predefined view to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub predefined_view_team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub predefined_view_team_id: MaybeUndefined<String>,
     /// The identifier of the cycle to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_id: MaybeUndefined<String>,
     /// The identifier of the custom view to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub custom_view_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub custom_view_id: MaybeUndefined<String>,
     /// The identifier of the document to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub document_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub document_id: MaybeUndefined<String>,
     /// `INTERNAL` The identifier of the initiative to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_id: MaybeUndefined<String>,
     /// The tab of the initiative to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_tab: Option<InitiativeTab>,
-    /// The identifier of the label to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_tab: MaybeUndefined<InitiativeTab>,
     /// The identifier of the label to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_label_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub label_id: MaybeUndefined<String>,
+    /// The identifier of the project label to favorite.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_label_id: MaybeUndefined<String>,
     /// The identifier of the user to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub user_id: MaybeUndefined<String>,
     /// The position of the item in the favorites list.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
     /// The identifier of the customer to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_id: MaybeUndefined<String>,
     /// The identifier of the dashboard to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub dashboard_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub dashboard_id: MaybeUndefined<String>,
     /// The identifier of the pull request to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub pull_request_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub pull_request_id: MaybeUndefined<String>,
     /// `ALPHA` The identifier of the release to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub release_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub release_id: MaybeUndefined<String>,
     /// `ALPHA` The identifier of the release pipeline to favorite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub release_pipeline_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub release_pipeline_id: MaybeUndefined<String>,
 }
+/// Input for updating a favorite's position, parent folder, or folder name.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct FavoriteUpdateInput {
     /// The position of the item in the favorites list.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
     /// The identifier (in UUID v4 format) of the folder to move the favorite under.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent_id: MaybeUndefined<String>,
     /// The name of the favorite folder.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub folder_name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub folder_name: MaybeUndefined<String>,
 }
 /// Feed item filtering options
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct FeedItemFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Filters that the feed item author must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub author: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub author: MaybeUndefined<UserFilter>,
     /// Comparator for the update type: initiative, project, team
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub update_type: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub update_type: MaybeUndefined<StringComparator>,
     /// Comparator for the project or initiative update health: onTrack, atRisk, offTrack
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub update_health: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub update_health: MaybeUndefined<StringComparator>,
     /// Filters that the feed item's project update must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_update: Option<Box<ProjectUpdateFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_update: MaybeUndefined<ProjectUpdateFilter>,
     /// Filters that the related feed item initiatives must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub related_initiatives: Option<Box<InitiativeCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub related_initiatives: MaybeUndefined<InitiativeCollectionFilter>,
     /// Filters that the related feed item team must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub related_teams: Option<Box<TeamCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub related_teams: MaybeUndefined<TeamCollectionFilter>,
     /// Compound filters, all of which need to be matched by the feed item.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<FeedItemFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<FeedItemFilter>>,
     /// Compound filters, one of which need to be matched by the feed item.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<FeedItemFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<FeedItemFilter>>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct FrontSettingsInput {
     /// Whether an internal message should be added when a Linear issue changes status (for status types except completed or canceled).
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub send_note_on_status_change: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub send_note_on_status_change: MaybeUndefined<bool>,
     /// Whether an internal message should be added when someone comments on an issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub send_note_on_comment: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub send_note_on_comment: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when its linked Linear issue is completed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_completion: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_completion: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when its linked Linear issue is cancelled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_cancellation: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_cancellation: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when a comment is posted on its linked Linear issue
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_comment: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_comment: MaybeUndefined<bool>,
     /// `ALPHA` Whether customer and customer requests should not be automatically created when conversations are linked to a Linear issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub disable_customer_requests_auto_creation: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub disable_customer_requests_auto_creation: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when its linked Linear project is completed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_project_completion: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_project_completion: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when its linked Linear project is cancelled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_project_cancellation: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_project_cancellation: MaybeUndefined<bool>,
     /// Whether Linear Agent should be enabled for this integration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enable_ai_intake: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enable_ai_intake: MaybeUndefined<bool>,
 }
-#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+/// Input for creating a new Git automation rule.
+#[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct GitAutomationStateCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The team associated with the automation state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    pub team_id: String,
     /// The associated workflow state. If null, will override default behaviour and take no action.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub state_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub state_id: MaybeUndefined<String>,
     /// The associated target branch. If null, all branches are targeted.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_branch_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_branch_id: MaybeUndefined<String>,
     /// The event that triggers the automation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub event: Option<GitAutomationStates>,
+    pub event: GitAutomationStates,
 }
+/// Input for updating an existing Git automation rule.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct GitAutomationStateUpdateInput {
     /// The associated workflow state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub state_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub state_id: MaybeUndefined<String>,
     /// The associated target branch. If null, all branches are targeted.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_branch_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_branch_id: MaybeUndefined<String>,
     /// The event that triggers the automation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub event: Option<GitAutomationStates>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub event: MaybeUndefined<GitAutomationStates>,
 }
+/// Input for creating a new Git target branch definition.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct GitAutomationTargetBranchCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The team associated with the Git target branch automation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    pub team_id: String,
     /// The target branch pattern.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub branch_pattern: Option<String>,
+    pub branch_pattern: String,
     /// Whether the branch pattern is a regular expression.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_regex: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_regex: MaybeUndefined<bool>,
 }
+/// Input for updating an existing Git target branch definition.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct GitAutomationTargetBranchUpdateInput {
     /// The target branch pattern.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub branch_pattern: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub branch_pattern: MaybeUndefined<String>,
     /// Whether the branch pattern is a regular expression.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_regex: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_regex: MaybeUndefined<bool>,
 }
-#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct GitHubImportSettingsInput {
     /// The GitHub organization's name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub org_login: Option<String>,
+    pub org_login: String,
     /// The avatar URL for the GitHub organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub org_avatar_url: Option<String>,
+    pub org_avatar_url: String,
     /// The names of the repositories connected for the GitHub integration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub repositories: Option<Vec<Box<GitHubRepoInput>>>,
+    pub repositories: Vec<GitHubRepoInput>,
     /// A map storing all available issue labels per repository
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub labels: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub labels: MaybeUndefined<serde_json::Value>,
     /// The type of Github org
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub org_type: Option<GithubOrgType>,
+    pub org_type: GithubOrgType,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct GitHubPersonalSettingsInput {
     /// The GitHub user's name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub login: Option<String>,
+    pub login: String,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct GitHubRepoInput {
     /// The GitHub repo id.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<f64>,
+    pub id: f64,
     /// The full name of the repository.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub full_name: Option<String>,
+    pub full_name: String,
     /// Whether the repository is archived.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub archived: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub archived: MaybeUndefined<bool>,
+    /// The external identifier (GitHub node ID) for the repository.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_id: MaybeUndefined<String>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct GitHubRepoMappingInput {
     /// The unique identifier for this mapping.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    pub id: String,
     /// The Linear team id to map to the given project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub linear_team_id: Option<String>,
+    pub linear_team_id: String,
     /// The GitHub repo id.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub git_hub_repo_id: Option<f64>,
+    pub git_hub_repo_id: f64,
     /// Labels to filter incoming GitHub issue creation by.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub git_hub_labels: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub git_hub_labels: MaybeUndefined<Vec<String>>,
     /// Whether the sync for this mapping is bidirectional.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub bidirectional: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub bidirectional: MaybeUndefined<bool>,
     /// Whether this mapping is the default one for issue creation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub default: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub default: MaybeUndefined<bool>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct GitHubSettingsInput {
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub pull_request_review_tool: Option<PullRequestReviewTool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub pull_request_review_tool: MaybeUndefined<PullRequestReviewTool>,
     /// The avatar URL for the GitHub organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub org_avatar_url: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub org_avatar_url: MaybeUndefined<String>,
     /// The GitHub organization's name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub org_login: Option<String>,
+    pub org_login: String,
+    /// The stable external identifier (GitHub node ID) for the organization.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_org_id: MaybeUndefined<String>,
     /// The names of the repositories connected for the GitHub integration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub repositories: Option<Vec<Box<GitHubRepoInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub repositories: MaybeUndefined<Vec<GitHubRepoInput>>,
     /// Mapping of team to repository for syncing.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub repositories_mapping: Option<Vec<Box<GitHubRepoMappingInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub repositories_mapping: MaybeUndefined<Vec<GitHubRepoMappingInput>>,
     /// The type of Github org
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub org_type: Option<GithubOrgType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub org_type: MaybeUndefined<GithubOrgType>,
     /// Whether the integration has code access
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub code_access: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub code_access: MaybeUndefined<bool>,
+    /// The enterprise URL if this is a GitHub Enterprise Cloud integration.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enterprise_url: MaybeUndefined<String>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct GitLabSettingsInput {
     /// The self-hosted URL of the GitLab instance.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub url: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub url: MaybeUndefined<String>,
     /// Whether the token is limited to a read-only scope.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub readonly: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub readonly: MaybeUndefined<bool>,
     /// The ISO timestamp the GitLab access token expires.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub expires_at: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub expires_at: MaybeUndefined<String>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct GongRecordingImportConfigInput {
     /// The team ID to create issues in for imported recordings. Set to null to disable import.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct GongSettingsInput {
     /// Configuration for recording import.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub import_config: Option<Box<GongRecordingImportConfigInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub import_config: MaybeUndefined<GongRecordingImportConfigInput>,
+    /// Whether to tag matching internal Gong call participants as user mentions in created issues.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub tag_participants_in_issues: MaybeUndefined<bool>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct GoogleSheetsExportSettings {
     /// Whether the export is enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enabled: MaybeUndefined<bool>,
     /// The ID of the exported Google Sheet.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub spreadsheet_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub spreadsheet_id: MaybeUndefined<String>,
     /// The URL of the exported Google Sheet.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub spreadsheet_url: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub spreadsheet_url: MaybeUndefined<String>,
     /// The ID of the target sheet (tab) within the Google Sheet.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sheet_id: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sheet_id: MaybeUndefined<f64>,
     /// The date of the most recent export.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct GoogleSheetsSettingsInput {
     /// `Deprecated` The ID of the exported Google Sheet.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub spreadsheet_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub spreadsheet_id: MaybeUndefined<String>,
     /// `Deprecated` The URL of the exported Google Sheet.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub spreadsheet_url: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub spreadsheet_url: MaybeUndefined<String>,
     /// `Deprecated` The ID of the target sheet (tab) within the Google Sheet.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sheet_id: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sheet_id: MaybeUndefined<f64>,
     /// `Deprecated` The date of the most recent export.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_issues_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_issues_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
     /// The export settings for issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue: Option<Box<GoogleSheetsExportSettings>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue: MaybeUndefined<GoogleSheetsExportSettings>,
     /// The export settings for projects.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project: Option<Box<GoogleSheetsExportSettings>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<GoogleSheetsExportSettings>,
     /// The export settings for initiatives.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative: Option<Box<GoogleSheetsExportSettings>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative: MaybeUndefined<GoogleSheetsExportSettings>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct GoogleUserAccountAuthInput {
     /// Code returned from Google's OAuth flow.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub code: Option<String>,
+    pub code: String,
     /// The URI to redirect the user to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub redirect_uri: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub redirect_uri: MaybeUndefined<String>,
     /// The timezone of the user's browser.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub timezone: Option<String>,
-    /// An optional invite link for an organization used to populate available organizations.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub invite_link: Option<String>,
+    pub timezone: String,
+    /// An optional invite link for a workspace used to populate available workspaces.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub invite_link: MaybeUndefined<String>,
     /// An optional parameter to disable new user signup and force login. Default: false.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub disallow_signup: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub disallow_signup: MaybeUndefined<bool>,
+    /// PostHog session ID for attribution tracking.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub session_id: MaybeUndefined<String>,
 }
 /// Comparator for identifiers.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IDComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<String>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<String>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<String>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<String>>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InheritanceEntityMapping {
     /// Mapping of the WorkflowState ID to the new WorkflowState ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub workflow_states: Option<serde_json::Value>,
+    pub workflow_states: serde_json::Value,
     /// Mapping of the IssueLabel ID to the new IssueLabel name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_labels: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_labels: MaybeUndefined<serde_json::Value>,
 }
 /// Initiative collection filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the initiative name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the initiative slug ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slug_id: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slug_id: MaybeUndefined<StringComparator>,
     /// Filters that the initiative creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<NullableUserFilter>>,
     /// Comparator for the initiative status: Planned, Active, Completed
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status: MaybeUndefined<StringComparator>,
     /// Filters that the initiative teams must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub teams: Option<Box<TeamCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub teams: MaybeUndefined<Box<TeamCollectionFilter>>,
     /// Filters that the initiative owner must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner: MaybeUndefined<Box<NullableUserFilter>>,
     /// Comparator for the initiative target date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<NullableDateComparator>,
+    /// Comparator for the initiative started at date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub started_at: MaybeUndefined<NullableDateComparator>,
+    /// Comparator for the initiative completed at date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the initiative health: onTrack, atRisk, offTrack
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health: MaybeUndefined<StringComparator>,
     /// Comparator for the initiative health (with age): onTrack, atRisk, offTrack, outdated, noUpdate
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health_with_age: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health_with_age: MaybeUndefined<StringComparator>,
     /// Comparator for the initiative activity type.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub activity_type: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub activity_type: MaybeUndefined<StringComparator>,
     /// Filters that the initiative must be an ancestor of.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ancestors: Option<Box<InitiativeCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ancestors: MaybeUndefined<Box<InitiativeCollectionFilter>>,
+    /// Filters that the initiative updates must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_updates: MaybeUndefined<InitiativeUpdatesCollectionFilter>,
     /// Compound filters, all of which need to be matched by the initiative.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<InitiativeCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<InitiativeCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the initiative.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<InitiativeCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<InitiativeCollectionFilter>>,
     /// Filters that needs to be matched by some initiatives.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<InitiativeFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<Box<InitiativeFilter>>,
     /// Filters that needs to be matched by all initiatives.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<InitiativeFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<Box<InitiativeFilter>>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
 }
 /// The properties of the initiative to create.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The name of the initiative.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The description of the initiative.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The owner of the initiative.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner_id: Option<String>,
-    /// The sort order of the initiative within the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner_id: MaybeUndefined<String>,
+    /// The sort order of the initiative within the workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
     /// The initiative's color.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// The initiative's icon.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub icon: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub icon: MaybeUndefined<String>,
     /// The initiative's status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status: Option<InitiativeStatus>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status: MaybeUndefined<InitiativeStatus>,
     /// The estimated completion date of the initiative.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<chrono::NaiveDate>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<chrono::NaiveDate>,
     /// The resolution of the initiative's estimated completion date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date_resolution: Option<DateResolutionType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date_resolution: MaybeUndefined<DateResolutionType>,
     /// The initiative's content in markdown format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub content: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub content: MaybeUndefined<String>,
 }
 /// Initiative creation date sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeCreatedAtSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Initiative filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the initiative name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the initiative slug ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slug_id: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slug_id: MaybeUndefined<StringComparator>,
     /// Filters that the initiative creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<NullableUserFilter>>,
     /// Comparator for the initiative status: Planned, Active, Completed
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status: MaybeUndefined<StringComparator>,
     /// Filters that the initiative teams must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub teams: Option<Box<TeamCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub teams: MaybeUndefined<Box<TeamCollectionFilter>>,
     /// Filters that the initiative owner must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner: MaybeUndefined<Box<NullableUserFilter>>,
     /// Comparator for the initiative target date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<NullableDateComparator>,
+    /// Comparator for the initiative started at date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub started_at: MaybeUndefined<NullableDateComparator>,
+    /// Comparator for the initiative completed at date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the initiative health: onTrack, atRisk, offTrack
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health: MaybeUndefined<StringComparator>,
     /// Comparator for the initiative health (with age): onTrack, atRisk, offTrack, outdated, noUpdate
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health_with_age: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health_with_age: MaybeUndefined<StringComparator>,
     /// Comparator for the initiative activity type.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub activity_type: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub activity_type: MaybeUndefined<StringComparator>,
     /// Filters that the initiative must be an ancestor of.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ancestors: Option<Box<InitiativeCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ancestors: MaybeUndefined<Box<InitiativeCollectionFilter>>,
+    /// Filters that the initiative updates must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_updates: MaybeUndefined<InitiativeUpdatesCollectionFilter>,
     /// Compound filters, all of which need to be matched by the initiative.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<InitiativeFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<InitiativeFilter>>,
     /// Compound filters, one of which need to be matched by the initiative.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<InitiativeFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<InitiativeFilter>>,
 }
 /// Initiative health sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeHealthSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Initiative health update date sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeHealthUpdatedAtSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Initiative manual sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeManualSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Initiative name sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeNameSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Initiative owner sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeOwnerSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
+/// Input for creating a parent-child relationship between two initiatives. The initiativeId is the parent and the relatedInitiativeId is the child.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeRelationCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
-    /// The identifier of the parent initiative.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_id: Option<String>,
-    /// The identifier of the child initiative.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub related_initiative_id: Option<String>,
-    /// The sort order of the initiative relation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
+    /// The identifier of the parent initiative in the hierarchy.
+    pub initiative_id: String,
+    /// The identifier of the child initiative in the hierarchy.
+    pub related_initiative_id: String,
+    /// The sort order of the child initiative within its parent.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
 }
-/// The properties of the initiativeRelation to update.
+/// The properties of the initiative relation to update.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeRelationUpdateInput {
-    /// The sort order of the initiative relation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    /// The sort order of the child initiative within its parent.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
 }
 /// Initiative sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeSortInput {
     /// Sort by initiative name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<InitiativeNameSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<InitiativeNameSort>,
     /// Sort by manual order.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub manual: Option<Box<InitiativeManualSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub manual: MaybeUndefined<InitiativeManualSort>,
     /// Sort by initiative update date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<InitiativeUpdatedAtSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<InitiativeUpdatedAtSort>,
     /// Sort by initiative creation date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<InitiativeCreatedAtSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<InitiativeCreatedAtSort>,
     /// Sort by initiative target date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<Box<InitiativeTargetDateSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<InitiativeTargetDateSort>,
     /// Sort by initiative health status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health: Option<Box<InitiativeHealthSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health: MaybeUndefined<InitiativeHealthSort>,
     /// Sort by initiative health update date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health_updated_at: Option<Box<InitiativeHealthUpdatedAtSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health_updated_at: MaybeUndefined<InitiativeHealthUpdatedAtSort>,
     /// Sort by initiative owner name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner: Option<Box<InitiativeOwnerSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner: MaybeUndefined<InitiativeOwnerSort>,
 }
 /// Initiative target date sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeTargetDateSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// The properties of the initiativeToProject to create.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeToProjectCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The identifier of the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    pub project_id: String,
     /// The identifier of the initiative.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_id: Option<String>,
-    /// The sort order for the project within its organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    pub initiative_id: String,
+    /// The sort order for the project within the initiative.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
 }
-/// The properties of the initiativeToProject to update.
+/// The properties of the initiative-to-project association to update.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeToProjectUpdateInput {
-    /// The sort order for the project within its organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    /// The sort order for the project within the initiative.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
 }
+/// Input for creating a new initiative update.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeUpdateCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The content of the update in markdown format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body: MaybeUndefined<String>,
     /// `Internal` The content of the update as a Prosemirror document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body_data: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body_data: MaybeUndefined<serde_json::Value>,
     /// The health of the initiative at the time of the update.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health: Option<InitiativeUpdateHealthType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health: MaybeUndefined<InitiativeUpdateHealthType>,
     /// The initiative to associate the update with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_id: Option<String>,
+    pub initiative_id: String,
     /// Whether the diff between the current update and the previous one should be hidden.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_diff_hidden: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_diff_hidden: MaybeUndefined<bool>,
 }
 /// Options for filtering initiative updates.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeUpdateFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Filters that the initiative update creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub user: MaybeUndefined<UserFilter>,
     /// Filters that the initiative update initiative must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative: Option<Box<InitiativeFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative: MaybeUndefined<InitiativeFilter>,
     /// Filters that the initiative updates reactions must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub reactions: Option<Box<ReactionCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reactions: MaybeUndefined<ReactionCollectionFilter>,
     /// Compound filters, all of which need to be matched by the InitiativeUpdate.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<InitiativeUpdateFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<InitiativeUpdateFilter>>,
     /// Compound filters, one of which need to be matched by the InitiativeUpdate.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<InitiativeUpdateFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<InitiativeUpdateFilter>>,
 }
 /// The properties of the initiative to update.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeUpdateInput {
     /// The name of the initiative.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The description of the initiative.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The owner of the initiative.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner_id: Option<String>,
-    /// The sort order of the initiative within the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner_id: MaybeUndefined<String>,
+    /// The sort order of the initiative within the workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
     /// The initiative's color.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// The initiative's icon.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub icon: Option<String>,
-    /// The estimated completion date of the initiative.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<chrono::NaiveDate>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub icon: MaybeUndefined<String>,
+    /// The estimated completion date of the initiative. Set to null to clear.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<chrono::NaiveDate>,
     /// The initiative's status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status: Option<InitiativeStatus>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status: MaybeUndefined<InitiativeStatus>,
     /// The resolution of the initiative's estimated completion date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date_resolution: Option<DateResolutionType>,
-    /// Whether the initiative has been trashed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub trashed: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date_resolution: MaybeUndefined<DateResolutionType>,
+    /// Whether the initiative has been trashed. Set to true to trash, or null to restore.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub trashed: MaybeUndefined<bool>,
     /// The initiative's content in markdown format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub content: Option<String>,
-    /// The n-weekly frequency at which to prompt for updates. When not set, reminders are inherited from workspace.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub update_reminder_frequency_in_weeks: Option<f64>,
-    /// The frequency at which to prompt for updates. When not set, reminders are inherited from workspace.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub update_reminder_frequency: Option<f64>,
-    /// The frequency resolution.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub frequency_resolution: Option<FrequencyResolutionType>,
-    /// The day at which to prompt for updates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub update_reminders_day: Option<Day>,
-    /// The hour at which to prompt for updates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub update_reminders_hour: Option<i64>,
-}
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub content: MaybeUndefined<String>,
+    /// The n-weekly frequency at which to prompt for initiative updates. When not set, reminders are inherited from workspace settings.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub update_reminder_frequency_in_weeks: MaybeUndefined<f64>,
+    /// The frequency at which to prompt for initiative updates. When not set, reminders are inherited from workspace settings.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub update_reminder_frequency: MaybeUndefined<f64>,
+    /// The resolution type for the update reminder frequency (e.g., weekly, biweekly).
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub frequency_resolution: MaybeUndefined<FrequencyResolutionType>,
+    /// The day of the week on which to prompt for initiative updates.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub update_reminders_day: MaybeUndefined<Day>,
+    /// The hour of the day (0-23) at which to prompt for initiative updates.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub update_reminders_hour: MaybeUndefined<i64>,
+}
+/// Input for updating an existing initiative update.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeUpdateUpdateInput {
     /// The content of the update in markdown format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body: MaybeUndefined<String>,
     /// The content of the update as a Prosemirror document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body_data: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body_data: MaybeUndefined<serde_json::Value>,
     /// The health of the initiative at the time of the update.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health: Option<InitiativeUpdateHealthType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health: MaybeUndefined<InitiativeUpdateHealthType>,
     /// Whether the diff between the current update and the previous one should be hidden.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_diff_hidden: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_diff_hidden: MaybeUndefined<bool>,
 }
 /// Initiative update date sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct InitiativeUpdatedAtSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
+}
+/// Collection filtering options for filtering initiatives by initiative updates.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct InitiativeUpdatesCollectionFilter {
+    /// Comparator for the identifier.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
+    /// Comparator for the created at date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
+    /// Comparator for the updated at date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
+    /// Compound filters, all of which need to be matched by the initiative update.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<InitiativeUpdatesCollectionFilter>>,
+    /// Compound filters, one of which need to be matched by the update.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<InitiativeUpdatesCollectionFilter>>,
+    /// Filters that needs to be matched by some initiative updates.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<InitiativeUpdatesFilter>,
+    /// Filters that needs to be matched by all initiative updates.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<InitiativeUpdatesFilter>,
+    /// Comparator for the collection length.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
+}
+/// Options for filtering initiatives by initiative updates.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct InitiativeUpdatesFilter {
+    /// Comparator for the identifier.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
+    /// Comparator for the created at date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
+    /// Comparator for the updated at date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
+    /// Compound filters, all of which need to be matched by the initiative updates.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<InitiativeUpdatesFilter>>,
+    /// Compound filters, one of which need to be matched by the initiative updates.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<InitiativeUpdatesFilter>>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IntegrationCustomerDataAttributesRefreshInput {
     /// The integration service to refresh customer data attributes from.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub service: Option<String>,
+    pub service: String,
 }
+/// Input for requesting a currently unavailable integration.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IntegrationRequestInput {
     /// Email associated with the request.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub email: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub email: MaybeUndefined<String>,
     /// Name of the requested integration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IntegrationSettingsInput {
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack: Option<Box<SlackSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_asks: Option<Box<SlackAsksSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_post: Option<Box<SlackPostSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_project_post: Option<Box<SlackPostSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_initiative_post: Option<Box<SlackPostSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_custom_view_notifications: Option<Box<SlackPostSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_org_project_updates_post: Option<Box<SlackPostSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_org_initiative_updates_post: Option<Box<SlackPostSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub google_sheets: Option<Box<GoogleSheetsSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub git_hub: Option<Box<GitHubSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub git_hub_import: Option<Box<GitHubImportSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub git_hub_personal: Option<Box<GitHubPersonalSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub git_lab: Option<Box<GitLabSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sentry: Option<Box<SentrySettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub zendesk: Option<Box<ZendeskSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub intercom: Option<Box<IntercomSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub front: Option<Box<FrontSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub gong: Option<Box<GongSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub microsoft_teams: Option<Box<MicrosoftTeamsSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub jira: Option<Box<JiraSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub notion: Option<Box<NotionSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub opsgenie: Option<Box<OpsgenieInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub pager_duty: Option<Box<PagerDutyInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub launch_darkly: Option<Box<LaunchDarklySettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub jira_personal: Option<Box<JiraPersonalSettingsInput>>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub salesforce: Option<Box<SalesforceSettingsInput>>,
-}
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack: MaybeUndefined<SlackSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_asks: MaybeUndefined<SlackAsksSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_post: MaybeUndefined<SlackPostSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_project_post: MaybeUndefined<SlackPostSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_initiative_post: MaybeUndefined<SlackPostSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_custom_view_notifications: MaybeUndefined<SlackPostSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_org_project_updates_post: MaybeUndefined<SlackPostSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_org_initiative_updates_post: MaybeUndefined<SlackPostSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub google_sheets: MaybeUndefined<GoogleSheetsSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub git_hub: MaybeUndefined<GitHubSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub git_hub_import: MaybeUndefined<GitHubImportSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub git_hub_personal: MaybeUndefined<GitHubPersonalSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub git_lab: MaybeUndefined<GitLabSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sentry: MaybeUndefined<SentrySettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub zendesk: MaybeUndefined<ZendeskSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub intercom: MaybeUndefined<IntercomSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub front: MaybeUndefined<FrontSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub gong: MaybeUndefined<GongSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub microsoft_teams: MaybeUndefined<MicrosoftTeamsSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub microsoft_teams_project_post: MaybeUndefined<MicrosoftTeamsPostSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub jira: MaybeUndefined<JiraSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub notion: MaybeUndefined<NotionSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub opsgenie: MaybeUndefined<OpsgenieInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub pager_duty: MaybeUndefined<PagerDutyInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub launch_darkly: MaybeUndefined<LaunchDarklySettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub jira_personal: MaybeUndefined<JiraPersonalSettingsInput>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub salesforce: MaybeUndefined<SalesforceSettingsInput>,
+}
+/// Input for creating a new integration template.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IntegrationTemplateCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The identifier of the integration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub integration_id: Option<String>,
+    pub integration_id: String,
     /// The identifier of the template.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub template_id: Option<String>,
+    pub template_id: String,
     /// The foreign identifier in the other service.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub foreign_entity_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub foreign_entity_id: MaybeUndefined<String>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IntegrationUpdateInput {
     /// The settings to update.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub settings: Option<Box<IntegrationSettingsInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub settings: MaybeUndefined<IntegrationSettingsInput>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IntegrationsSettingsCreateInput {
     /// Whether to send a Slack message when a new issue is created for the project or the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_created: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_created: MaybeUndefined<bool>,
     /// Whether to send a Slack message when an issue is added to a view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_added_to_view: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_added_to_view: MaybeUndefined<bool>,
     /// Whether to send a Slack message when a comment is created on any of the project or team's issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_new_comment: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_new_comment: MaybeUndefined<bool>,
     /// Whether to send a Slack message when any of the project or team's issues change to completed or cancelled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_status_changed_done: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_status_changed_done: MaybeUndefined<bool>,
     /// Whether to send a Slack message when any of the project or team's issues has a change in status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_status_changed_all: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_status_changed_all: MaybeUndefined<bool>,
     /// Whether to send a Slack message when a project update is created.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_project_update_created: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_project_update_created: MaybeUndefined<bool>,
+    /// Whether to send a Microsoft Teams message when a project update is created.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub microsoft_teams_project_update_created: MaybeUndefined<bool>,
     /// Whether to send a Slack message when a project update is created to team channels.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_project_update_created_to_team: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_project_update_created_to_team: MaybeUndefined<bool>,
     /// Whether to send a Slack message when a project update is created to workspace channel.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_project_update_created_to_workspace: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_project_update_created_to_workspace: MaybeUndefined<bool>,
     /// Whether to send a Slack message when an initiative update is created.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_initiative_update_created: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_initiative_update_created: MaybeUndefined<bool>,
     /// Whether to send a Slack message when a new issue is added to triage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_added_to_triage: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_added_to_triage: MaybeUndefined<bool>,
     /// Whether to send a Slack message when an SLA is at high risk.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_sla_high_risk: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_sla_high_risk: MaybeUndefined<bool>,
     /// Whether to receive notification when an SLA has breached on Slack.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_sla_breached: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_sla_breached: MaybeUndefined<bool>,
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The identifier of the team to create settings for.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
     /// The identifier of the project to create settings for.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
     /// The identifier of the initiative to create settings for.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_id: MaybeUndefined<String>,
     /// The identifier of the custom view to create settings for.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub custom_view_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub custom_view_id: MaybeUndefined<String>,
     /// The type of view to which the integration settings context is associated with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub context_view_type: Option<ContextViewType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub context_view_type: MaybeUndefined<ContextViewType>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IntegrationsSettingsUpdateInput {
     /// Whether to send a Slack message when a new issue is created for the project or the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_created: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_created: MaybeUndefined<bool>,
     /// Whether to send a Slack message when an issue is added to a view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_added_to_view: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_added_to_view: MaybeUndefined<bool>,
     /// Whether to send a Slack message when a comment is created on any of the project or team's issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_new_comment: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_new_comment: MaybeUndefined<bool>,
     /// Whether to send a Slack message when any of the project or team's issues change to completed or cancelled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_status_changed_done: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_status_changed_done: MaybeUndefined<bool>,
     /// Whether to send a Slack message when any of the project or team's issues has a change in status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_status_changed_all: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_status_changed_all: MaybeUndefined<bool>,
     /// Whether to send a Slack message when a project update is created.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_project_update_created: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_project_update_created: MaybeUndefined<bool>,
+    /// Whether to send a Microsoft Teams message when a project update is created.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub microsoft_teams_project_update_created: MaybeUndefined<bool>,
     /// Whether to send a Slack message when a project update is created to team channels.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_project_update_created_to_team: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_project_update_created_to_team: MaybeUndefined<bool>,
     /// Whether to send a Slack message when a project update is created to workspace channel.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_project_update_created_to_workspace: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_project_update_created_to_workspace: MaybeUndefined<bool>,
     /// Whether to send a Slack message when an initiative update is created.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_initiative_update_created: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_initiative_update_created: MaybeUndefined<bool>,
     /// Whether to send a Slack message when a new issue is added to triage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_added_to_triage: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_added_to_triage: MaybeUndefined<bool>,
     /// Whether to send a Slack message when an SLA is at high risk.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_sla_high_risk: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_sla_high_risk: MaybeUndefined<bool>,
     /// Whether to receive notification when an SLA has breached on Slack.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_sla_breached: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_sla_breached: MaybeUndefined<bool>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IntercomSettingsInput {
     /// Whether an internal message should be added when a Linear issue changes status (for status types except completed or canceled).
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub send_note_on_status_change: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub send_note_on_status_change: MaybeUndefined<bool>,
     /// Whether an internal message should be added when someone comments on an issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub send_note_on_comment: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub send_note_on_comment: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when its linked Linear issue is completed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_completion: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_completion: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when its linked Linear issue is cancelled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_cancellation: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_cancellation: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when a comment is posted on its linked Linear issue
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_comment: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_comment: MaybeUndefined<bool>,
     /// `ALPHA` Whether customer and customer requests should not be automatically created when conversations are linked to a Linear issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub disable_customer_requests_auto_creation: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub disable_customer_requests_auto_creation: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when its linked Linear project is completed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_project_completion: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_project_completion: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when its linked Linear project is cancelled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_project_cancellation: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_project_cancellation: MaybeUndefined<bool>,
     /// Whether Linear Agent should be enabled for this integration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enable_ai_intake: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enable_ai_intake: MaybeUndefined<bool>,
 }
+/// Input for creating multiple issues at once in a batch operation. Up to 50 issues can be created in a single batch.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueBatchCreateInput {
     /// The issues to create.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issues: Option<Vec<Box<IssueCreateInput>>>,
+    pub issues: Vec<IssueCreateInput>,
 }
 /// Issue filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IssueIDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IssueIDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the issues number.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub number: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub number: MaybeUndefined<NumberComparator>,
     /// Comparator for the issues title.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub title: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub title: MaybeUndefined<StringComparator>,
     /// Comparator for the issues description.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<Box<NullableStringComparator>>,
-    /// Comparator for the issues priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority: Option<Box<NullableNumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<NullableStringComparator>,
+    /// Comparator for the issues priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority: MaybeUndefined<NullableNumberComparator>,
     /// Comparator for the issues estimate.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub estimate: Option<Box<EstimateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub estimate: MaybeUndefined<EstimateComparator>,
     /// Comparator for the issues started at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub started_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub started_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues triaged at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub triaged_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub triaged_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues completed at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub completed_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues canceled at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub canceled_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub canceled_at: MaybeUndefined<NullableDateComparator>,
+    /// Comparator for the issue's SLA breach date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sla_breaches_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues archived at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub archived_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub archived_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues auto closed at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_closed_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_closed_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues auto archived at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_archived_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_archived_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues added to cycle at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub added_to_cycle_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub added_to_cycle_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the period when issue was added to a cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub added_to_cycle_period: Option<Box<CyclePeriodComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub added_to_cycle_period: MaybeUndefined<CyclePeriodComparator>,
     /// Comparator for the issues due date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub due_date: Option<Box<NullableTimelessDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub due_date: MaybeUndefined<NullableTimelessDateComparator>,
     /// `Internal` Comparator for the issue's accumulatedStateUpdatedAt date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub accumulated_state_updated_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub accumulated_state_updated_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues snoozed until date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub snoozed_until_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub snoozed_until_at: MaybeUndefined<NullableDateComparator>,
     /// Filters that the issues assignee must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub assignee: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub assignee: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the issue's delegated agent must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub delegate: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub delegate: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the last applied template must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub last_applied_template: Option<Box<NullableTemplateFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub last_applied_template: MaybeUndefined<NullableTemplateFilter>,
     /// `ALPHA` Filters that the recurring issue template must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub recurring_issue_template: Option<Box<NullableTemplateFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub recurring_issue_template: MaybeUndefined<NullableTemplateFilter>,
     /// Filters that the source must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub source_metadata: Option<Box<SourceMetadataComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub source_metadata: MaybeUndefined<SourceMetadataComparator>,
     /// Filters that the issues creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the issue parent must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent: Option<Box<NullableIssueFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent: MaybeUndefined<Box<NullableIssueFilter>>,
     /// Filters that the issues snoozer must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub snoozed_by: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub snoozed_by: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that issue labels must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub labels: Option<Box<IssueLabelCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub labels: MaybeUndefined<Box<IssueLabelCollectionFilter>>,
     /// Filters that issue subscribers must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subscribers: Option<Box<UserCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subscribers: MaybeUndefined<Box<UserCollectionFilter>>,
     /// Comparator for filtering issues which have been shared with users outside of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_shared_users: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_shared_users: MaybeUndefined<RelationExistsComparator>,
     /// Filters that users the issue has been shared with must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub shared_with: Option<Box<UserCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub shared_with: MaybeUndefined<Box<UserCollectionFilter>>,
     /// Filters that the issues team must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team: Option<Box<TeamFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team: MaybeUndefined<Box<TeamFilter>>,
     /// Filters that the issues project milestone must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_milestone: Option<Box<NullableProjectMilestoneFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_milestone: MaybeUndefined<Box<NullableProjectMilestoneFilter>>,
     /// Filters that the issues comments must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub comments: Option<Box<CommentCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub comments: MaybeUndefined<Box<CommentCollectionFilter>>,
     /// Filters that the issue's activities must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub activity: Option<Box<ActivityCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub activity: MaybeUndefined<Box<ActivityCollectionFilter>>,
     /// `Internal` Filters that the issue's suggestions must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub suggestions: Option<Box<IssueSuggestionCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub suggestions: MaybeUndefined<Box<IssueSuggestionCollectionFilter>>,
     /// Filters that the issues cycle must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle: Option<Box<NullableCycleFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle: MaybeUndefined<Box<NullableCycleFilter>>,
     /// Filters that the issues project must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project: Option<Box<NullableProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<Box<NullableProjectFilter>>,
     /// Filters that the issues state must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub state: Option<Box<WorkflowStateFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub state: MaybeUndefined<Box<WorkflowStateFilter>>,
     /// Filters that the child issues must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub children: Option<Box<IssueCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub children: MaybeUndefined<Box<IssueCollectionFilter>>,
     /// Filters that the issues attachments must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub attachments: Option<Box<AttachmentCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub attachments: MaybeUndefined<Box<AttachmentCollectionFilter>>,
     /// `Internal` Comparator for the issues content.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub searchable_content: Option<Box<ContentComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub searchable_content: MaybeUndefined<ContentComparator>,
     /// Comparator for filtering issues with relations.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_related_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_related_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering issues which are duplicates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_duplicate_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_duplicate_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering issues which are blocked.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_blocked_by_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_blocked_by_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering issues which are blocking.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_blocking_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_blocking_relations: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested related issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_related_issues: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_related_issues: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested similar issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_similar_issues: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_similar_issues: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested assignees.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_assignees: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_assignees: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested projects.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_projects: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_projects: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested labels.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_labels: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_labels: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_teams: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_teams: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for the issues sla status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sla_status: Option<Box<SlaStatusComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sla_status: MaybeUndefined<SlaStatusComparator>,
     /// Filters that the issues reactions must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub reactions: Option<Box<ReactionCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reactions: MaybeUndefined<ReactionCollectionFilter>,
     /// Filters that the issue's customer needs must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub needs: Option<Box<CustomerNeedCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub needs: MaybeUndefined<Box<CustomerNeedCollectionFilter>>,
     /// `ALPHA` Filters that the issue's releases must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub releases: Option<Box<ReleaseCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub releases: MaybeUndefined<Box<ReleaseCollectionFilter>>,
     /// Count of customers
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_count: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_count: MaybeUndefined<NumberComparator>,
     /// Count of important customers
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_important_count: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_important_count: MaybeUndefined<NumberComparator>,
     /// `Internal` Lead time (created -> completed) comparator.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lead_time: Option<Box<NullableDurationComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lead_time: MaybeUndefined<NullableDurationComparator>,
     /// `Internal` Cycle time (started -> completed) comparator.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_time: Option<Box<NullableDurationComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_time: MaybeUndefined<NullableDurationComparator>,
     /// `Internal` Age (created -> now) comparator, defined if the issue is still open.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub age_time: Option<Box<NullableDurationComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub age_time: MaybeUndefined<NullableDurationComparator>,
     /// `Internal` Triage time (entered triaged -> triaged) comparator.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub triage_time: Option<Box<NullableDurationComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub triage_time: MaybeUndefined<NullableDurationComparator>,
     /// Compound filters, all of which need to be matched by the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<IssueCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<IssueCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<IssueCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<IssueCollectionFilter>>,
     /// Filters that needs to be matched by some issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<IssueFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<Box<IssueFilter>>,
     /// Filters that needs to be matched by all issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<IssueFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<Box<IssueFilter>>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
 }
+/// Input for creating a new issue. At minimum, a team must be specified. A title is required unless a template is provided. All other fields are optional and will use defaults from the team or template if not specified.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The title of the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub title: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub title: MaybeUndefined<String>,
     /// The issue description in markdown format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// `Internal` The issue description as a Prosemirror document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description_data: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description_data: MaybeUndefined<serde_json::Value>,
     /// The identifier of the user to assign the issue to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub assignee_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub assignee_id: MaybeUndefined<String>,
     /// The identifier of the agent user to delegate the issue to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub delegate_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub delegate_id: MaybeUndefined<String>,
     /// The identifier of the parent issue. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent_id: Option<String>,
-    /// The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority: Option<i64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent_id: MaybeUndefined<String>,
+    /// The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority: MaybeUndefined<i64>,
     /// The estimated complexity of the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub estimate: Option<i64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub estimate: MaybeUndefined<i64>,
     /// The identifiers of the users subscribing to this ticket.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subscriber_ids: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subscriber_ids: MaybeUndefined<Vec<String>>,
     /// The identifiers of the issue labels associated with this ticket.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label_ids: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub label_ids: MaybeUndefined<Vec<String>>,
     /// The identifier of the team associated with the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    pub team_id: String,
     /// The cycle associated with the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_id: MaybeUndefined<String>,
     /// The project associated with the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
     /// The project milestone associated with the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_milestone_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_milestone_id: MaybeUndefined<String>,
     /// The ID of the last template applied to the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub last_applied_template_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub last_applied_template_id: MaybeUndefined<String>,
     /// The team state of the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub state_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub state_id: MaybeUndefined<String>,
     /// The comment the issue is referencing.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub reference_comment_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reference_comment_id: MaybeUndefined<String>,
     /// The comment the issue is created from.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub source_comment_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub source_comment_id: MaybeUndefined<String>,
     /// `Internal` The pull request comment the issue is created from.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub source_pull_request_comment_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub source_pull_request_comment_id: MaybeUndefined<String>,
     /// The position of the issue related to other issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
     /// The position of the issue related to other issues, when ordered by priority.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority_sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority_sort_order: MaybeUndefined<f64>,
     /// The position of the issue in parent's sub-issue list.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sub_issue_sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sub_issue_sort_order: MaybeUndefined<f64>,
     /// The date at which the issue is due.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub due_date: Option<chrono::NaiveDate>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub due_date: MaybeUndefined<chrono::NaiveDate>,
     /// Create issue as a user with the provided name. This option is only available to OAuth applications creating issues in `actor=app` mode.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub create_as_user: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub create_as_user: MaybeUndefined<String>,
     /// Provide an external user avatar URL. Can only be used in conjunction with the `createAsUser` options. This option is only available to OAuth applications creating comments in `actor=app` mode.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub display_icon_url: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub display_icon_url: MaybeUndefined<String>,
     /// Whether the passed sort order should be preserved.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub preserve_sort_order_on_create: Option<bool>,
-    /// The date when the issue was created (e.g. if importing from another system). Must be a date in the past. If none is provided, the backend will generate the time as now.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// `Internal` The timestamp at which an issue will be considered in breach of SLA.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sla_breaches_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// `Internal` The timestamp at which the issue's SLA was started.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sla_started_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub preserve_sort_order_on_create: MaybeUndefined<bool>,
+    /// The time at which the issue was created (e.g. if importing from another system). Must be a time in the past. If none is provided, the backend will generate the time as now.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
+    /// `Internal` The time at which an issue will be considered in breach of SLA.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sla_breaches_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
+    /// `Internal` The time at which the issue's SLA was started.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sla_started_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
     /// The identifier of a template the issue should be created from. If other values are provided in the input, they will override template values.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub template_id: Option<String>,
-    /// The date when the issue was completed (e.g. if importing from another system). Must be a date in the past and after createdAt date. Cannot be provided with an incompatible workflow state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub completed_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub template_id: MaybeUndefined<String>,
+    /// The time at which the issue was completed (e.g. if importing from another system). Must be a time in the past and after createdAt. Cannot be provided with an incompatible workflow state.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
     /// The SLA day count type for the issue. Whether SLA should be business days only or calendar days (default).
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sla_type: Option<SLADayCountType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sla_type: MaybeUndefined<SLADayCountType>,
     /// Whether to use the default template for the team. When set to true, the default template of this team based on user's membership will be applied.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub use_default_template: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub use_default_template: MaybeUndefined<bool>,
+    /// `ALPHA` The identifiers of the releases to associate with this issue.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub release_ids: MaybeUndefined<Vec<String>>,
+    /// `Internal` Whether this issue should inherit shared access from its parent issue. Set to false to opt out of automatic shared access inheritance when creating a sub-issue.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub inherits_shared_access: MaybeUndefined<bool>,
 }
 /// Issue filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IssueIDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IssueIDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the issues number.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub number: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub number: MaybeUndefined<NumberComparator>,
     /// Comparator for the issues title.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub title: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub title: MaybeUndefined<StringComparator>,
     /// Comparator for the issues description.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<Box<NullableStringComparator>>,
-    /// Comparator for the issues priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority: Option<Box<NullableNumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<NullableStringComparator>,
+    /// Comparator for the issues priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority: MaybeUndefined<NullableNumberComparator>,
     /// Comparator for the issues estimate.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub estimate: Option<Box<EstimateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub estimate: MaybeUndefined<EstimateComparator>,
     /// Comparator for the issues started at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub started_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub started_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues triaged at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub triaged_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub triaged_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues completed at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub completed_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues canceled at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub canceled_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub canceled_at: MaybeUndefined<NullableDateComparator>,
+    /// Comparator for the issue's SLA breach date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sla_breaches_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues archived at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub archived_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub archived_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues auto closed at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_closed_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_closed_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues auto archived at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_archived_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_archived_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues added to cycle at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub added_to_cycle_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub added_to_cycle_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the period when issue was added to a cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub added_to_cycle_period: Option<Box<CyclePeriodComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub added_to_cycle_period: MaybeUndefined<CyclePeriodComparator>,
     /// Comparator for the issues due date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub due_date: Option<Box<NullableTimelessDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub due_date: MaybeUndefined<NullableTimelessDateComparator>,
     /// `Internal` Comparator for the issue's accumulatedStateUpdatedAt date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub accumulated_state_updated_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub accumulated_state_updated_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues snoozed until date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub snoozed_until_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub snoozed_until_at: MaybeUndefined<NullableDateComparator>,
     /// Filters that the issues assignee must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub assignee: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub assignee: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the issue's delegated agent must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub delegate: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub delegate: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the last applied template must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub last_applied_template: Option<Box<NullableTemplateFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub last_applied_template: MaybeUndefined<NullableTemplateFilter>,
     /// `ALPHA` Filters that the recurring issue template must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub recurring_issue_template: Option<Box<NullableTemplateFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub recurring_issue_template: MaybeUndefined<NullableTemplateFilter>,
     /// Filters that the source must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub source_metadata: Option<Box<SourceMetadataComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub source_metadata: MaybeUndefined<SourceMetadataComparator>,
     /// Filters that the issues creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the issue parent must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent: Option<Box<NullableIssueFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent: MaybeUndefined<Box<NullableIssueFilter>>,
     /// Filters that the issues snoozer must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub snoozed_by: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub snoozed_by: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that issue labels must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub labels: Option<Box<IssueLabelCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub labels: MaybeUndefined<Box<IssueLabelCollectionFilter>>,
     /// Filters that issue subscribers must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subscribers: Option<Box<UserCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subscribers: MaybeUndefined<Box<UserCollectionFilter>>,
     /// Comparator for filtering issues which have been shared with users outside of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_shared_users: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_shared_users: MaybeUndefined<RelationExistsComparator>,
     /// Filters that users the issue has been shared with must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub shared_with: Option<Box<UserCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub shared_with: MaybeUndefined<Box<UserCollectionFilter>>,
     /// Filters that the issues team must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team: Option<Box<TeamFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team: MaybeUndefined<Box<TeamFilter>>,
     /// Filters that the issues project milestone must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_milestone: Option<Box<NullableProjectMilestoneFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_milestone: MaybeUndefined<Box<NullableProjectMilestoneFilter>>,
     /// Filters that the issues comments must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub comments: Option<Box<CommentCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub comments: MaybeUndefined<Box<CommentCollectionFilter>>,
     /// Filters that the issue's activities must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub activity: Option<Box<ActivityCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub activity: MaybeUndefined<Box<ActivityCollectionFilter>>,
     /// `Internal` Filters that the issue's suggestions must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub suggestions: Option<Box<IssueSuggestionCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub suggestions: MaybeUndefined<Box<IssueSuggestionCollectionFilter>>,
     /// Filters that the issues cycle must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle: Option<Box<NullableCycleFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle: MaybeUndefined<Box<NullableCycleFilter>>,
     /// Filters that the issues project must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project: Option<Box<NullableProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<Box<NullableProjectFilter>>,
     /// Filters that the issues state must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub state: Option<Box<WorkflowStateFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub state: MaybeUndefined<Box<WorkflowStateFilter>>,
     /// Filters that the child issues must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub children: Option<Box<IssueCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub children: MaybeUndefined<Box<IssueCollectionFilter>>,
     /// Filters that the issues attachments must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub attachments: Option<Box<AttachmentCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub attachments: MaybeUndefined<Box<AttachmentCollectionFilter>>,
     /// `Internal` Comparator for the issues content.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub searchable_content: Option<Box<ContentComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub searchable_content: MaybeUndefined<ContentComparator>,
     /// Comparator for filtering issues with relations.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_related_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_related_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering issues which are duplicates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_duplicate_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_duplicate_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering issues which are blocked.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_blocked_by_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_blocked_by_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering issues which are blocking.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_blocking_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_blocking_relations: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested related issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_related_issues: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_related_issues: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested similar issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_similar_issues: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_similar_issues: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested assignees.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_assignees: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_assignees: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested projects.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_projects: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_projects: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested labels.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_labels: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_labels: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_teams: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_teams: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for the issues sla status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sla_status: Option<Box<SlaStatusComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sla_status: MaybeUndefined<SlaStatusComparator>,
     /// Filters that the issues reactions must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub reactions: Option<Box<ReactionCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reactions: MaybeUndefined<ReactionCollectionFilter>,
     /// Filters that the issue's customer needs must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub needs: Option<Box<CustomerNeedCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub needs: MaybeUndefined<Box<CustomerNeedCollectionFilter>>,
     /// `ALPHA` Filters that the issue's releases must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub releases: Option<Box<ReleaseCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub releases: MaybeUndefined<Box<ReleaseCollectionFilter>>,
     /// Count of customers
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_count: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_count: MaybeUndefined<NumberComparator>,
     /// Count of important customers
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_important_count: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_important_count: MaybeUndefined<NumberComparator>,
     /// `Internal` Lead time (created -> completed) comparator.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lead_time: Option<Box<NullableDurationComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lead_time: MaybeUndefined<NullableDurationComparator>,
     /// `Internal` Cycle time (started -> completed) comparator.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_time: Option<Box<NullableDurationComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_time: MaybeUndefined<NullableDurationComparator>,
     /// `Internal` Age (created -> now) comparator, defined if the issue is still open.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub age_time: Option<Box<NullableDurationComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub age_time: MaybeUndefined<NullableDurationComparator>,
     /// `Internal` Triage time (entered triaged -> triaged) comparator.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub triage_time: Option<Box<NullableDurationComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub triage_time: MaybeUndefined<NullableDurationComparator>,
     /// Compound filters, all of which need to be matched by the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<IssueFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<IssueFilter>>,
     /// Compound filters, one of which need to be matched by the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<IssueFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<IssueFilter>>,
 }
 /// Comparator for issue identifiers.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueIDComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<String>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<String>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<String>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<String>>,
 }
+/// Input for updating an import job's mapping configuration, such as user and workflow state mappings between the source service and Linear.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueImportUpdateInput {
     /// The mapping configuration for the import.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub mapping: Option<serde_json::Value>,
+    pub mapping: serde_json::Value,
 }
 /// Issue label filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueLabelCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for whether the label is a group label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_group: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_group: MaybeUndefined<BooleanComparator>,
     /// Filters that the issue labels creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the issue labels team must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team: Option<Box<NullableTeamFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team: MaybeUndefined<Box<NullableTeamFilter>>,
     /// Filters that the issue label's parent label must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent: Option<Box<IssueLabelFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent: MaybeUndefined<Box<IssueLabelFilter>>,
     /// Filter based on the existence of the relation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Compound filters, all of which need to be matched by the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<IssueLabelCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<IssueLabelCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<IssueLabelCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<IssueLabelCollectionFilter>>,
     /// Filters that needs to be matched by some issue labels.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<IssueLabelFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<Box<IssueLabelFilter>>,
     /// Filters that needs to be matched by all issue labels.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<IssueLabelFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<Box<IssueLabelFilter>>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
 }
+/// Input for creating a new label. A name is required. If no team is specified, the label is created as a workspace-level label available to all teams.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueLabelCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The name of the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The description of the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The color of the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// The identifier of the parent label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent_id: MaybeUndefined<String>,
     /// The team associated with the label. If not given, the label will be associated with the entire workspace.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
     /// Whether the label is a group.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_group: Option<bool>,
-    /// When the label was retired.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub retired_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_group: MaybeUndefined<bool>,
+    /// The time at which the label was retired. Set to null to restore a retired label.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub retired_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
 }
 /// Issue label filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueLabelFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for whether the label is a group label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_group: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_group: MaybeUndefined<BooleanComparator>,
     /// Filters that the issue labels creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the issue labels team must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team: Option<Box<NullableTeamFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team: MaybeUndefined<Box<NullableTeamFilter>>,
     /// Filters that the issue label's parent label must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent: Option<Box<IssueLabelFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent: MaybeUndefined<Box<IssueLabelFilter>>,
     /// Compound filters, all of which need to be matched by the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<IssueLabelFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<IssueLabelFilter>>,
     /// Compound filters, one of which need to be matched by the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<IssueLabelFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<IssueLabelFilter>>,
 }
+/// Input for updating an existing label. All fields are optional; only provided fields will be updated.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueLabelUpdateInput {
     /// The name of the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The description of the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The identifier of the parent label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent_id: MaybeUndefined<String>,
     /// The color of the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// Whether the label is a group.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_group: Option<bool>,
-    /// When the label was retired.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub retired_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_group: MaybeUndefined<bool>,
+    /// The time at which the label was retired. Set to null to restore a retired label.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub retired_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
 }
-/// A reference to an issue found during release creation.
+/// A reference to an issue discovered during release sync, linking the issue identifier to the commit SHA where the reference was found.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueReferenceInput {
     /// The issue identifier (e.g. ENG-123).
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub identifier: Option<String>,
+    pub identifier: String,
     /// The commit SHA where this issue reference was found.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub commit_sha: Option<String>,
+    pub commit_sha: String,
 }
-#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+/// Input for creating a new issue relation between two issues. Both the source issue and related issue must be specified along with the relationship type.
+#[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueRelationCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The type of relation of the issue to the related issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<IssueRelationType>,
+    pub r#type: IssueRelationType,
     /// The identifier of the issue that is related to another issue. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_id: Option<String>,
+    pub issue_id: String,
     /// The identifier of the related issue. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub related_issue_id: Option<String>,
+    pub related_issue_id: String,
 }
+/// Input for updating an existing issue relation. All fields are optional; only provided fields will be updated.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueRelationUpdateInput {
     /// The type of relation of the issue to the related issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<String>,
     /// The identifier of the issue that is related to another issue. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_id: MaybeUndefined<String>,
     /// The identifier of the related issue. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub related_issue_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub related_issue_id: MaybeUndefined<String>,
 }
 /// Issue sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueSortInput {
     /// Sort by priority
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority: Option<Box<PrioritySort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority: MaybeUndefined<PrioritySort>,
     /// Sort by estimate
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub estimate: Option<Box<EstimateSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub estimate: MaybeUndefined<EstimateSort>,
     /// Sort by issue title
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub title: Option<Box<TitleSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub title: MaybeUndefined<TitleSort>,
     /// Sort by label
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label: Option<Box<LabelSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub label: MaybeUndefined<LabelSort>,
     /// Sort by label group
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label_group: Option<Box<LabelGroupSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub label_group: MaybeUndefined<LabelGroupSort>,
     /// Sort by SLA status
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sla_status: Option<Box<SlaStatusSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sla_status: MaybeUndefined<SlaStatusSort>,
     /// Sort by issue creation date
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<CreatedAtSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<CreatedAtSort>,
     /// Sort by issue update date
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<UpdatedAtSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<UpdatedAtSort>,
     /// Sort by issue completion date
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub completed_at: Option<Box<CompletedAtSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<CompletedAtSort>,
     /// Sort by issue due date
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub due_date: Option<Box<DueDateSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub due_date: MaybeUndefined<DueDateSort>,
     /// `Internal` Sort by the accumulated time in the current workflow state
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub accumulated_state_updated_at: Option<Box<TimeInStatusSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub accumulated_state_updated_at: MaybeUndefined<TimeInStatusSort>,
     /// Sort by Cycle start date
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle: Option<Box<CycleSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle: MaybeUndefined<CycleSort>,
     /// Sort by Project Milestone target date
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub milestone: Option<Box<MilestoneSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub milestone: MaybeUndefined<MilestoneSort>,
     /// Sort by assignee name
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub assignee: Option<Box<AssigneeSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub assignee: MaybeUndefined<AssigneeSort>,
     /// Sort by delegate name
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub delegate: Option<Box<DelegateSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub delegate: MaybeUndefined<DelegateSort>,
     /// Sort by Project name
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project: Option<Box<ProjectSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<ProjectSort>,
     /// Sort by Team name
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team: Option<Box<TeamSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team: MaybeUndefined<TeamSort>,
     /// Sort by manual order
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub manual: Option<Box<ManualSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub manual: MaybeUndefined<ManualSort>,
     /// Sort by workflow state type
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub workflow_state: Option<Box<WorkflowStateSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub workflow_state: MaybeUndefined<WorkflowStateSort>,
     /// Sort by customer name
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer: Option<Box<CustomerSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer: MaybeUndefined<CustomerSort>,
     /// Sort by customer revenue
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_revenue: Option<Box<CustomerRevenueSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_revenue: MaybeUndefined<CustomerRevenueSort>,
     /// Sort by number of customers associated with the issue
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_count: Option<Box<CustomerCountSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_count: MaybeUndefined<CustomerCountSort>,
     /// Sort by number of important customers associated with the issue
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_important_count: Option<Box<CustomerImportantCountSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_important_count: MaybeUndefined<CustomerImportantCountSort>,
     /// Sort by the root issue
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub root_issue: Option<Box<RootIssueSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub root_issue: MaybeUndefined<Box<RootIssueSort>>,
     /// `ALPHA` Sort by number of links associated with the issue
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub link_count: Option<Box<LinkCountSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub link_count: MaybeUndefined<LinkCountSort>,
+    /// `ALPHA` Sort by most recent release date
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub release: MaybeUndefined<ReleaseSort>,
+}
+/// Filter for issue subscription events.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct IssueSubscriptionFilter {
+    /// Filter by team ID.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<IDComparator>,
+    /// Filter by project ID.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<IDComparator>,
+    /// Filter by assignee ID.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub assignee_id: MaybeUndefined<IDComparator>,
+    /// Filter by workflow state ID.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub state_id: MaybeUndefined<IDComparator>,
+    /// Filter by parent issue ID.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent_id: MaybeUndefined<IDComparator>,
 }
 /// IssueSuggestion collection filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueSuggestionCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the suggestion type.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<StringComparator>,
     /// Comparator for the suggestion state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub state: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub state: MaybeUndefined<StringComparator>,
     /// Filters that the suggested user must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub suggested_user: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub suggested_user: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the suggested project must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub suggested_project: Option<Box<NullableProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub suggested_project: MaybeUndefined<Box<NullableProjectFilter>>,
     /// Filters that the suggested team must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub suggested_team: Option<Box<NullableTeamFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub suggested_team: MaybeUndefined<Box<NullableTeamFilter>>,
     /// Filters that the suggested label must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub suggested_label: Option<Box<IssueLabelFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub suggested_label: MaybeUndefined<Box<IssueLabelFilter>>,
     /// Compound filters, all of which need to be matched by the suggestion.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<IssueSuggestionCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<IssueSuggestionCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the suggestion.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<IssueSuggestionCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<IssueSuggestionCollectionFilter>>,
     /// Filters that needs to be matched by some suggestions.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<IssueSuggestionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<Box<IssueSuggestionFilter>>,
     /// Filters that needs to be matched by all suggestions.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<IssueSuggestionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<Box<IssueSuggestionFilter>>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
 }
 /// IssueSuggestion filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueSuggestionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the suggestion type.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<StringComparator>,
     /// Comparator for the suggestion state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub state: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub state: MaybeUndefined<StringComparator>,
     /// Filters that the suggested user must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub suggested_user: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub suggested_user: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the suggested project must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub suggested_project: Option<Box<NullableProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub suggested_project: MaybeUndefined<Box<NullableProjectFilter>>,
     /// Filters that the suggested team must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub suggested_team: Option<Box<NullableTeamFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub suggested_team: MaybeUndefined<Box<NullableTeamFilter>>,
     /// Filters that the suggested label must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub suggested_label: Option<Box<IssueLabelFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub suggested_label: MaybeUndefined<Box<IssueLabelFilter>>,
     /// Compound filters, all of which need to be matched by the suggestion.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<IssueSuggestionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<IssueSuggestionFilter>>,
     /// Compound filters, one of which need to be matched by the suggestion.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<IssueSuggestionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<IssueSuggestionFilter>>,
 }
-/// `ALPHA` The properties of the issueToRelease to create.
+/// `ALPHA` Input for creating a new association between an issue and a release. Both an issue identifier and a release identifier must be provided.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueToReleaseCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The identifier of the issue. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_id: Option<String>,
-    /// The identifier of the release
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub release_id: Option<String>,
+    pub issue_id: String,
+    /// The identifier of the release.
+    pub release_id: String,
 }
+/// Input for updating an existing issue. All fields are optional; only provided fields will be updated. Setting a field to null (where supported) will clear the value.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct IssueUpdateInput {
     /// The issue title.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub title: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub title: MaybeUndefined<String>,
     /// The issue description in markdown format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// `Internal` The issue description as a Prosemirror document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description_data: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description_data: MaybeUndefined<serde_json::Value>,
     /// The identifier of the user to assign the issue to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub assignee_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub assignee_id: MaybeUndefined<String>,
     /// The identifier of the agent user to delegate the issue to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub delegate_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub delegate_id: MaybeUndefined<String>,
     /// The identifier of the parent issue. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent_id: Option<String>,
-    /// The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority: Option<i64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent_id: MaybeUndefined<String>,
+    /// The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority: MaybeUndefined<i64>,
     /// The estimated complexity of the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub estimate: Option<i64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub estimate: MaybeUndefined<i64>,
     /// The identifiers of the users subscribing to this ticket.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subscriber_ids: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subscriber_ids: MaybeUndefined<Vec<String>>,
     /// The identifiers of the issue labels associated with this ticket.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label_ids: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub label_ids: MaybeUndefined<Vec<String>>,
     /// The identifiers of the issue labels to be added to this issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub added_label_ids: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub added_label_ids: MaybeUndefined<Vec<String>>,
     /// The identifiers of the issue labels to be removed from this issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub removed_label_ids: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub removed_label_ids: MaybeUndefined<Vec<String>>,
+    /// The identifiers of the releases associated with this issue.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub release_ids: MaybeUndefined<Vec<String>>,
+    /// The identifiers of the releases to be added to this issue.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub added_release_ids: MaybeUndefined<Vec<String>>,
+    /// The identifiers of the releases to be removed from this issue.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub removed_release_ids: MaybeUndefined<Vec<String>>,
     /// The identifier of the team associated with the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
     /// The cycle associated with the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_id: MaybeUndefined<String>,
     /// The project associated with the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
     /// The project milestone associated with the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_milestone_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_milestone_id: MaybeUndefined<String>,
     /// The ID of the last template applied to the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub last_applied_template_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub last_applied_template_id: MaybeUndefined<String>,
     /// The team state of the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub state_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub state_id: MaybeUndefined<String>,
     /// The position of the issue related to other issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
     /// The position of the issue related to other issues, when ordered by priority.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority_sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority_sort_order: MaybeUndefined<f64>,
     /// The position of the issue in parent's sub-issue list.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sub_issue_sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sub_issue_sort_order: MaybeUndefined<f64>,
     /// The date at which the issue is due.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub due_date: Option<chrono::NaiveDate>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub due_date: MaybeUndefined<chrono::NaiveDate>,
+    /// Whether this issue should inherit shared access from its parent issue.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub inherits_shared_access: MaybeUndefined<bool>,
     /// Whether the issue has been trashed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub trashed: Option<bool>,
-    /// `Internal` The timestamp at which an issue will be considered in breach of SLA.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sla_breaches_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// `Internal` The timestamp at which the issue's SLA was started.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sla_started_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time until an issue will be snoozed in Triage view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub snoozed_until_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub trashed: MaybeUndefined<bool>,
+    /// `Internal` The time at which an issue will be considered in breach of SLA.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sla_breaches_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
+    /// `Internal` The time at which the issue's SLA was started.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sla_started_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
+    /// The time until which the issue will be snoozed in Triage view.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub snoozed_until_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
     /// The identifier of the user who snoozed the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub snoozed_by_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub snoozed_by_id: MaybeUndefined<String>,
     /// The SLA day count type for the issue. Whether SLA should be business days only or calendar days (default).
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sla_type: Option<SLADayCountType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sla_type: MaybeUndefined<SLADayCountType>,
     /// Whether the issue was automatically closed because its parent issue was closed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_closed_by_parent_closing: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_closed_by_parent_closing: MaybeUndefined<bool>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct JiraConfigurationInput {
     /// The Jira personal access token.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub access_token: Option<String>,
+    pub access_token: String,
     /// The Jira user's email address. A username is also accepted on Jira Server / DC.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub email: Option<String>,
+    pub email: String,
     /// The Jira installation hostname.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub hostname: Option<String>,
+    pub hostname: String,
     /// Whether this integration will be setup using the manual webhook flow.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub manual_setup: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub manual_setup: MaybeUndefined<bool>,
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct JiraFetchProjectStatusesInput {
+    /// The id of the Jira integration.
+    pub integration_id: String,
+    /// The Jira project ID to fetch statuses for.
+    pub project_id: String,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct JiraLinearMappingInput {
     /// The Jira id for this project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub jira_project_id: Option<String>,
+    pub jira_project_id: String,
     /// The Linear team id to map to the given project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub linear_team_id: Option<String>,
+    pub linear_team_id: String,
     /// Whether the sync for this mapping is bidirectional.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub bidirectional: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub bidirectional: MaybeUndefined<bool>,
     /// Whether this mapping is the default one for issue creation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub default: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub default: MaybeUndefined<bool>,
+    /// Whether this mapping uses legacy unidirectional sync behavior where no changes sync from Linear to Jira.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub legacy_unidirectional: MaybeUndefined<bool>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct JiraPersonalSettingsInput {
     /// The name of the Jira site currently authorized through the integration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub site_name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub site_name: MaybeUndefined<String>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct JiraProjectDataInput {
     /// The Jira id for this project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    pub id: String,
     /// The Jira key for this project, such as ENG.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub key: Option<String>,
+    pub key: String,
     /// The Jira name for this project, such as Engineering.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct JiraSettingsInput {
     /// The mapping of Jira project id => Linear team id.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_mapping: Option<Vec<Box<JiraLinearMappingInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_mapping: MaybeUndefined<Vec<JiraLinearMappingInput>>,
     /// The Jira projects for the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub projects: Option<Vec<Box<JiraProjectDataInput>>>,
+    pub projects: Vec<JiraProjectDataInput>,
     /// Whether this integration is for Jira Server or not.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_jira_server: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_jira_server: MaybeUndefined<bool>,
+    /// Whether this integration uses custom OAuth authentication (enterprise SSO).
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_custom_o_auth: MaybeUndefined<bool>,
+    /// The OAuth client ID for the personal connection OAuth app, when using custom OAuth.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub personal_o_auth_client_id: MaybeUndefined<String>,
+    /// The custom OAuth server token endpoint URL (enterprise SSO).
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub custom_o_auth_server_url: MaybeUndefined<String>,
     /// Whether the user needs to provide setup information about the webhook to complete the integration setup. Only relevant for integrations that use a manual setup flow
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub setup_pending: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub setup_pending: MaybeUndefined<bool>,
     /// Whether this integration is using a manual setup flow.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub manual_setup: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub manual_setup: MaybeUndefined<bool>,
     /// The label of the Jira instance, for visual identification purposes only
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label: Option<String>,
-    /// The status names per issue type, per project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status_names_per_issue_type: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub label: MaybeUndefined<String>,
+    /// Jira status names grouped by project, separated into issue statuses (non-Epic) and project statuses (Epic). Structure: projectId -> { issueStatuses: string[], projectStatuses: string[] }
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status_names_per_issue_type: MaybeUndefined<serde_json::Value>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct JiraUpdateInput {
     /// The id of the integration to update.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    pub id: String,
     /// Whether to refresh Jira Projects for the integration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub update_projects: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub update_projects: MaybeUndefined<bool>,
     /// Whether to refresh Jira metadata for the integration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub update_metadata: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub update_metadata: MaybeUndefined<bool>,
     /// Whether to delete the current manual webhook configuration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub delete_webhook: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub delete_webhook: MaybeUndefined<bool>,
     /// Webhook secret for a new manual configuration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub webhook_secret: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub webhook_secret: MaybeUndefined<String>,
     /// Whether the Jira instance does not support webhook secrets.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub no_secret: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub no_secret: MaybeUndefined<bool>,
     /// The Jira personal access token.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub access_token: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub access_token: MaybeUndefined<String>,
     /// The Jira user email address associated with the personal access token.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub email: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub email: MaybeUndefined<String>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct JoinOrganizationInput {
     /// The identifier of the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub organization_id: Option<String>,
+    pub organization_id: String,
     /// An optional invite link for an organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub invite_link: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub invite_link: MaybeUndefined<String>,
 }
 /// Issue label-group sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct LabelGroupSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
     /// The label-group id to sort by
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label_group_id: Option<String>,
+    pub label_group_id: String,
 }
 /// Issue label sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct LabelSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct LaunchDarklySettingsInput {
     /// The project key of the LaunchDarkly integration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_key: Option<String>,
+    pub project_key: String,
     /// The environment of the LaunchDarkly integration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub environment: Option<String>,
+    pub environment: String,
 }
 /// `ALPHA` Issue link count sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct LinkCountSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Issue manual sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ManualSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
+}
+/// An additional HTTP header sent with requests to the connected MCP server. Header values are stored securely.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct McpServerCustomHeaderInput {
+    /// The HTTP header name.
+    pub name: String,
+    /// The HTTP header value.
+    pub value: String,
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct MicrosoftTeamsPostSettingsInput {
+    /// AAD group id of the Team.
+    pub team_id: String,
+    /// Display name of the Team.
+    pub team_name: String,
+    /// Microsoft Teams channel id.
+    pub channel_id: String,
+    /// Display name of the channel.
+    pub channel_name: String,
+    /// Membership type of the channel: standard, private, or shared.
+    pub membership_type: String,
+    /// Azure AD tenant id the team belongs to.
+    pub tenant_id: String,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct MicrosoftTeamsSettingsInput {
     /// The display name of the Azure AD tenant.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub tenant_name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub tenant_name: MaybeUndefined<String>,
+    /// Whether Code Intelligence should be enabled for this Microsoft Teams integration.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enable_code_intelligence: MaybeUndefined<bool>,
 }
 /// Issue project milestone options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct MilestoneSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Customer name sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NameSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NotificationCategoryPreferencesInput {
     /// The preferences for notifications about assignments.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub assignments: Option<Box<PartialNotificationChannelPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub assignments: MaybeUndefined<PartialNotificationChannelPreferencesInput>,
     /// The preferences for notifications about status changes.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status_changes: Option<Box<PartialNotificationChannelPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status_changes: MaybeUndefined<PartialNotificationChannelPreferencesInput>,
     /// The preferences for notifications about comments and replies.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub comments_and_replies: Option<Box<PartialNotificationChannelPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub comments_and_replies: MaybeUndefined<PartialNotificationChannelPreferencesInput>,
     /// The preferences for notifications about mentions.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub mentions: Option<Box<PartialNotificationChannelPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub mentions: MaybeUndefined<PartialNotificationChannelPreferencesInput>,
     /// The preferences for notifications about reactions.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub reactions: Option<Box<PartialNotificationChannelPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reactions: MaybeUndefined<PartialNotificationChannelPreferencesInput>,
     /// The preferences for notifications about subscriptions.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subscriptions: Option<Box<PartialNotificationChannelPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subscriptions: MaybeUndefined<PartialNotificationChannelPreferencesInput>,
     /// The preferences for notifications about document changes.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub document_changes: Option<Box<PartialNotificationChannelPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub document_changes: MaybeUndefined<PartialNotificationChannelPreferencesInput>,
     /// The preferences for notifications about posts and updates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub posts_and_updates: Option<Box<PartialNotificationChannelPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub posts_and_updates: MaybeUndefined<PartialNotificationChannelPreferencesInput>,
     /// The preferences for notifications about reminders.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub reminders: Option<Box<PartialNotificationChannelPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reminders: MaybeUndefined<PartialNotificationChannelPreferencesInput>,
     /// The preferences for notifications about reviews.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub reviews: Option<Box<PartialNotificationChannelPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reviews: MaybeUndefined<PartialNotificationChannelPreferencesInput>,
     /// The preferences for notifications about apps and integrations.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub apps_and_integrations: Option<Box<PartialNotificationChannelPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub apps_and_integrations: MaybeUndefined<PartialNotificationChannelPreferencesInput>,
     /// The preferences for notifications about triage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub triage: Option<Box<PartialNotificationChannelPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub triage: MaybeUndefined<PartialNotificationChannelPreferencesInput>,
     /// The preferences for notifications about customers.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customers: Option<Box<PartialNotificationChannelPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customers: MaybeUndefined<PartialNotificationChannelPreferencesInput>,
     /// The preferences for notifications about feed summaries.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub feed: Option<Box<PartialNotificationChannelPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub feed: MaybeUndefined<PartialNotificationChannelPreferencesInput>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NotificationDeliveryPreferencesChannelInput {
     /// The schedule for notifications on this channel.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub schedule: Option<Box<NotificationDeliveryPreferencesScheduleInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub schedule: MaybeUndefined<NotificationDeliveryPreferencesScheduleInput>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NotificationDeliveryPreferencesDayInput {
-    /// The time notifications start.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub start: Option<String>,
-    /// The time notifications end.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub end: Option<String>,
+    /// The start time of the notification delivery window in HH:MM military time format (e.g., '09:00'). Must be earlier than 'end'.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub start: MaybeUndefined<String>,
+    /// The end time of the notification delivery window in HH:MM military time format (e.g., '18:00'). Must be later than 'start'.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub end: MaybeUndefined<String>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NotificationDeliveryPreferencesInput {
     /// The delivery preferences for the mobile channel.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub mobile: Option<Box<NotificationDeliveryPreferencesChannelInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub mobile: MaybeUndefined<NotificationDeliveryPreferencesChannelInput>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NotificationDeliveryPreferencesScheduleInput {
-    /// Whether the schedule is disabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub disabled: Option<bool>,
+    /// Whether the entire delivery schedule is disabled. When true, notifications are delivered at any time regardless of the per-day settings.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub disabled: MaybeUndefined<bool>,
     /// Delivery preferences for Sunday.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sunday: Option<Box<NotificationDeliveryPreferencesDayInput>>,
+    pub sunday: NotificationDeliveryPreferencesDayInput,
     /// Delivery preferences for Monday.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub monday: Option<Box<NotificationDeliveryPreferencesDayInput>>,
+    pub monday: NotificationDeliveryPreferencesDayInput,
     /// Delivery preferences for Tuesday.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub tuesday: Option<Box<NotificationDeliveryPreferencesDayInput>>,
+    pub tuesday: NotificationDeliveryPreferencesDayInput,
     /// Delivery preferences for Wednesday.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub wednesday: Option<Box<NotificationDeliveryPreferencesDayInput>>,
+    pub wednesday: NotificationDeliveryPreferencesDayInput,
     /// Delivery preferences for Thursday.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub thursday: Option<Box<NotificationDeliveryPreferencesDayInput>>,
+    pub thursday: NotificationDeliveryPreferencesDayInput,
     /// Delivery preferences for Friday.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub friday: Option<Box<NotificationDeliveryPreferencesDayInput>>,
+    pub friday: NotificationDeliveryPreferencesDayInput,
     /// Delivery preferences for Saturday.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub saturday: Option<Box<NotificationDeliveryPreferencesDayInput>>,
+    pub saturday: NotificationDeliveryPreferencesDayInput,
 }
-/// Describes the type and id of the entity to target for notifications.
+/// Identifies a specific entity whose related notifications should be targeted by a batch operation. Exactly one entity identifier should be provided.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NotificationEntityInput {
     /// The id of the issue related to the notification.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_id: MaybeUndefined<String>,
     /// `DEPRECATED` The id of the project related to the notification.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
     /// The id of the initiative related to the notification.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_id: MaybeUndefined<String>,
     /// The id of the project update related to the notification.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_update_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_update_id: MaybeUndefined<String>,
     /// The id of the initiative update related to the notification.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_update_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_update_id: MaybeUndefined<String>,
     /// The id of the OAuth client approval related to the notification.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub oauth_client_approval_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub oauth_client_approval_id: MaybeUndefined<String>,
     /// The id of the notification.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
 }
 /// Notification filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NotificationFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the notification type.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<StringComparator>,
     /// Comparator for the archived at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub archived_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub archived_at: MaybeUndefined<DateComparator>,
     /// Compound filters, all of which need to be matched by the notification.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<NotificationFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<NotificationFilter>>,
     /// Compound filters, one of which need to be matched by the notification.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<NotificationFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<NotificationFilter>>,
 }
+/// Input for creating a notification subscription. Exactly one target entity (customer, custom view, cycle, initiative, label, project, team, or user) must be specified along with the notification types to subscribe to.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NotificationSubscriptionCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The identifier of the customer to subscribe to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_id: MaybeUndefined<String>,
     /// The identifier of the custom view to subscribe to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub custom_view_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub custom_view_id: MaybeUndefined<String>,
     /// The identifier of the cycle to subscribe to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_id: MaybeUndefined<String>,
     /// The identifier of the initiative to subscribe to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_id: MaybeUndefined<String>,
     /// The identifier of the label to subscribe to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub label_id: MaybeUndefined<String>,
     /// The identifier of the project to subscribe to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
     /// The identifier of the team to subscribe to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
     /// The identifier of the user to subscribe to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub user_id: MaybeUndefined<String>,
     /// The type of view to which the notification subscription context is associated with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub context_view_type: Option<ContextViewType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub context_view_type: MaybeUndefined<ContextViewType>,
     /// The type of user view to which the notification subscription context is associated with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user_context_view_type: Option<UserContextViewType>,
-    /// The types of notifications of the subscription.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub notification_subscription_types: Option<Vec<String>>,
-    /// Whether the subscription is active.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub active: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub user_context_view_type: MaybeUndefined<UserContextViewType>,
+    /// The specific notification event types the subscriber wants to receive for the target entity.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub notification_subscription_types: MaybeUndefined<Vec<String>>,
+    /// Whether the subscription is active. Set to false to pause notifications without deleting the subscription.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub active: MaybeUndefined<bool>,
 }
+/// Input for updating an existing notification subscription. Allows changing the subscribed notification types and active state.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NotificationSubscriptionUpdateInput {
-    /// The types of notifications of the subscription.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub notification_subscription_types: Option<Vec<String>>,
+    /// The specific notification event types the subscriber wants to receive. Replaces all previously configured types.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub notification_subscription_types: MaybeUndefined<Vec<String>>,
     /// Whether the subscription is active.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub active: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub active: MaybeUndefined<bool>,
 }
+/// Input for updating a notification's read and snooze state.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NotificationUpdateInput {
     /// The time when notification was marked as read.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub read_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub read_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
     /// The time until a notification will be snoozed. After that it will appear in the inbox again.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub snoozed_until_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub snoozed_until_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
     /// The id of the project update related to the notification.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_update_id: Option<String>,
-    /// The id of the project update related to the notification.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_update_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_update_id: MaybeUndefined<String>,
+    /// The id of the initiative update related to the notification.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_update_id: MaybeUndefined<String>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NotionSettingsInput {
     /// The ID of the Notion workspace being connected.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub workspace_id: Option<String>,
+    pub workspace_id: String,
     /// The name of the Notion workspace being connected.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub workspace_name: Option<String>,
+    pub workspace_name: String,
 }
 /// Comment filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NullableCommentFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the comment's body.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body: MaybeUndefined<StringComparator>,
     /// Filters that the comment's creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub user: MaybeUndefined<Box<UserFilter>>,
     /// Filters that the comment's issue must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue: Option<Box<NullableIssueFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue: MaybeUndefined<Box<NullableIssueFilter>>,
     /// Filters that the comment's project update must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_update: Option<Box<NullableProjectUpdateFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_update: MaybeUndefined<Box<NullableProjectUpdateFilter>>,
     /// Filters that the comment parent must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent: Option<Box<NullableCommentFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent: MaybeUndefined<Box<NullableCommentFilter>>,
     /// Filters that the comment's document content must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub document_content: Option<Box<NullableDocumentContentFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub document_content: MaybeUndefined<Box<NullableDocumentContentFilter>>,
+    /// `Internal` Filters that the comment's project must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<Box<NullableProjectFilter>>,
+    /// `Internal` Filters that the comment's initiative must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative: MaybeUndefined<Box<NullableInitiativeFilter>>,
     /// Filters that the comment's reactions must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub reactions: Option<Box<ReactionCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reactions: MaybeUndefined<ReactionCollectionFilter>,
     /// Filters that the comment's customer needs must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub needs: Option<Box<CustomerNeedCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub needs: MaybeUndefined<Box<CustomerNeedCollectionFilter>>,
     /// Filter based on the existence of the relation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Compound filters, all of which need to be matched by the comment.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<NullableCommentFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<NullableCommentFilter>>,
     /// Compound filters, one of which need to be matched by the comment.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<NullableCommentFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<NullableCommentFilter>>,
 }
 /// Customer filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NullableCustomerFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the customer name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the customer slack channel ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_channel_id: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_channel_id: MaybeUndefined<StringComparator>,
     /// Comparator for the customer's domains.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub domains: Option<Box<StringArrayComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub domains: MaybeUndefined<StringArrayComparator>,
     /// Comparator for the customer's external IDs.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_ids: Option<Box<StringArrayComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_ids: MaybeUndefined<StringArrayComparator>,
     /// Filters that the customer owner must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the customer's needs must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub needs: Option<Box<CustomerNeedCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub needs: MaybeUndefined<Box<CustomerNeedCollectionFilter>>,
     /// Comparator for the customer generated revenue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub revenue: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub revenue: MaybeUndefined<NumberComparator>,
     /// Comparator for the customer size.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub size: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub size: MaybeUndefined<NumberComparator>,
     /// Filters that the customer's status must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status: Option<Box<CustomerStatusFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status: MaybeUndefined<CustomerStatusFilter>,
     /// Filters that the customer's tier must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub tier: Option<Box<CustomerTierFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub tier: MaybeUndefined<CustomerTierFilter>,
     /// Filter based on the existence of the relation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Compound filters, all of which need to be matched by the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<NullableCustomerFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<NullableCustomerFilter>>,
     /// Compound filters, one of which need to be matched by the customer.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<NullableCustomerFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<NullableCustomerFilter>>,
 }
 /// Cycle filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NullableCycleFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the cycle number.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub number: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub number: MaybeUndefined<NumberComparator>,
     /// Comparator for the cycle name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the cycle start date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub starts_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub starts_at: MaybeUndefined<DateComparator>,
     /// Comparator for the cycle ends at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ends_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ends_at: MaybeUndefined<DateComparator>,
     /// Comparator for the cycle completed at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub completed_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<DateComparator>,
     /// Comparator for the filtering active cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_active: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_active: MaybeUndefined<BooleanComparator>,
     /// Comparator for filtering for whether the cycle is currently in cooldown.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_in_cooldown: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_in_cooldown: MaybeUndefined<BooleanComparator>,
     /// Comparator for the filtering next cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_next: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_next: MaybeUndefined<BooleanComparator>,
     /// Comparator for the filtering previous cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_previous: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_previous: MaybeUndefined<BooleanComparator>,
     /// Comparator for the filtering future cycles.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_future: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_future: MaybeUndefined<BooleanComparator>,
     /// Comparator for the filtering past cycles.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_past: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_past: MaybeUndefined<BooleanComparator>,
     /// Filters that the cycles team must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team: Option<Box<TeamFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team: MaybeUndefined<Box<TeamFilter>>,
     /// Filters that the cycles issues must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issues: Option<Box<IssueCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issues: MaybeUndefined<Box<IssueCollectionFilter>>,
     /// Comparator for the inherited cycle ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub inherited_from_id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub inherited_from_id: MaybeUndefined<IDComparator>,
     /// Filter based on the existence of the relation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Compound filters, all of which need to be matched by the cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<NullableCycleFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<NullableCycleFilter>>,
     /// Compound filters, one of which need to be matched by the cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<NullableCycleFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<NullableCycleFilter>>,
 }
 /// Comparator for optional dates.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NullableDateComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<serde_json::Value>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<serde_json::Value>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<serde_json::Value>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<serde_json::Value>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<serde_json::Value>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<serde_json::Value>>,
     /// Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Less-than constraint. Matches any values that are less than the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lt: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lt: MaybeUndefined<serde_json::Value>,
     /// Less-than-or-equal constraint. Matches any values that are less than or equal to the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lte: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lte: MaybeUndefined<serde_json::Value>,
     /// Greater-than constraint. Matches any values that are greater than the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub gt: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub gt: MaybeUndefined<serde_json::Value>,
     /// Greater-than-or-equal constraint. Matches any values that are greater than or equal to the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub gte: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub gte: MaybeUndefined<serde_json::Value>,
 }
 /// Document content filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NullableDocumentContentFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the document content.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub content: Option<Box<NullableStringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub content: MaybeUndefined<NullableStringComparator>,
     /// Filters that the document content project must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project: Option<Box<ProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<Box<ProjectFilter>>,
     /// Filters that the document content document must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub document: Option<Box<DocumentFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub document: MaybeUndefined<Box<DocumentFilter>>,
     /// Filter based on the existence of the relation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Compound filters, all of which need to be matched by the user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<NullableDocumentContentFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<NullableDocumentContentFilter>>,
     /// Compound filters, one of which need to be matched by the user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<NullableDocumentContentFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<NullableDocumentContentFilter>>,
 }
 /// Nullable comparator for optional durations.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NullableDurationComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<serde_json::Value>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<serde_json::Value>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<serde_json::Value>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<serde_json::Value>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<serde_json::Value>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<serde_json::Value>>,
     /// Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Less-than constraint. Matches any values that are less than the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lt: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lt: MaybeUndefined<serde_json::Value>,
     /// Less-than-or-equal constraint. Matches any values that are less than or equal to the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lte: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lte: MaybeUndefined<serde_json::Value>,
     /// Greater-than constraint. Matches any values that are greater than the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub gt: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub gt: MaybeUndefined<serde_json::Value>,
     /// Greater-than-or-equal constraint. Matches any values that are greater than or equal to the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub gte: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub gte: MaybeUndefined<serde_json::Value>,
+}
+/// Initiative filtering options.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct NullableInitiativeFilter {
+    /// Comparator for the identifier.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
+    /// Comparator for the created at date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
+    /// Comparator for the updated at date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
+    /// Comparator for the initiative name.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
+    /// Comparator for the initiative slug ID.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slug_id: MaybeUndefined<StringComparator>,
+    /// Filters that the initiative creator must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<NullableUserFilter>>,
+    /// Comparator for the initiative status: Planned, Active, Completed
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status: MaybeUndefined<StringComparator>,
+    /// Filters that the initiative teams must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub teams: MaybeUndefined<Box<TeamCollectionFilter>>,
+    /// Filters that the initiative owner must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner: MaybeUndefined<Box<NullableUserFilter>>,
+    /// Comparator for the initiative target date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<NullableDateComparator>,
+    /// Comparator for the initiative started at date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub started_at: MaybeUndefined<NullableDateComparator>,
+    /// Comparator for the initiative completed at date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<NullableDateComparator>,
+    /// Comparator for the initiative health: onTrack, atRisk, offTrack
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health: MaybeUndefined<StringComparator>,
+    /// Comparator for the initiative health (with age): onTrack, atRisk, offTrack, outdated, noUpdate
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health_with_age: MaybeUndefined<StringComparator>,
+    /// Comparator for the initiative activity type.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub activity_type: MaybeUndefined<StringComparator>,
+    /// Filters that the initiative must be an ancestor of.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ancestors: MaybeUndefined<Box<InitiativeCollectionFilter>>,
+    /// Filters that the initiative updates must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_updates: MaybeUndefined<InitiativeUpdatesCollectionFilter>,
+    /// Filter based on the existence of the relation.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
+    /// Compound filters, all of which need to be matched by the initiative.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<NullableInitiativeFilter>>,
+    /// Compound filters, one of which need to be matched by the initiative.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<NullableInitiativeFilter>>,
 }
 /// Issue filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NullableIssueFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IssueIDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IssueIDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the issues number.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub number: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub number: MaybeUndefined<NumberComparator>,
     /// Comparator for the issues title.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub title: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub title: MaybeUndefined<StringComparator>,
     /// Comparator for the issues description.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<Box<NullableStringComparator>>,
-    /// Comparator for the issues priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority: Option<Box<NullableNumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<NullableStringComparator>,
+    /// Comparator for the issues priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority: MaybeUndefined<NullableNumberComparator>,
     /// Comparator for the issues estimate.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub estimate: Option<Box<EstimateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub estimate: MaybeUndefined<EstimateComparator>,
     /// Comparator for the issues started at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub started_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub started_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues triaged at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub triaged_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub triaged_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues completed at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub completed_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues canceled at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub canceled_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub canceled_at: MaybeUndefined<NullableDateComparator>,
+    /// Comparator for the issue's SLA breach date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sla_breaches_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues archived at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub archived_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub archived_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues auto closed at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_closed_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_closed_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues auto archived at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_archived_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_archived_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues added to cycle at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub added_to_cycle_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub added_to_cycle_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the period when issue was added to a cycle.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub added_to_cycle_period: Option<Box<CyclePeriodComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub added_to_cycle_period: MaybeUndefined<CyclePeriodComparator>,
     /// Comparator for the issues due date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub due_date: Option<Box<NullableTimelessDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub due_date: MaybeUndefined<NullableTimelessDateComparator>,
     /// `Internal` Comparator for the issue's accumulatedStateUpdatedAt date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub accumulated_state_updated_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub accumulated_state_updated_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the issues snoozed until date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub snoozed_until_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub snoozed_until_at: MaybeUndefined<NullableDateComparator>,
     /// Filters that the issues assignee must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub assignee: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub assignee: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the issue's delegated agent must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub delegate: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub delegate: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the last applied template must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub last_applied_template: Option<Box<NullableTemplateFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub last_applied_template: MaybeUndefined<NullableTemplateFilter>,
     /// `ALPHA` Filters that the recurring issue template must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub recurring_issue_template: Option<Box<NullableTemplateFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub recurring_issue_template: MaybeUndefined<NullableTemplateFilter>,
     /// Filters that the source must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub source_metadata: Option<Box<SourceMetadataComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub source_metadata: MaybeUndefined<SourceMetadataComparator>,
     /// Filters that the issues creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the issue parent must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent: Option<Box<NullableIssueFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent: MaybeUndefined<Box<NullableIssueFilter>>,
     /// Filters that the issues snoozer must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub snoozed_by: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub snoozed_by: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that issue labels must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub labels: Option<Box<IssueLabelCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub labels: MaybeUndefined<Box<IssueLabelCollectionFilter>>,
     /// Filters that issue subscribers must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subscribers: Option<Box<UserCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subscribers: MaybeUndefined<Box<UserCollectionFilter>>,
     /// Comparator for filtering issues which have been shared with users outside of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_shared_users: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_shared_users: MaybeUndefined<RelationExistsComparator>,
     /// Filters that users the issue has been shared with must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub shared_with: Option<Box<UserCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub shared_with: MaybeUndefined<Box<UserCollectionFilter>>,
     /// Filters that the issues team must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team: Option<Box<TeamFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team: MaybeUndefined<Box<TeamFilter>>,
     /// Filters that the issues project milestone must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_milestone: Option<Box<NullableProjectMilestoneFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_milestone: MaybeUndefined<Box<NullableProjectMilestoneFilter>>,
     /// Filters that the issues comments must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub comments: Option<Box<CommentCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub comments: MaybeUndefined<Box<CommentCollectionFilter>>,
     /// Filters that the issue's activities must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub activity: Option<Box<ActivityCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub activity: MaybeUndefined<Box<ActivityCollectionFilter>>,
     /// `Internal` Filters that the issue's suggestions must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub suggestions: Option<Box<IssueSuggestionCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub suggestions: MaybeUndefined<Box<IssueSuggestionCollectionFilter>>,
     /// Filters that the issues cycle must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle: Option<Box<NullableCycleFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle: MaybeUndefined<Box<NullableCycleFilter>>,
     /// Filters that the issues project must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project: Option<Box<NullableProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<Box<NullableProjectFilter>>,
     /// Filters that the issues state must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub state: Option<Box<WorkflowStateFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub state: MaybeUndefined<Box<WorkflowStateFilter>>,
     /// Filters that the child issues must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub children: Option<Box<IssueCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub children: MaybeUndefined<Box<IssueCollectionFilter>>,
     /// Filters that the issues attachments must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub attachments: Option<Box<AttachmentCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub attachments: MaybeUndefined<Box<AttachmentCollectionFilter>>,
     /// `Internal` Comparator for the issues content.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub searchable_content: Option<Box<ContentComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub searchable_content: MaybeUndefined<ContentComparator>,
     /// Comparator for filtering issues with relations.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_related_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_related_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering issues which are duplicates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_duplicate_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_duplicate_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering issues which are blocked.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_blocked_by_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_blocked_by_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering issues which are blocking.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_blocking_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_blocking_relations: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested related issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_related_issues: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_related_issues: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested similar issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_similar_issues: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_similar_issues: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested assignees.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_assignees: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_assignees: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested projects.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_projects: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_projects: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested labels.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_labels: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_labels: MaybeUndefined<RelationExistsComparator>,
     /// `Internal` Comparator for filtering issues which have suggested teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_suggested_teams: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_suggested_teams: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for the issues sla status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sla_status: Option<Box<SlaStatusComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sla_status: MaybeUndefined<SlaStatusComparator>,
     /// Filters that the issues reactions must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub reactions: Option<Box<ReactionCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reactions: MaybeUndefined<ReactionCollectionFilter>,
     /// Filters that the issue's customer needs must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub needs: Option<Box<CustomerNeedCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub needs: MaybeUndefined<Box<CustomerNeedCollectionFilter>>,
     /// `ALPHA` Filters that the issue's releases must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub releases: Option<Box<ReleaseCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub releases: MaybeUndefined<Box<ReleaseCollectionFilter>>,
     /// Count of customers
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_count: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_count: MaybeUndefined<NumberComparator>,
     /// Count of important customers
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_important_count: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_important_count: MaybeUndefined<NumberComparator>,
     /// `Internal` Lead time (created -> completed) comparator.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lead_time: Option<Box<NullableDurationComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lead_time: MaybeUndefined<NullableDurationComparator>,
     /// `Internal` Cycle time (started -> completed) comparator.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_time: Option<Box<NullableDurationComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_time: MaybeUndefined<NullableDurationComparator>,
     /// `Internal` Age (created -> now) comparator, defined if the issue is still open.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub age_time: Option<Box<NullableDurationComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub age_time: MaybeUndefined<NullableDurationComparator>,
     /// `Internal` Triage time (entered triaged -> triaged) comparator.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub triage_time: Option<Box<NullableDurationComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub triage_time: MaybeUndefined<NullableDurationComparator>,
     /// Filter based on the existence of the relation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Compound filters, all of which need to be matched by the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<NullableIssueFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<NullableIssueFilter>>,
     /// Compound filters, one of which need to be matched by the issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<NullableIssueFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<NullableIssueFilter>>,
 }
 /// Comparator for optional numbers.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NullableNumberComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<f64>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<f64>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<f64>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<f64>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<f64>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<f64>>,
     /// Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Less-than constraint. Matches any values that are less than the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lt: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lt: MaybeUndefined<f64>,
     /// Less-than-or-equal constraint. Matches any values that are less than or equal to the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lte: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lte: MaybeUndefined<f64>,
     /// Greater-than constraint. Matches any values that are greater than the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub gt: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub gt: MaybeUndefined<f64>,
     /// Greater-than-or-equal constraint. Matches any values that are greater than or equal to the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub gte: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub gte: MaybeUndefined<f64>,
 }
 /// Project filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NullableProjectFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the project name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the project slug ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slug_id: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slug_id: MaybeUndefined<StringComparator>,
     /// `DEPRECATED` Comparator for the project state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub state: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub state: MaybeUndefined<StringComparator>,
     /// Filters that the project's status must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status: Option<Box<ProjectStatusFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status: MaybeUndefined<Box<ProjectStatusFilter>>,
     /// Comparator for the projects priority.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority: Option<Box<NullableNumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority: MaybeUndefined<NullableNumberComparator>,
     /// Filters that project labels must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub labels: Option<Box<ProjectLabelCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub labels: MaybeUndefined<Box<ProjectLabelCollectionFilter>>,
     /// `Internal` Comparator for the project's content.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub searchable_content: Option<Box<ContentComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub searchable_content: MaybeUndefined<ContentComparator>,
     /// Comparator for the project started date (when it was moved to an "In Progress" status).
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub started_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub started_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the project completion date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub completed_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the project cancelation date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub canceled_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub canceled_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the project start date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub start_date: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub start_date: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the project target date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the project health: onTrack, atRisk, offTrack
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health: MaybeUndefined<StringComparator>,
     /// Comparator for the project health (with age): onTrack, atRisk, offTrack, outdated, noUpdate
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health_with_age: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health_with_age: MaybeUndefined<StringComparator>,
     /// `ALPHA` Comparator for the project activity type: buzzin, active, some, none
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub activity_type: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub activity_type: MaybeUndefined<StringComparator>,
     /// Comparator for filtering projects with relations.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_related_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_related_relations: MaybeUndefined<RelationExistsComparator>,
     /// `Deprecated` Comparator for filtering projects which this is depended on by.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_depended_on_by_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_depended_on_by_relations: MaybeUndefined<RelationExistsComparator>,
     /// `Deprecated`Comparator for filtering projects which this depends on.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_depends_on_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_depends_on_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering projects which are blocked.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_blocked_by_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_blocked_by_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering projects which are blocking.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_blocking_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_blocking_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering projects with violated dependencies.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_violated_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_violated_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for the project updates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_updates: Option<Box<ProjectUpdatesCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_updates: MaybeUndefined<ProjectUpdatesCollectionFilter>,
     /// Filters that the projects creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<UserFilter>>,
     /// Filters that the projects lead must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lead: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lead: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the projects members must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub members: Option<Box<UserCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub members: MaybeUndefined<Box<UserCollectionFilter>>,
     /// Filters that the projects issues must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issues: Option<Box<IssueCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issues: MaybeUndefined<Box<IssueCollectionFilter>>,
     /// Filters that the projects roadmaps must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub roadmaps: Option<Box<RoadmapCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub roadmaps: MaybeUndefined<Box<RoadmapCollectionFilter>>,
     /// Filters that the projects initiatives must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiatives: Option<Box<InitiativeCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiatives: MaybeUndefined<Box<InitiativeCollectionFilter>>,
     /// Filters that the project's milestones must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_milestones: Option<Box<ProjectMilestoneCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_milestones: MaybeUndefined<Box<ProjectMilestoneCollectionFilter>>,
     /// Filters that the project's completed milestones must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub completed_project_milestones: Option<Box<ProjectMilestoneCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_project_milestones: MaybeUndefined<Box<ProjectMilestoneCollectionFilter>>,
     /// Filters that the project's next milestone must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub next_project_milestone: Option<Box<ProjectMilestoneFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub next_project_milestone: MaybeUndefined<Box<ProjectMilestoneFilter>>,
     /// Filters that the project's team must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub accessible_teams: Option<Box<TeamCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub accessible_teams: MaybeUndefined<Box<TeamCollectionFilter>>,
     /// Filters that the last applied template must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub last_applied_template: Option<Box<NullableTemplateFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub last_applied_template: MaybeUndefined<NullableTemplateFilter>,
     /// Filters that the project's customer needs must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub needs: Option<Box<CustomerNeedCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub needs: MaybeUndefined<Box<CustomerNeedCollectionFilter>>,
     /// Count of customers
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_count: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_count: MaybeUndefined<NumberComparator>,
     /// Count of important customers
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_important_count: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_important_count: MaybeUndefined<NumberComparator>,
     /// Filter based on the existence of the relation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Compound filters, all of which need to be matched by the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<NullableProjectFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<NullableProjectFilter>>,
     /// Compound filters, one of which need to be matched by the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<NullableProjectFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<NullableProjectFilter>>,
 }
 /// Project milestone filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NullableProjectMilestoneFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the project milestone name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<NullableStringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<NullableStringComparator>,
     /// Comparator for the project milestone target date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<NullableDateComparator>,
     /// Filters that the project milestone's project must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project: Option<Box<NullableProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<Box<NullableProjectFilter>>,
     /// Filter based on the existence of the relation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Compound filters, all of which need to be matched by the project milestone.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<NullableProjectMilestoneFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<NullableProjectMilestoneFilter>>,
     /// Compound filters, one of which need to be matched by the project milestone.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<NullableProjectMilestoneFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<NullableProjectMilestoneFilter>>,
 }
 /// Nullable project update filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NullableProjectUpdateFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Filters that the project update creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub user: MaybeUndefined<Box<UserFilter>>,
     /// Filters that the project update project must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project: Option<Box<ProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<Box<ProjectFilter>>,
     /// Filters that the project updates reactions must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub reactions: Option<Box<ReactionCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reactions: MaybeUndefined<ReactionCollectionFilter>,
     /// Filter based on the existence of the relation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Compound filters, all of which need to be matched by the project update.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<NullableProjectUpdateFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<NullableProjectUpdateFilter>>,
     /// Compound filters, one of which need to be matched by the project update.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<NullableProjectUpdateFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<NullableProjectUpdateFilter>>,
 }
 /// Comparator for optional strings.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NullableStringComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<String>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<String>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<String>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<String>>,
     /// Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Equals case insensitive. Matches any values that matches the given string case insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq_ignore_case: MaybeUndefined<String>,
     /// Not-equals case insensitive. Matches any values that don't match the given string case insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq_ignore_case: MaybeUndefined<String>,
     /// Starts with constraint. Matches any values that start with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub starts_with: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub starts_with: MaybeUndefined<String>,
     /// Starts with case insensitive constraint. Matches any values that start with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub starts_with_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub starts_with_ignore_case: MaybeUndefined<String>,
     /// Doesn't start with constraint. Matches any values that don't start with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_starts_with: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_starts_with: MaybeUndefined<String>,
     /// Ends with constraint. Matches any values that end with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ends_with: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ends_with: MaybeUndefined<String>,
     /// Doesn't end with constraint. Matches any values that don't end with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_ends_with: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_ends_with: MaybeUndefined<String>,
     /// Contains constraint. Matches any values that contain the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub contains: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub contains: MaybeUndefined<String>,
     /// Contains case insensitive constraint. Matches any values that contain the given string case insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub contains_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub contains_ignore_case: MaybeUndefined<String>,
     /// Doesn't contain constraint. Matches any values that don't contain the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_contains: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_contains: MaybeUndefined<String>,
     /// Doesn't contain case insensitive constraint. Matches any values that don't contain the given string case insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_contains_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_contains_ignore_case: MaybeUndefined<String>,
     /// Contains case and accent insensitive constraint. Matches any values that contain the given string case and accent insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub contains_ignore_case_and_accent: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub contains_ignore_case_and_accent: MaybeUndefined<String>,
 }
 /// Team filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NullableTeamFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the team name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the team key.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub key: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub key: MaybeUndefined<StringComparator>,
     /// Comparator for the team description.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<Box<NullableStringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<NullableStringComparator>,
     /// Comparator for the team privacy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub private: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub private: MaybeUndefined<BooleanComparator>,
+    /// Comparator for the time at which the team was retired.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub retired_at: MaybeUndefined<NullableDateComparator>,
     /// Filters that the teams issues must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issues: Option<Box<IssueCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issues: MaybeUndefined<Box<IssueCollectionFilter>>,
     /// Filters that the teams parent must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent: Option<Box<NullableTeamFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent: MaybeUndefined<Box<NullableTeamFilter>>,
+    /// Filters that the team's ancestors must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ancestors: MaybeUndefined<Box<TeamCollectionFilter>>,
+    /// `ALPHA` Filters that the team's release pipelines must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub release_pipelines: MaybeUndefined<Box<ReleasePipelineCollectionFilter>>,
     /// Filter based on the existence of the relation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Compound filters, all of which need to be matched by the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<NullableTeamFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<NullableTeamFilter>>,
     /// Compound filters, one of which need to be matched by the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<NullableTeamFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<NullableTeamFilter>>,
 }
 /// Template filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NullableTemplateFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the template's name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the template's type.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<StringComparator>,
     /// Comparator for the inherited template's ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub inherited_from_id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub inherited_from_id: MaybeUndefined<IDComparator>,
     /// Filter based on the existence of the relation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Compound filters, all of which need to be matched by the template.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<NullableTemplateFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<NullableTemplateFilter>>,
     /// Compound filters, one of which need to be matched by the template.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<NullableTemplateFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<NullableTemplateFilter>>,
 }
 /// Comparator for optional timeless dates.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NullableTimelessDateComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<serde_json::Value>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<serde_json::Value>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<serde_json::Value>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<serde_json::Value>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<serde_json::Value>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<serde_json::Value>>,
     /// Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Less-than constraint. Matches any values that are less than the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lt: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lt: MaybeUndefined<serde_json::Value>,
     /// Less-than-or-equal constraint. Matches any values that are less than or equal to the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lte: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lte: MaybeUndefined<serde_json::Value>,
     /// Greater-than constraint. Matches any values that are greater than the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub gt: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub gt: MaybeUndefined<serde_json::Value>,
     /// Greater-than-or-equal constraint. Matches any values that are greater than or equal to the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub gte: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub gte: MaybeUndefined<serde_json::Value>,
 }
 /// User filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NullableUserFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the user's name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the user's display name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub display_name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub display_name: MaybeUndefined<StringComparator>,
     /// Comparator for the user's email.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub email: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub email: MaybeUndefined<StringComparator>,
     /// Comparator for the user's activity status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub active: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub active: MaybeUndefined<BooleanComparator>,
     /// Filters that the users assigned issues must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub assigned_issues: Option<Box<IssueCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub assigned_issues: MaybeUndefined<Box<IssueCollectionFilter>>,
     /// Comparator for the user's admin status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub admin: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub admin: MaybeUndefined<BooleanComparator>,
     /// Comparator for the user's owner status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner: MaybeUndefined<BooleanComparator>,
     /// Comparator for the user's invited status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub invited: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub invited: MaybeUndefined<BooleanComparator>,
     /// Comparator for the user's invited status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_invited: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_invited: MaybeUndefined<BooleanComparator>,
     /// Comparator for the user's app status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub app: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub app: MaybeUndefined<BooleanComparator>,
     /// Filter based on the currently authenticated user. Set to true to filter for the authenticated user, false for any other user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_me: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_me: MaybeUndefined<BooleanComparator>,
     /// Filter based on the existence of the relation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Compound filters, all of which need to be matched by the user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<NullableUserFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<NullableUserFilter>>,
     /// Compound filters, one of which need to be matched by the user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<NullableUserFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<NullableUserFilter>>,
 }
 /// Comparator for numbers.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct NumberComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<f64>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<f64>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<f64>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<f64>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<f64>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<f64>>,
     /// Less-than constraint. Matches any values that are less than the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lt: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lt: MaybeUndefined<f64>,
     /// Less-than-or-equal constraint. Matches any values that are less than or equal to the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lte: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lte: MaybeUndefined<f64>,
     /// Greater-than constraint. Matches any values that are greater than the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub gt: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub gt: MaybeUndefined<f64>,
     /// Greater-than-or-equal constraint. Matches any values that are greater than or equal to the given value.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub gte: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub gte: MaybeUndefined<f64>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct OnboardingCustomerSurvey {
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub company_role: Option<String>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub company_size: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub company_role: MaybeUndefined<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub company_size: MaybeUndefined<String>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct OpsgenieInput {
     /// The date when the Opsgenie API failed with an unauthorized error.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub api_failed_with_unauthorized_error_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub api_failed_with_unauthorized_error_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
+}
+/// Input for updating workspace authentication settings.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct OrganizationAuthSettingsInput {
+    /// Allowed authentication providers, empty array means all are allowed.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub allowed_auth_services: MaybeUndefined<Vec<String>>,
+    /// `Internal` The minimum role required for the auth service bypass exemption.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub allowed_auth_service_bypass_role: MaybeUndefined<String>,
+    /// Whether to hide non-primary workspaces during signup for users with matching email domains.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub hide_non_primary_organizations: MaybeUndefined<bool>,
+    /// Whether to disable admin/owner auth service bypass.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub disable_auth_service_bypass: MaybeUndefined<bool>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct OrganizationDomainCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The identity provider to which to add the domain.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub identity_provider_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub identity_provider_id: MaybeUndefined<String>,
     /// The domain name to add.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The email address to which to send the verification code.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub verification_email: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub verification_email: MaybeUndefined<String>,
     /// The authentication type this domain is for.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auth_type: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auth_type: MaybeUndefined<String>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct OrganizationDomainUpdateInput {
     /// Prevent users with this domain to create new workspaces. Only allowed to set on claimed domains!
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub disable_organization_creation: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub disable_organization_creation: MaybeUndefined<bool>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct OrganizationDomainVerificationInput {
     /// The identifier in UUID v4 format of the domain being verified.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub organization_domain_id: Option<String>,
+    pub organization_domain_id: String,
     /// The verification code sent via email.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub verification_code: Option<String>,
+    pub verification_code: String,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct OrganizationInviteCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The email of the invitee.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub email: Option<String>,
+    pub email: String,
     /// What user role the invite should grant.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub role: Option<UserRoleType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub role: MaybeUndefined<UserRoleType>,
     /// The teams that the user has been invited to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_ids: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_ids: MaybeUndefined<Vec<String>>,
     /// `INTERNAL` Optional metadata about the invite.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub metadata: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub metadata: MaybeUndefined<serde_json::Value>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct OrganizationInviteUpdateInput {
     /// The teams that the user has been invited to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_ids: Option<Vec<String>>,
+    pub team_ids: Vec<String>,
 }
 /// `INTERNAL` Organization IP restriction configuration.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct OrganizationIpRestrictionInput {
     /// IP range in CIDR format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub range: Option<String>,
+    pub range: String,
     /// Restriction type.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<String>,
+    pub r#type: String,
     /// Optional restriction description.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// Whether the restriction is enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enabled: Option<bool>,
+    pub enabled: bool,
+}
+/// `Internal` An MCP server URL entry for the Linear Agent allowlist.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct OrganizationLinearAgentMcpServerAllowlistEntryInput {
+    /// `Internal` The MCP server URL that Linear Agent is allowed to use.
+    pub url: String,
+}
+/// `Internal` Input for updating Linear Agent settings for the workspace.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct OrganizationLinearAgentSettingsInput {
+    /// `Internal` Whether the workspace has enabled web search for Linear Agent.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub web_search_enabled: MaybeUndefined<bool>,
+    /// `Internal` Whether the workspace has enabled MCP servers for Linear Agent.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub mcp_servers_enabled: MaybeUndefined<bool>,
+    /// `Internal` The MCP server allowlist for Linear Agent. When unset, all MCP servers are allowed.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub mcp_servers_allowlist:
+        MaybeUndefined<Vec<OrganizationLinearAgentMcpServerAllowlistEntryInput>>,
 }
+/// Input for updating workspace security settings such as role-based access controls.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct OrganizationSecuritySettingsInput {
     /// The minimum role required to create personal API keys.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub personal_api_keys_role: Option<UserRoleType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub personal_api_keys_role: MaybeUndefined<UserRoleType>,
     /// The minimum role required to invite users.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub invitations_role: Option<UserRoleType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub invitations_role: MaybeUndefined<UserRoleType>,
     /// The minimum role required to create teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_creation_role: Option<UserRoleType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_creation_role: MaybeUndefined<UserRoleType>,
     /// The minimum role required to manage workspace labels.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label_management_role: Option<UserRoleType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub label_management_role: MaybeUndefined<UserRoleType>,
     /// The minimum role required to manage API settings.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub api_settings_role: Option<UserRoleType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub api_settings_role: MaybeUndefined<UserRoleType>,
     /// The minimum role required to manage workspace templates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub template_management_role: Option<UserRoleType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub template_management_role: MaybeUndefined<UserRoleType>,
     /// The minimum role required to import data.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub import_role: Option<UserRoleType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub import_role: MaybeUndefined<UserRoleType>,
     /// The minimum role required to manage agent guidance prompts and settings.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub agent_guidance_role: Option<UserRoleType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub agent_guidance_role: MaybeUndefined<UserRoleType>,
     /// The minimum role required to install and connect new integrations.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub integration_creation_role: Option<UserRoleType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub integration_creation_role: MaybeUndefined<UserRoleType>,
 }
+/// Input for starting a workspace trial on a specific plan.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct OrganizationStartTrialInput {
     /// The plan type to trial.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub plan_type: Option<String>,
+    pub plan_type: String,
 }
+/// Input for updating the workspace.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct OrganizationUpdateInput {
-    /// The name of the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
-    /// The logo of the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub logo_url: Option<String>,
-    /// The URL key of the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub url_key: Option<String>,
+    /// The name of the workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
+    /// The logo URL of the workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub logo_url: MaybeUndefined<String>,
+    /// The URL key of the workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub url_key: MaybeUndefined<String>,
     /// How git branches are formatted. If null, default formatting will be used.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub git_branch_format: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub git_branch_format: MaybeUndefined<String>,
     /// Whether the Git integration linkback messages should be sent for private repositories.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub git_linkback_messages_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub git_linkback_messages_enabled: MaybeUndefined<bool>,
     /// Whether the Git integration linkback messages should be sent for public repositories.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub git_public_linkback_messages_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub git_public_linkback_messages_enabled: MaybeUndefined<bool>,
     /// Whether issue descriptions should be included in Git integration linkback messages.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub git_linkback_descriptions_enabled: Option<bool>,
-    /// Whether the organization is using roadmap.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub roadmap_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub git_linkback_descriptions_enabled: MaybeUndefined<bool>,
+    /// Whether the workspace is using roadmap.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub roadmap_enabled: MaybeUndefined<bool>,
     /// The n-weekly frequency at which to prompt for project updates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_update_reminder_frequency_in_weeks: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_update_reminder_frequency_in_weeks: MaybeUndefined<f64>,
     /// The day at which project updates are sent.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_update_reminders_day: Option<Day>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_update_reminders_day: MaybeUndefined<Day>,
     /// The hour at which project updates are sent.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_update_reminders_hour: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_update_reminders_hour: MaybeUndefined<f64>,
     /// `ALPHA` The n-weekly frequency at which to prompt for initiative updates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_update_reminder_frequency_in_weeks: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_update_reminder_frequency_in_weeks: MaybeUndefined<f64>,
     /// `ALPHA` The day at which initiative updates are sent.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_update_reminders_day: Option<Day>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_update_reminders_day: MaybeUndefined<Day>,
     /// `ALPHA` The hour at which initiative updates are sent.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_update_reminders_hour: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_update_reminders_hour: MaybeUndefined<f64>,
     /// The month at which the fiscal year starts.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub fiscal_year_start_month: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub fiscal_year_start_month: MaybeUndefined<f64>,
     /// `Internal` The list of working days. Sunday is 0, Monday is 1, etc.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub working_days: Option<Vec<f64>>,
-    /// Whether the organization has opted for reduced customer support attachment information.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub reduced_personal_information: Option<bool>,
-    /// Whether the organization has opted for having to approve all OAuth applications for install.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub oauth_app_review: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub working_days: MaybeUndefined<Vec<f64>>,
+    /// Whether the workspace has opted for reduced customer support attachment information.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reduced_personal_information: MaybeUndefined<bool>,
+    /// Whether the workspace has opted for having to approve all OAuth applications for install.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub oauth_app_review: MaybeUndefined<bool>,
     /// List of services that are allowed to be used for login.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub allowed_auth_services: Option<Vec<String>>,
-    /// Internal. Whether SLAs have been enabled for the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sla_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub allowed_auth_services: MaybeUndefined<Vec<String>>,
+    /// Internal. Whether SLAs have been enabled for the workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sla_enabled: MaybeUndefined<bool>,
     /// Whether agent invocation is restricted to full workspace members.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub restrict_agent_invocation_to_members: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub restrict_agent_invocation_to_members: MaybeUndefined<bool>,
     /// IP restriction configurations controlling allowed access the workspace.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ip_restrictions: Option<Vec<Box<OrganizationIpRestrictionInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ip_restrictions: MaybeUndefined<Vec<OrganizationIpRestrictionInput>>,
     /// Allowed file upload content types.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub allowed_file_upload_content_types: Option<Vec<String>>,
-    /// `ALPHA` Theme settings for the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub theme_settings: Option<serde_json::Value>,
-    /// `INTERNAL` Whether the organization is using customers.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customers_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub allowed_file_upload_content_types: MaybeUndefined<Vec<String>>,
+    /// `ALPHA` Theme settings for the workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub theme_settings: MaybeUndefined<serde_json::Value>,
+    /// `INTERNAL` Whether the workspace is using customers.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customers_enabled: MaybeUndefined<bool>,
     /// `INTERNAL` Configuration settings for the Customers feature.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customers_configuration: Option<serde_json::Value>,
-    /// `INTERNAL` Whether code intelligence is enabled for the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub code_intelligence_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customers_configuration: MaybeUndefined<serde_json::Value>,
+    /// `INTERNAL` Whether code intelligence is enabled for the workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub code_intelligence_enabled: MaybeUndefined<bool>,
     /// `INTERNAL` GitHub repository in owner/repo format for code intelligence.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub code_intelligence_repository: Option<String>,
-    /// Whether the organization has enabled the feed feature.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub feed_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub code_intelligence_repository: MaybeUndefined<String>,
+    /// Whether the workspace has enabled the feed feature.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub feed_enabled: MaybeUndefined<bool>,
     /// Whether to hide other workspaces for new users signing up with email domains claimed by this organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub hide_non_primary_organizations: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub hide_non_primary_organizations: MaybeUndefined<bool>,
     /// Default schedule for how often feed summaries are generated.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub default_feed_summary_schedule: Option<FeedSummarySchedule>,
-    /// `INTERNAL` Whether the organization has enabled the AI add-on.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ai_addon_enabled: Option<bool>,
-    /// `INTERNAL` Whether the organization has enabled generated updates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub generated_updates_enabled: Option<bool>,
-    /// `INTERNAL` Whether the organization has opted in to AI telemetry.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ai_telemetry_enabled: Option<bool>,
-    /// Whether the organization has enabled AI discussion summaries for issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ai_discussion_summaries_enabled: Option<bool>,
-    /// Whether the organization has enabled resolved thread AI summaries.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ai_thread_summaries_enabled: Option<bool>,
-    /// Whether HIPAA compliance is enabled for organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub hipaa_compliance_enabled: Option<bool>,
-    /// The security settings for the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub security_settings: Option<Box<OrganizationSecuritySettingsInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub default_feed_summary_schedule: MaybeUndefined<FeedSummarySchedule>,
+    /// `INTERNAL` Whether the workspace has enabled the AI add-on.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ai_addon_enabled: MaybeUndefined<bool>,
+    /// `INTERNAL` Whether the workspace has enabled agent automation.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub agent_automation_enabled: MaybeUndefined<bool>,
+    /// `INTERNAL` Whether the workspace has enabled generated updates.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub generated_updates_enabled: MaybeUndefined<bool>,
+    /// `INTERNAL` Whether the workspace has opted in to AI telemetry.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ai_telemetry_enabled: MaybeUndefined<bool>,
+    /// Whether the workspace has enabled AI discussion summaries for issues.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ai_discussion_summaries_enabled: MaybeUndefined<bool>,
+    /// Whether the workspace has enabled resolved thread AI summaries.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ai_thread_summaries_enabled: MaybeUndefined<bool>,
+    /// Whether HIPAA compliance is enabled for the workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub hipaa_compliance_enabled: MaybeUndefined<bool>,
+    /// The security settings for the workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub security_settings: MaybeUndefined<OrganizationSecuritySettingsInput>,
+    /// The authentication settings for the workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auth_settings: MaybeUndefined<OrganizationAuthSettingsInput>,
     /// `INTERNAL` Configure per-modality AI host providers and model families.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ai_provider_configuration: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ai_provider_configuration: MaybeUndefined<serde_json::Value>,
     /// The ID of the Slack integration to use for auto-creating project channels.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_project_channel_integration_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_project_channel_integration_id: MaybeUndefined<String>,
     /// The prefix to use for auto-created Slack project channels (p-, proj-, or project-).
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_project_channel_prefix: Option<String>,
-    /// `Internal` Whether the organization has enabled Linear Agent.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub linear_agent_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_project_channel_prefix: MaybeUndefined<String>,
+    /// `Internal` Whether the Slack project channels feature is enabled for the workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_project_channels_enabled: MaybeUndefined<bool>,
+    /// `Internal` Whether to automatically create a Slack channel when a new project is created.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_auto_create_project_channel: MaybeUndefined<bool>,
+    /// `Internal` Whether the workspace has enabled Linear Agent.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub linear_agent_enabled: MaybeUndefined<bool>,
+    /// `Internal` Settings for Linear Agent features.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub linear_agent_settings: MaybeUndefined<OrganizationLinearAgentSettingsInput>,
+    /// `INTERNAL` Whether the workspace has enabled the Coding Agent.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub coding_agent_enabled: MaybeUndefined<bool>,
 }
 /// Customer owner sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct OwnerSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct PagerDutyInput {
     /// The date when the PagerDuty API failed with an unauthorized error.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub api_failed_with_unauthorized_error_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub api_failed_with_unauthorized_error_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct PartialNotificationChannelPreferencesInput {
     /// Whether notifications are currently enabled for mobile.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub mobile: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub mobile: MaybeUndefined<bool>,
     /// Whether notifications are currently enabled for desktop.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub desktop: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub desktop: MaybeUndefined<bool>,
     /// Whether notifications are currently enabled for email.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub email: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub email: MaybeUndefined<bool>,
     /// Whether notifications are currently enabled for Slack.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack: MaybeUndefined<bool>,
 }
 /// Issue priority sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct PrioritySort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
     /// Whether to consider no priority as the highest or lowest priority
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub no_priority_first: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub no_priority_first: MaybeUndefined<bool>,
 }
 /// Project filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the project name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the project slug ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slug_id: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slug_id: MaybeUndefined<StringComparator>,
     /// `DEPRECATED` Comparator for the project state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub state: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub state: MaybeUndefined<StringComparator>,
     /// Filters that the project's status must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status: Option<Box<ProjectStatusFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status: MaybeUndefined<Box<ProjectStatusFilter>>,
     /// Comparator for the projects priority.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority: Option<Box<NullableNumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority: MaybeUndefined<NullableNumberComparator>,
     /// Filters that project labels must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub labels: Option<Box<ProjectLabelCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub labels: MaybeUndefined<Box<ProjectLabelCollectionFilter>>,
     /// `Internal` Comparator for the project's content.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub searchable_content: Option<Box<ContentComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub searchable_content: MaybeUndefined<ContentComparator>,
     /// Comparator for the project started date (when it was moved to an "In Progress" status).
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub started_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub started_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the project completion date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub completed_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the project cancelation date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub canceled_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub canceled_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the project start date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub start_date: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub start_date: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the project target date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the project health: onTrack, atRisk, offTrack
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health: MaybeUndefined<StringComparator>,
     /// Comparator for the project health (with age): onTrack, atRisk, offTrack, outdated, noUpdate
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health_with_age: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health_with_age: MaybeUndefined<StringComparator>,
     /// `ALPHA` Comparator for the project activity type: buzzin, active, some, none
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub activity_type: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub activity_type: MaybeUndefined<StringComparator>,
     /// Comparator for filtering projects with relations.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_related_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_related_relations: MaybeUndefined<RelationExistsComparator>,
     /// `Deprecated` Comparator for filtering projects which this is depended on by.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_depended_on_by_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_depended_on_by_relations: MaybeUndefined<RelationExistsComparator>,
     /// `Deprecated`Comparator for filtering projects which this depends on.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_depends_on_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_depends_on_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering projects which are blocked.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_blocked_by_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_blocked_by_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering projects which are blocking.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_blocking_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_blocking_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering projects with violated dependencies.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_violated_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_violated_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for the project updates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_updates: Option<Box<ProjectUpdatesCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_updates: MaybeUndefined<ProjectUpdatesCollectionFilter>,
     /// Filters that the projects creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<UserFilter>>,
     /// Filters that the projects lead must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lead: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lead: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the projects members must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub members: Option<Box<UserCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub members: MaybeUndefined<Box<UserCollectionFilter>>,
     /// Filters that the projects issues must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issues: Option<Box<IssueCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issues: MaybeUndefined<Box<IssueCollectionFilter>>,
     /// Filters that the projects roadmaps must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub roadmaps: Option<Box<RoadmapCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub roadmaps: MaybeUndefined<Box<RoadmapCollectionFilter>>,
     /// Filters that the projects initiatives must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiatives: Option<Box<InitiativeCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiatives: MaybeUndefined<Box<InitiativeCollectionFilter>>,
     /// Filters that the project's milestones must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_milestones: Option<Box<ProjectMilestoneCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_milestones: MaybeUndefined<Box<ProjectMilestoneCollectionFilter>>,
     /// Filters that the project's completed milestones must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub completed_project_milestones: Option<Box<ProjectMilestoneCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_project_milestones: MaybeUndefined<Box<ProjectMilestoneCollectionFilter>>,
     /// Filters that the project's next milestone must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub next_project_milestone: Option<Box<ProjectMilestoneFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub next_project_milestone: MaybeUndefined<Box<ProjectMilestoneFilter>>,
     /// Filters that the project's team must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub accessible_teams: Option<Box<TeamCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub accessible_teams: MaybeUndefined<Box<TeamCollectionFilter>>,
     /// Filters that the last applied template must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub last_applied_template: Option<Box<NullableTemplateFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub last_applied_template: MaybeUndefined<NullableTemplateFilter>,
     /// Filters that the project's customer needs must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub needs: Option<Box<CustomerNeedCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub needs: MaybeUndefined<Box<CustomerNeedCollectionFilter>>,
     /// Count of customers
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_count: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_count: MaybeUndefined<NumberComparator>,
     /// Count of important customers
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_important_count: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_important_count: MaybeUndefined<NumberComparator>,
     /// Compound filters, all of which need to be matched by the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ProjectCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ProjectCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ProjectCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ProjectCollectionFilter>>,
     /// Filters that needs to be matched by some projects.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<ProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<Box<ProjectFilter>>,
     /// Filters that needs to be matched by all projects.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<ProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<Box<ProjectFilter>>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
 }
+/// Input for creating a new project. A name and at least one team are required. All other fields are optional and will use defaults if not specified.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The name of the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The icon of the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub icon: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub icon: MaybeUndefined<String>,
     /// The color of the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// The ID of the project status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status_id: MaybeUndefined<String>,
     /// The description for the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The project content as markdown.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub content: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub content: MaybeUndefined<String>,
     /// The identifiers of the teams this project is associated with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_ids: Option<Vec<String>>,
-    /// The ID of the issue from which that project is created.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub converted_from_issue_id: Option<String>,
+    pub team_ids: Vec<String>,
+    /// The ID of the issue that was converted into this project.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub converted_from_issue_id: MaybeUndefined<String>,
     /// The ID of the last template applied to the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub last_applied_template_id: Option<String>,
-    /// The ID of the template to apply when creating the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub template_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub last_applied_template_id: MaybeUndefined<String>,
+    /// The ID of a project template to apply when creating the project. Overrides useDefaultTemplate if both are provided.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub template_id: MaybeUndefined<String>,
     /// When set to true, the default project template of the first team provided will be applied. If templateId is provided, this will be ignored.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub use_default_template: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub use_default_template: MaybeUndefined<bool>,
     /// The identifier of the project lead.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lead_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lead_id: MaybeUndefined<String>,
     /// The identifiers of the members of this project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub member_ids: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub member_ids: MaybeUndefined<Vec<String>>,
     /// The planned start date of the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub start_date: Option<chrono::NaiveDate>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub start_date: MaybeUndefined<chrono::NaiveDate>,
     /// The resolution of the project's start date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub start_date_resolution: Option<DateResolutionType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub start_date_resolution: MaybeUndefined<DateResolutionType>,
     /// The planned target date of the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<chrono::NaiveDate>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<chrono::NaiveDate>,
     /// The resolution of the project's estimated completion date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date_resolution: Option<DateResolutionType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date_resolution: MaybeUndefined<DateResolutionType>,
     /// The sort order for the project within shared views.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
     /// The sort order for the project within shared views, when ordered by priority.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority_sort_order: Option<f64>,
-    /// The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority: Option<i64>,
-    /// `Internal`The identifiers of the project labels associated with this project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label_ids: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority_sort_order: MaybeUndefined<f64>,
+    /// The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority: MaybeUndefined<i64>,
+    /// `Internal` The identifiers of the project labels associated with this project.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub label_ids: MaybeUndefined<Vec<String>>,
 }
 /// Project creation date sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectCreatedAtSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Project filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the project name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the project slug ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slug_id: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slug_id: MaybeUndefined<StringComparator>,
     /// `DEPRECATED` Comparator for the project state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub state: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub state: MaybeUndefined<StringComparator>,
     /// Filters that the project's status must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status: Option<Box<ProjectStatusFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status: MaybeUndefined<Box<ProjectStatusFilter>>,
     /// Comparator for the projects priority.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority: Option<Box<NullableNumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority: MaybeUndefined<NullableNumberComparator>,
     /// Filters that project labels must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub labels: Option<Box<ProjectLabelCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub labels: MaybeUndefined<Box<ProjectLabelCollectionFilter>>,
     /// `Internal` Comparator for the project's content.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub searchable_content: Option<Box<ContentComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub searchable_content: MaybeUndefined<ContentComparator>,
     /// Comparator for the project started date (when it was moved to an "In Progress" status).
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub started_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub started_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the project completion date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub completed_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the project cancelation date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub canceled_at: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub canceled_at: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the project start date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub start_date: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub start_date: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the project target date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<NullableDateComparator>,
     /// Comparator for the project health: onTrack, atRisk, offTrack
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health: MaybeUndefined<StringComparator>,
     /// Comparator for the project health (with age): onTrack, atRisk, offTrack, outdated, noUpdate
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health_with_age: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health_with_age: MaybeUndefined<StringComparator>,
     /// `ALPHA` Comparator for the project activity type: buzzin, active, some, none
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub activity_type: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub activity_type: MaybeUndefined<StringComparator>,
     /// Comparator for filtering projects with relations.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_related_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_related_relations: MaybeUndefined<RelationExistsComparator>,
     /// `Deprecated` Comparator for filtering projects which this is depended on by.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_depended_on_by_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_depended_on_by_relations: MaybeUndefined<RelationExistsComparator>,
     /// `Deprecated`Comparator for filtering projects which this depends on.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_depends_on_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_depends_on_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering projects which are blocked.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_blocked_by_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_blocked_by_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering projects which are blocking.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_blocking_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_blocking_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for filtering projects with violated dependencies.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_violated_relations: Option<Box<RelationExistsComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub has_violated_relations: MaybeUndefined<RelationExistsComparator>,
     /// Comparator for the project updates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_updates: Option<Box<ProjectUpdatesCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_updates: MaybeUndefined<ProjectUpdatesCollectionFilter>,
     /// Filters that the projects creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<UserFilter>>,
     /// Filters that the projects lead must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lead: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lead: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the projects members must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub members: Option<Box<UserCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub members: MaybeUndefined<Box<UserCollectionFilter>>,
     /// Filters that the projects issues must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issues: Option<Box<IssueCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issues: MaybeUndefined<Box<IssueCollectionFilter>>,
     /// Filters that the projects roadmaps must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub roadmaps: Option<Box<RoadmapCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub roadmaps: MaybeUndefined<Box<RoadmapCollectionFilter>>,
     /// Filters that the projects initiatives must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiatives: Option<Box<InitiativeCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiatives: MaybeUndefined<Box<InitiativeCollectionFilter>>,
     /// Filters that the project's milestones must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_milestones: Option<Box<ProjectMilestoneCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_milestones: MaybeUndefined<Box<ProjectMilestoneCollectionFilter>>,
     /// Filters that the project's completed milestones must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub completed_project_milestones: Option<Box<ProjectMilestoneCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_project_milestones: MaybeUndefined<Box<ProjectMilestoneCollectionFilter>>,
     /// Filters that the project's next milestone must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub next_project_milestone: Option<Box<ProjectMilestoneFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub next_project_milestone: MaybeUndefined<Box<ProjectMilestoneFilter>>,
     /// Filters that the project's team must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub accessible_teams: Option<Box<TeamCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub accessible_teams: MaybeUndefined<Box<TeamCollectionFilter>>,
     /// Filters that the last applied template must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub last_applied_template: Option<Box<NullableTemplateFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub last_applied_template: MaybeUndefined<NullableTemplateFilter>,
     /// Filters that the project's customer needs must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub needs: Option<Box<CustomerNeedCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub needs: MaybeUndefined<Box<CustomerNeedCollectionFilter>>,
     /// Count of customers
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_count: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_count: MaybeUndefined<NumberComparator>,
     /// Count of important customers
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_important_count: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_important_count: MaybeUndefined<NumberComparator>,
     /// Compound filters, all of which need to be matched by the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ProjectFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ProjectFilter>>,
     /// Compound filters, one of which need to be matched by the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ProjectFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ProjectFilter>>,
 }
 /// Project health sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectHealthSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Project label filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectLabelCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for whether the label is a group label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_group: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_group: MaybeUndefined<BooleanComparator>,
     /// Filters that the project labels creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the project label's parent label must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent: Option<Box<ProjectLabelFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent: MaybeUndefined<Box<ProjectLabelFilter>>,
     /// Filter based on the existence of the relation.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Compound filters, all of which need to be matched by the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ProjectLabelCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ProjectLabelCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ProjectLabelCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ProjectLabelCollectionFilter>>,
     /// Filters that needs to be matched by some project labels.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<ProjectLabelCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<Box<ProjectLabelCollectionFilter>>,
     /// Filters that needs to be matched by all project labels.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<ProjectLabelFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<Box<ProjectLabelFilter>>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
 }
+/// Input for creating a new project label. A name is required. The label is created as a workspace-level label available to all projects.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectLabelCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The name of the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The description of the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The color of the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// The identifier of the parent label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent_id: MaybeUndefined<String>,
     /// Whether the label is a group.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_group: Option<bool>,
-    /// When the label was retired.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub retired_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_group: MaybeUndefined<bool>,
+    /// The time at which the label was retired. Set to null to restore a retired label.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub retired_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
 }
 /// Project label filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectLabelFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for whether the label is a group label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_group: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_group: MaybeUndefined<BooleanComparator>,
     /// Filters that the project labels creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<NullableUserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<NullableUserFilter>>,
     /// Filters that the project label's parent label must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent: Option<Box<ProjectLabelFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent: MaybeUndefined<Box<ProjectLabelFilter>>,
     /// Compound filters, all of which need to be matched by the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ProjectLabelFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ProjectLabelFilter>>,
     /// Compound filters, one of which need to be matched by the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ProjectLabelFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ProjectLabelFilter>>,
 }
+/// Input for updating an existing project label. All fields are optional; only provided fields will be updated.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectLabelUpdateInput {
     /// The name of the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The description of the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The identifier of the parent label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent_id: MaybeUndefined<String>,
     /// The color of the label.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// Whether the label is a group.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_group: Option<bool>,
-    /// When the label was retired.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub retired_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_group: MaybeUndefined<bool>,
+    /// The time at which the label was retired. Set to null to restore a retired label.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub retired_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
 }
 /// Project lead sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectLeadSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Project manual order sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectManualSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Milestone collection filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectMilestoneCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the project milestone name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<NullableStringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<NullableStringComparator>,
     /// Comparator for the project milestone target date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<NullableDateComparator>,
     /// Filters that the project milestone's project must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project: Option<Box<NullableProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<Box<NullableProjectFilter>>,
     /// Compound filters, all of which need to be matched by the milestone.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ProjectMilestoneCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ProjectMilestoneCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the milestone.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ProjectMilestoneCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ProjectMilestoneCollectionFilter>>,
     /// Filters that needs to be matched by some milestones.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<ProjectMilestoneFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<Box<ProjectMilestoneFilter>>,
     /// Filters that needs to be matched by all milestones.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<ProjectMilestoneFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<Box<ProjectMilestoneFilter>>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
 }
+/// Input for creating a new project milestone.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectMilestoneCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The name of the project milestone.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The description of the project milestone in markdown format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// `Internal` The description of the project milestone as a Prosemirror document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description_data: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description_data: MaybeUndefined<serde_json::Value>,
     /// The planned target date of the project milestone.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<chrono::NaiveDate>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<chrono::NaiveDate>,
     /// Related project for the project milestone.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    pub project_id: String,
     /// The sort order for the project milestone within a project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
 }
 /// Project milestone filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectMilestoneFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the project milestone name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<NullableStringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<NullableStringComparator>,
     /// Comparator for the project milestone target date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<Box<NullableDateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<NullableDateComparator>,
     /// Filters that the project milestone's project must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project: Option<Box<NullableProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<Box<NullableProjectFilter>>,
     /// Compound filters, all of which need to be matched by the project milestone.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ProjectMilestoneFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ProjectMilestoneFilter>>,
     /// Compound filters, one of which need to be matched by the project milestone.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ProjectMilestoneFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ProjectMilestoneFilter>>,
 }
+/// `Internal` Input for moving a project milestone to another project.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectMilestoneMoveInput {
     /// The identifier of the project to move the milestone to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    pub project_id: String,
     /// The team id to move the attached issues to. This is needed when there is a mismatch between a project's teams and the milestone's issues' teams. Either this or addIssueTeamToProject is required in that situation to resolve constraints.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub new_issue_team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub new_issue_team_id: MaybeUndefined<String>,
     /// Whether to add each milestone issue's team to the project. This is needed when there is a mismatch between a project's teams and the milestone's issues' teams. Either this or newIssueTeamId is required in that situation to resolve constraints.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub add_issue_team_to_project: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub add_issue_team_to_project: MaybeUndefined<bool>,
     /// A list of issue id to team ids, used for undoing a previous milestone move where the specified issues were moved from the specified teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub undo_issue_team_ids: Option<Vec<Box<ProjectMilestoneMoveIssueToTeamInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub undo_issue_team_ids: MaybeUndefined<Vec<ProjectMilestoneMoveIssueToTeamInput>>,
     /// A mapping of project id to a previous set of team ids, used for undoing a previous milestone move where the specified teams were added to the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub undo_project_team_ids: Option<Box<ProjectMilestoneMoveProjectTeamsInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub undo_project_team_ids: MaybeUndefined<ProjectMilestoneMoveProjectTeamsInput>,
 }
 /// `Internal` Used for ProjectMilestoneMoveInput to describe a mapping between an issue and its team.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectMilestoneMoveIssueToTeamInput {
     /// The issue id in this relationship, you can use * as wildcard if all issues are being moved to the same team
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_id: Option<String>,
+    pub issue_id: String,
     /// The team id in this relationship
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    pub team_id: String,
 }
 /// `Internal` Used for ProjectMilestoneMoveInput to describe a snapshot of a project and its team ids
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectMilestoneMoveProjectTeamsInput {
     /// The project id
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    pub project_id: String,
     /// The team ids for the project
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_ids: Option<Vec<String>>,
+    pub team_ids: Vec<String>,
 }
+/// Input for updating an existing project milestone.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectMilestoneUpdateInput {
     /// The name of the project milestone.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The description of the project milestone in markdown format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// `Internal` The description of the project milestone as a Prosemirror document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description_data: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description_data: MaybeUndefined<serde_json::Value>,
     /// The planned target date of the project milestone.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<chrono::NaiveDate>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<chrono::NaiveDate>,
     /// The sort order for the project milestone within a project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
     /// Related project for the project milestone.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
 }
 /// Project name sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectNameSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Project priority sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectPrioritySort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
     /// Whether to consider no priority as the highest or lowest priority
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub no_priority_first: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub no_priority_first: MaybeUndefined<bool>,
 }
+/// Input for creating a new project relation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectRelationCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The type of relation of the project to the related project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<String>,
+    pub r#type: String,
     /// The identifier of the project that is related to another project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    pub project_id: String,
     /// The identifier of the project milestone.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_milestone_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_milestone_id: MaybeUndefined<String>,
     /// The type of the anchor for the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub anchor_type: Option<String>,
+    pub anchor_type: String,
     /// The identifier of the related project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub related_project_id: Option<String>,
+    pub related_project_id: String,
     /// The identifier of the related project milestone.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub related_project_milestone_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub related_project_milestone_id: MaybeUndefined<String>,
     /// The type of the anchor for the related project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub related_anchor_type: Option<String>,
+    pub related_anchor_type: String,
 }
+/// Input for updating an existing project relation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectRelationUpdateInput {
     /// The type of relation of the project to the related project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<String>,
     /// The identifier of the project that is related to another project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
     /// The identifier of the project milestone.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_milestone_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_milestone_id: MaybeUndefined<String>,
     /// The type of the anchor for the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub anchor_type: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub anchor_type: MaybeUndefined<String>,
     /// The identifier of the related project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub related_project_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub related_project_id: MaybeUndefined<String>,
     /// The identifier of the related project milestone.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub related_project_milestone_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub related_project_milestone_id: MaybeUndefined<String>,
     /// The type of the anchor for the related project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub related_anchor_type: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub related_anchor_type: MaybeUndefined<String>,
 }
 /// Issue project sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Project sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectSortInput {
     /// Sort by project name
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<ProjectNameSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<ProjectNameSort>,
     /// Sort by project status
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status: Option<Box<ProjectStatusSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status: MaybeUndefined<ProjectStatusSort>,
     /// Sort by project priority
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority: Option<Box<ProjectPrioritySort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority: MaybeUndefined<ProjectPrioritySort>,
     /// Sort by manual order
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub manual: Option<Box<ProjectManualSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub manual: MaybeUndefined<ProjectManualSort>,
     /// Sort by project target date
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<Box<TargetDateSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<TargetDateSort>,
     /// Sort by project start date
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub start_date: Option<Box<StartDateSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub start_date: MaybeUndefined<StartDateSort>,
     /// Sort by project creation date
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<ProjectCreatedAtSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<ProjectCreatedAtSort>,
     /// Sort by project update date
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<ProjectUpdatedAtSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<ProjectUpdatedAtSort>,
     /// Sort by project health status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health: Option<Box<ProjectHealthSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health: MaybeUndefined<ProjectHealthSort>,
     /// Sort by project lead name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lead: Option<Box<ProjectLeadSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lead: MaybeUndefined<ProjectLeadSort>,
 }
-#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+/// Input for creating a new project status.
+#[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectStatusCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The name of the status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The UI color of the status as a HEX string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    pub color: String,
     /// Description of the status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The position of the status in the workspace's project flow.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub position: Option<f64>,
+    pub position: f64,
     /// The type of the project status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<ProjectStatusType>,
+    pub r#type: ProjectStatusType,
     /// Whether or not a project can be in this status indefinitely.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub indefinite: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub indefinite: MaybeUndefined<bool>,
 }
 /// Project status filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectStatusFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the project status name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the project status description.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<StringComparator>,
     /// Comparator for the project status position.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub position: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub position: MaybeUndefined<NumberComparator>,
     /// Comparator for the project status type.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<StringComparator>,
     /// Filters that the project status projects must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub projects: Option<Box<ProjectCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub projects: MaybeUndefined<Box<ProjectCollectionFilter>>,
     /// Compound filters, all of which need to be matched by the project status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ProjectStatusFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ProjectStatusFilter>>,
     /// Compound filters, one of which needs to be matched by the project status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ProjectStatusFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ProjectStatusFilter>>,
 }
 /// Project status sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectStatusSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
+/// Input for updating an existing project status.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectStatusUpdateInput {
     /// The name of the status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The UI color of the status as a HEX string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// Description of the status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The position of the status in the workspace's project flow.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub position: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub position: MaybeUndefined<f64>,
     /// The type of the project status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<ProjectStatusType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<ProjectStatusType>,
     /// Whether or not a project can be in this status indefinitely.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub indefinite: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub indefinite: MaybeUndefined<bool>,
 }
+/// Input for creating a new project update.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectUpdateCreateInput {
     /// The identifier. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The content of the project update in markdown format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body: MaybeUndefined<String>,
     /// `Internal` The content of the project update as a Prosemirror document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body_data: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body_data: MaybeUndefined<serde_json::Value>,
     /// The project to associate the project update with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    pub project_id: String,
     /// The health of the project at the time of the update.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health: Option<ProjectUpdateHealthType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health: MaybeUndefined<ProjectUpdateHealthType>,
     /// Whether the diff between the current update and the previous one should be hidden.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_diff_hidden: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_diff_hidden: MaybeUndefined<bool>,
 }
 /// Options for filtering project updates.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectUpdateFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Filters that the project update creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub user: MaybeUndefined<UserFilter>,
     /// Filters that the project update project must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project: Option<Box<ProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project: MaybeUndefined<ProjectFilter>,
     /// Filters that the project updates reactions must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub reactions: Option<Box<ReactionCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reactions: MaybeUndefined<ReactionCollectionFilter>,
     /// Compound filters, all of which need to be matched by the ProjectUpdate.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ProjectUpdateFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ProjectUpdateFilter>>,
     /// Compound filters, one of which need to be matched by the ProjectUpdate.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ProjectUpdateFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ProjectUpdateFilter>>,
 }
+/// Input for updating an existing project. All fields are optional; only provided fields will be updated. Setting a field to null (where supported) will clear the value.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectUpdateInput {
     /// The ID of the project status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status_id: MaybeUndefined<String>,
     /// The name of the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The description for the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The project content as markdown.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub content: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub content: MaybeUndefined<String>,
     /// The ID of the issue from which that project is created.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub converted_from_issue_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub converted_from_issue_id: MaybeUndefined<String>,
     /// The ID of the last template applied to the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub last_applied_template_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub last_applied_template_id: MaybeUndefined<String>,
     /// The icon of the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub icon: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub icon: MaybeUndefined<String>,
     /// The color of the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// The identifiers of the teams this project is associated with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_ids: Option<Vec<String>>,
-    /// The time until which project update reminders are paused.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_update_reminders_paused_until_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The n-weekly frequency at which to prompt for updates. When not set, reminders are inherited from workspace.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub update_reminder_frequency_in_weeks: Option<f64>,
-    /// The frequency at which to prompt for updates. When not set, reminders are inherited from workspace.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub update_reminder_frequency: Option<f64>,
-    /// The frequency resolution.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub frequency_resolution: Option<FrequencyResolutionType>,
-    /// The day at which to prompt for updates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub update_reminders_day: Option<Day>,
-    /// The hour at which to prompt for updates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub update_reminders_hour: Option<i64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_ids: MaybeUndefined<Vec<String>>,
+    /// The time until which project update reminders are paused. Set to null to resume reminders.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_update_reminders_paused_until_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
+    /// The n-weekly frequency at which to prompt for project updates. When not set, reminders are inherited from workspace settings.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub update_reminder_frequency_in_weeks: MaybeUndefined<f64>,
+    /// The frequency at which to prompt for project updates. When not set, reminders are inherited from workspace settings.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub update_reminder_frequency: MaybeUndefined<f64>,
+    /// The resolution type for the update reminder frequency (e.g., weekly, biweekly).
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub frequency_resolution: MaybeUndefined<FrequencyResolutionType>,
+    /// The day of the week on which to prompt for project updates.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub update_reminders_day: MaybeUndefined<Day>,
+    /// The hour of the day (0-23) at which to prompt for project updates.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub update_reminders_hour: MaybeUndefined<i64>,
     /// The identifier of the project lead.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub lead_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub lead_id: MaybeUndefined<String>,
     /// The identifiers of the members of this project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub member_ids: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub member_ids: MaybeUndefined<Vec<String>>,
     /// The planned start date of the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub start_date: Option<chrono::NaiveDate>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub start_date: MaybeUndefined<chrono::NaiveDate>,
     /// The resolution of the project's start date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub start_date_resolution: Option<DateResolutionType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub start_date_resolution: MaybeUndefined<DateResolutionType>,
     /// The planned target date of the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<chrono::NaiveDate>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<chrono::NaiveDate>,
     /// The resolution of the project's estimated completion date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date_resolution: Option<DateResolutionType>,
-    /// The date when the project was completed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub completed_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The date when the project was canceled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub canceled_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date_resolution: MaybeUndefined<DateResolutionType>,
+    /// The time at which the project was completed.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
+    /// The time at which the project was canceled.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub canceled_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
     /// Whether to send new issue notifications to Slack.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_new_issue: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_new_issue: MaybeUndefined<bool>,
     /// Whether to send new issue comment notifications to Slack.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_comments: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_comments: MaybeUndefined<bool>,
     /// Whether to send issue status update notifications to Slack.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_statuses: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_statuses: MaybeUndefined<bool>,
     /// The sort order for the project in shared views.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
     /// The sort order for the project within shared views, when ordered by priority.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority_sort_order: Option<f64>,
-    /// Whether the project has been trashed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub trashed: Option<bool>,
-    /// The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub priority: Option<i64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority_sort_order: MaybeUndefined<f64>,
+    /// Whether the project has been trashed. Set to true to trash, or null to restore.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub trashed: MaybeUndefined<bool>,
+    /// The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub priority: MaybeUndefined<i64>,
     /// The identifiers of the project labels associated with this project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label_ids: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub label_ids: MaybeUndefined<Vec<String>>,
 }
+/// Input for updating an existing project update.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectUpdateUpdateInput {
     /// The content of the project update in markdown format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body: MaybeUndefined<String>,
     /// The content of the project update as a Prosemirror document.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub body_data: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub body_data: MaybeUndefined<serde_json::Value>,
     /// The health of the project at the time of the update.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health: Option<ProjectUpdateHealthType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health: MaybeUndefined<ProjectUpdateHealthType>,
     /// Whether the diff between the current update and the previous one should be hidden.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_diff_hidden: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_diff_hidden: MaybeUndefined<bool>,
 }
 /// Project update date sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectUpdatedAtSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Collection filtering options for filtering projects by project updates.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectUpdatesCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the project update health.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health: MaybeUndefined<StringComparator>,
     /// Compound filters, all of which need to be matched by the project update.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ProjectUpdatesCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ProjectUpdatesCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the update.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ProjectUpdatesCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ProjectUpdatesCollectionFilter>>,
     /// Filters that needs to be matched by some updates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<ProjectUpdatesFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<ProjectUpdatesFilter>,
     /// Filters that needs to be matched by all updates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<ProjectUpdatesFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<ProjectUpdatesFilter>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
 }
 /// Options for filtering projects by project updates.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ProjectUpdatesFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the project update health.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub health: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub health: MaybeUndefined<StringComparator>,
     /// Compound filters, all of which need to be matched by the project updates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ProjectUpdatesFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ProjectUpdatesFilter>>,
     /// Compound filters, one of which need to be matched by the project updates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ProjectUpdatesFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ProjectUpdatesFilter>>,
 }
-/// Input for referencing a pull request by repository and number.
+/// A reference to a pull request by its repository owner, name, and pull request number. Used during release sync to look up pull requests and associate their linked issues with the release.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct PullRequestReferenceInput {
     /// The owner of the repository (e.g., organization or user name).
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub repository_owner: Option<String>,
+    pub repository_owner: String,
     /// The name of the repository.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub repository_name: Option<String>,
+    pub repository_name: String,
     /// The pull request number.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub number: Option<f64>,
+    pub number: i64,
 }
+/// Input for creating a push subscription to receive push notifications on a device or browser.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct PushSubscriptionCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
-    /// The data of the subscription in stringified JSON format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub data: Option<String>,
-    /// Whether this is a subscription payload for Google Cloud Messaging or Apple Push Notification service.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<PushSubscriptionType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
+    /// The push subscription data in stringified JSON format. For web subscriptions, this must contain keys, endpoint, and expirationTime fields per the Web Push API specification. For mobile subscriptions, this contains the device token.
+    pub data: String,
+    /// The type of push subscription: 'web' for browser-based Web Push API, 'apple' for Apple Push Notification service (or 'appleDevelopment' for sandbox), or 'firebase' for Firebase Cloud Messaging (Android).
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<PushSubscriptionType>,
 }
 /// Reaction filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReactionCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the reactions emoji.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub emoji: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub emoji: MaybeUndefined<StringComparator>,
     /// Comparator for the reactions custom emoji.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub custom_emoji_id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub custom_emoji_id: MaybeUndefined<IDComparator>,
     /// Compound filters, all of which need to be matched by the reaction.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ReactionCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ReactionCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the reaction.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ReactionCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ReactionCollectionFilter>>,
     /// Filters that needs to be matched by some reactions.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<ReactionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<ReactionFilter>,
     /// Filters that needs to be matched by all reactions.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<ReactionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<ReactionFilter>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
 }
+/// Input for creating a new reaction.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReactionCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The emoji the user reacted with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub emoji: Option<String>,
+    pub emoji: String,
     /// The comment to associate the reaction with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub comment_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub comment_id: MaybeUndefined<String>,
     /// The project update to associate the reaction with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_update_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_update_id: MaybeUndefined<String>,
     /// The update to associate the reaction with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_update_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_update_id: MaybeUndefined<String>,
     /// The issue to associate the reaction with. Can be a UUID or issue identifier (e.g., 'LIN-123').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_id: MaybeUndefined<String>,
     /// `Internal` The post to associate the reaction with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub post_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub post_id: MaybeUndefined<String>,
     /// `Internal` The pull request to associate the reaction with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub pull_request_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub pull_request_id: MaybeUndefined<String>,
     /// `Internal` The pull request comment to associate the reaction with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub pull_request_comment_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub pull_request_comment_id: MaybeUndefined<String>,
 }
 /// Reaction filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReactionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the reactions emoji.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub emoji: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub emoji: MaybeUndefined<StringComparator>,
     /// Comparator for the reactions custom emoji.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub custom_emoji_id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub custom_emoji_id: MaybeUndefined<IDComparator>,
     /// Compound filters, all of which need to be matched by the reaction.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ReactionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ReactionFilter>>,
     /// Compound filters, one of which need to be matched by the reaction.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ReactionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ReactionFilter>>,
 }
 /// Comparator for relation existence.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct RelationExistsComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<bool>,
     /// Not equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<bool>,
 }
 /// `ALPHA` Release collection filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleaseCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
+    /// Comparator for the release name.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
+    /// Comparator for the release version.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub version: MaybeUndefined<StringComparator>,
     /// Filters that the release's pipeline must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub pipeline: Option<Box<ReleasePipelineFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub pipeline: MaybeUndefined<Box<ReleasePipelineFilter>>,
     /// Filters that the release's stage must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub stage: Option<Box<ReleaseStageFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub stage: MaybeUndefined<ReleaseStageFilter>,
+    /// Comparator for the release completion date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<NullableDateComparator>,
     /// Compound filters, all of which need to be matched by the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ReleaseCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ReleaseCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ReleaseCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ReleaseCollectionFilter>>,
     /// Filters that needs to be matched by some releases.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<ReleaseFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<Box<ReleaseFilter>>,
     /// Filters that needs to be matched by all releases.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<ReleaseFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<Box<ReleaseFilter>>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
 }
+/// Input for completing a release in a specific pipeline.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleaseCompleteInput {
     /// The version of the release to complete. If not provided, the latest started release will be completed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub version: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub version: MaybeUndefined<String>,
     /// The commit SHA associated with this completion. If a completed release with this SHA already exists, it will be returned instead of completing a new release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub commit_sha: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub commit_sha: MaybeUndefined<String>,
     /// The identifier of the pipeline to mark a release as completed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub pipeline_id: Option<String>,
+    pub pipeline_id: String,
 }
+/// Base input for completing a release. Contains the optional version and commit SHA. The pipeline ID is provided separately or inferred from the access key.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleaseCompleteInputBase {
     /// The version of the release to complete. If not provided, the latest started release will be completed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub version: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub version: MaybeUndefined<String>,
     /// The commit SHA associated with this completion. If a completed release with this SHA already exists, it will be returned instead of completing a new release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub commit_sha: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub commit_sha: MaybeUndefined<String>,
 }
 /// The input for creating a release.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleaseCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The name of the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The description of the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The version of the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub version: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub version: MaybeUndefined<String>,
     /// The commit SHA associated with this release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub commit_sha: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub commit_sha: MaybeUndefined<String>,
     /// The identifier of the pipeline this release belongs to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub pipeline_id: Option<String>,
+    pub pipeline_id: String,
     /// The current stage of the release. Defaults to the first 'completed' stage for continuous pipelines, or the first 'started' stage for scheduled pipelines.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub stage_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub stage_id: MaybeUndefined<String>,
     /// The estimated start date of the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub start_date: Option<chrono::NaiveDate>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub start_date: MaybeUndefined<chrono::NaiveDate>,
     /// The estimated completion date of the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<chrono::NaiveDate>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<chrono::NaiveDate>,
 }
-/// Debug sink for release creation diagnostics.
+/// Diagnostic data captured during release sync, including inspected commits, discovered issue references, and pull request metadata. Stored on the release for debugging release association issues.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleaseDebugSinkInput {
     /// List of commit SHAs that were inspected.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub inspected_shas: Option<Vec<String>>,
+    pub inspected_shas: Vec<String>,
     /// Map of issue identifiers to their source information.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issues: Option<serde_json::Value>,
+    pub issues: serde_json::Value,
+    /// Map of reverted issue identifiers to their source information.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reverted_issues: MaybeUndefined<serde_json::Value>,
     /// Pull request debug information.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub pull_requests: Option<Vec<serde_json::Value>>,
+    pub pull_requests: Vec<serde_json::Value>,
     /// List of paths applied during commit scanning.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub include_paths: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub include_paths: MaybeUndefined<Vec<String>>,
 }
 /// `ALPHA` Release filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleaseFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
+    /// Comparator for the release name.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
+    /// Comparator for the release version.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub version: MaybeUndefined<StringComparator>,
     /// Filters that the release's pipeline must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub pipeline: Option<Box<ReleasePipelineFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub pipeline: MaybeUndefined<Box<ReleasePipelineFilter>>,
     /// Filters that the release's stage must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub stage: Option<Box<ReleaseStageFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub stage: MaybeUndefined<ReleaseStageFilter>,
+    /// Comparator for the release completion date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub completed_at: MaybeUndefined<NullableDateComparator>,
     /// Compound filters, all of which need to be matched by the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ReleaseFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ReleaseFilter>>,
     /// Compound filters, one of which need to be matched by the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ReleaseFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ReleaseFilter>>,
 }
+/// `ALPHA` Input for creating a release note.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ReleaseNoteCreateInput {
+    /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
+    /// Identifier of the release pipeline.
+    pub pipeline_id: String,
+    /// The releases included in this note.
+    pub release_ids: Vec<String>,
+}
+/// `ALPHA` Input for updating a release note.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ReleaseNoteUpdateInput {
+    /// The releases included in this note.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub release_ids: MaybeUndefined<Vec<String>>,
+}
+/// `ALPHA` Release pipeline collection filtering options.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ReleasePipelineCollectionFilter {
+    /// Comparator for the identifier.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
+    /// Comparator for the created at date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
+    /// Comparator for the updated at date.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
+    /// Comparator for the pipeline name.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
+    /// Comparator for the pipeline production flag.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_production: MaybeUndefined<BooleanComparator>,
+    /// Filters that the release pipeline's teams must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub teams: MaybeUndefined<Box<TeamCollectionFilter>>,
+    /// Compound filters, all of which need to be matched by the release pipeline.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ReleasePipelineCollectionFilter>>,
+    /// Compound filters, one of which need to be matched by the release pipeline.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ReleasePipelineCollectionFilter>>,
+    /// Filters that needs to be matched by some release pipelines.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<Box<ReleasePipelineFilter>>,
+    /// Filters that needs to be matched by all release pipelines.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<Box<ReleasePipelineFilter>>,
+    /// Comparator for the collection length.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
+}
+/// Input for creating a new release pipeline.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleasePipelineCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The name of the pipeline.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The pipeline's unique slug identifier. If not provided, it will be auto-generated.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slug_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slug_id: MaybeUndefined<String>,
     /// The type of the pipeline.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<ReleasePipelineType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<ReleasePipelineType>,
+    /// Whether this pipeline targets a production environment. Default to true.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_production: MaybeUndefined<bool>,
     /// Glob patterns to include commits affecting matching file paths.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub include_path_patterns: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub include_path_patterns: MaybeUndefined<Vec<String>>,
+    /// The identifiers of the teams this pipeline is associated with.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_ids: MaybeUndefined<Vec<String>>,
 }
 /// `ALPHA` Release pipeline filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleasePipelineFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
+    /// Comparator for the pipeline name.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
+    /// Comparator for the pipeline production flag.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_production: MaybeUndefined<BooleanComparator>,
+    /// Filters that the release pipeline's teams must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub teams: MaybeUndefined<Box<TeamCollectionFilter>>,
     /// Compound filters, all of which need to be matched by the pipeline.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ReleasePipelineFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ReleasePipelineFilter>>,
     /// Compound filters, one of which need to be matched by the pipeline.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ReleasePipelineFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ReleasePipelineFilter>>,
+}
+/// Release pipeline name sorting options.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ReleasePipelineNameSort {
+    /// Whether nulls should be sorted first or last
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
+    /// The order for the individual sort
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
+}
+/// Release pipeline sorting options.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ReleasePipelineSortInput {
+    /// Sort by release pipeline name.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<ReleasePipelineNameSort>,
 }
+/// Input for updating an existing release pipeline.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleasePipelineUpdateInput {
     /// The name of the pipeline.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The pipeline's unique slug identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slug_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slug_id: MaybeUndefined<String>,
     /// The type of the pipeline.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<ReleasePipelineType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<ReleasePipelineType>,
+    /// Whether this pipeline targets a production environment. Default to true.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_production: MaybeUndefined<bool>,
     /// Glob patterns to include commits affecting matching file paths.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub include_path_patterns: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub include_path_patterns: MaybeUndefined<Vec<String>>,
+    /// The identifiers of the teams this pipeline is associated with.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_ids: MaybeUndefined<Vec<String>>,
+}
+/// `Internal` Issue release sorting options.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ReleaseSort {
+    /// Whether nulls should be sorted first or last
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
+    /// The order for the individual sort
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
+/// Release sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
+pub struct ReleaseSortInput {
+    /// Sort by release stage
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub stage: MaybeUndefined<ReleaseStageSort>,
+}
+/// Input for creating a new release stage.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
 pub struct ReleaseStageCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The name of the stage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The UI color of the stage as a HEX string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    pub color: String,
     /// The type of the stage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<ReleaseStageType>,
+    pub r#type: ReleaseStageType,
     /// The position of the stage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub position: Option<f64>,
+    pub position: f64,
     /// The identifier of the pipeline this stage belongs to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub pipeline_id: Option<String>,
+    pub pipeline_id: String,
     /// Whether this stage is frozen. Only applicable to started stages.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub frozen: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub frozen: MaybeUndefined<bool>,
 }
 /// `ALPHA` Release stage filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleaseStageFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the stage type.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<Box<ReleaseStageTypeComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<ReleaseStageTypeComparator>,
     /// Comparator for the stage name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Compound filters, all of which need to be matched by the stage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<ReleaseStageFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<ReleaseStageFilter>>,
     /// Compound filters, one of which need to be matched by the stage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<ReleaseStageFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<ReleaseStageFilter>>,
+}
+/// Release stage sorting options.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ReleaseStageSort {
+    /// Whether nulls should be sorted first or last
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
+    /// The order for the individual sort
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// `ALPHA` Comparator for release stage type.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleaseStageTypeComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<ReleaseStageType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<ReleaseStageType>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<ReleaseStageType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<ReleaseStageType>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<ReleaseStageType>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<ReleaseStageType>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<ReleaseStageType>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<ReleaseStageType>>,
     /// Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
 }
+/// Input for updating an existing release stage.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleaseStageUpdateInput {
     /// The name of the stage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The UI color of the stage as a HEX string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// The position of the stage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub position: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub position: MaybeUndefined<f64>,
     /// Whether this stage is frozen. Only applicable to started stages.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub frozen: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub frozen: MaybeUndefined<bool>,
 }
-/// The release data to sync.
+/// Input for syncing release data to a specific pipeline. Extends the base sync input with the target pipeline identifier.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleaseSyncInput {
     /// The name of the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The version of the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub version: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub version: MaybeUndefined<String>,
     /// The commit SHA associated with this release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub commit_sha: Option<String>,
+    pub commit_sha: String,
     /// Issue references (e.g. ENG-123) to associate with this release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_references: Option<Vec<Box<IssueReferenceInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_references: MaybeUndefined<Vec<IssueReferenceInput>>,
+    /// Issue references that were reverted and should be removed from the release.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reverted_issue_references: MaybeUndefined<Vec<IssueReferenceInput>>,
     /// Pull request references to look up. Issues linked to found PRs will be associated with this release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub pull_request_references: Option<Vec<Box<PullRequestReferenceInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub pull_request_references: MaybeUndefined<Vec<PullRequestReferenceInput>>,
     /// Information about the source repository.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub repository: Option<Box<RepositoryDataInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub repository: MaybeUndefined<RepositoryDataInput>,
     /// Debug information for release creation diagnostics.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub debug_sink: Option<Box<ReleaseDebugSinkInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub debug_sink: MaybeUndefined<ReleaseDebugSinkInput>,
     /// The identifier of the pipeline this release belongs to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub pipeline_id: Option<String>,
+    pub pipeline_id: String,
 }
-/// Base release sync data without pipeline specification.
+/// Base input for syncing release data, containing the commit SHA, issue references, pull request references, and optional metadata. Does not include the pipeline ID, which is provided separately or inferred from the access key.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleaseSyncInputBase {
     /// The name of the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The version of the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub version: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub version: MaybeUndefined<String>,
     /// The commit SHA associated with this release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub commit_sha: Option<String>,
+    pub commit_sha: String,
     /// Issue references (e.g. ENG-123) to associate with this release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_references: Option<Vec<Box<IssueReferenceInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_references: MaybeUndefined<Vec<IssueReferenceInput>>,
+    /// Issue references that were reverted and should be removed from the release.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reverted_issue_references: MaybeUndefined<Vec<IssueReferenceInput>>,
     /// Pull request references to look up. Issues linked to found PRs will be associated with this release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub pull_request_references: Option<Vec<Box<PullRequestReferenceInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub pull_request_references: MaybeUndefined<Vec<PullRequestReferenceInput>>,
     /// Information about the source repository.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub repository: Option<Box<RepositoryDataInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub repository: MaybeUndefined<RepositoryDataInput>,
     /// Debug information for release creation diagnostics.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub debug_sink: Option<Box<ReleaseDebugSinkInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub debug_sink: MaybeUndefined<ReleaseDebugSinkInput>,
 }
-/// Input for updating a release by pipeline.
+/// Input for updating a release by pipeline identifier. Extends the base update input with the target pipeline identifier.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleaseUpdateByPipelineInput {
     /// The version of the release to update. If not provided, the latest started or latest planned release will be updated.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub version: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub version: MaybeUndefined<String>,
     /// The stage name to set. First tries exact match, then falls back to case-insensitive matching with dashes/underscores treated as spaces.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub stage: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub stage: MaybeUndefined<String>,
     /// The identifier of the pipeline.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub pipeline_id: Option<String>,
+    pub pipeline_id: String,
 }
+/// Base input for updating a release by pipeline. Contains optional version and stage name. The pipeline ID is provided separately or inferred from the access key.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleaseUpdateByPipelineInputBase {
     /// The version of the release to update. If not provided, the latest started or latest planned release will be updated.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub version: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub version: MaybeUndefined<String>,
     /// The stage name to set. First tries exact match, then falls back to case-insensitive matching with dashes/underscores treated as spaces.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub stage: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub stage: MaybeUndefined<String>,
 }
+/// Input for updating an existing release.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ReleaseUpdateInput {
     /// The name of the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The description of the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The version of the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub version: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub version: MaybeUndefined<String>,
     /// The commit SHA associated with this release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub commit_sha: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub commit_sha: MaybeUndefined<String>,
     /// The identifier of the pipeline this release belongs to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub pipeline_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub pipeline_id: MaybeUndefined<String>,
     /// The current stage of the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub stage_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub stage_id: MaybeUndefined<String>,
     /// The estimated start date of the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub start_date: Option<chrono::NaiveDate>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub start_date: MaybeUndefined<chrono::NaiveDate>,
     /// The estimated completion date of the release.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub target_date: Option<chrono::NaiveDate>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub target_date: MaybeUndefined<chrono::NaiveDate>,
+    /// Whether the release has been trashed.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub trashed: MaybeUndefined<bool>,
 }
-/// Information about the source repository.
+/// Metadata about the source code repository from which a release is being synced, including the hosting provider and repository coordinates.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct RepositoryDataInput {
     /// The owner of the repository (e.g., organization or user name).
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner: Option<String>,
+    pub owner: String,
     /// The name of the repository.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The VCS provider hosting the repository (e.g., 'github', 'gitlab').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub provider: Option<String>,
+    pub provider: String,
     /// The base URL of the repository on the hosting provider (e.g., '<https://github.com/linear/linear-app>').
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub url: Option<String>,
+    pub url: String,
 }
 /// Customer revenue sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct RevenueSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Roadmap collection filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct RoadmapCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the roadmap name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the roadmap slug ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slug_id: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slug_id: MaybeUndefined<StringComparator>,
     /// Filters that the roadmap creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<UserFilter>>,
     /// Compound filters, all of which need to be matched by the roadmap.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<RoadmapCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<RoadmapCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the roadmap.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<RoadmapCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<RoadmapCollectionFilter>>,
     /// Filters that needs to be matched by some roadmaps.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<RoadmapFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<Box<RoadmapFilter>>,
     /// Filters that needs to be matched by all roadmaps.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<RoadmapFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<Box<RoadmapFilter>>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
 }
+/// Input for creating a new roadmap.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct RoadmapCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The name of the roadmap.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The description of the roadmap.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The owner of the roadmap.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner_id: Option<String>,
-    /// The sort order of the roadmap within the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner_id: MaybeUndefined<String>,
+    /// The sort order of the roadmap within the workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
     /// The roadmap's color.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
 }
 /// Roadmap filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct RoadmapFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the roadmap name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the roadmap slug ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slug_id: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slug_id: MaybeUndefined<StringComparator>,
     /// Filters that the roadmap creator must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub creator: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub creator: MaybeUndefined<Box<UserFilter>>,
     /// Compound filters, all of which need to be matched by the roadmap.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<RoadmapFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<RoadmapFilter>>,
     /// Compound filters, one of which need to be matched by the roadmap.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<RoadmapFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<RoadmapFilter>>,
 }
+/// Input for creating a new roadmap-to-project mapping.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct RoadmapToProjectCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The identifier of the project.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    pub project_id: String,
     /// The identifier of the roadmap.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub roadmap_id: Option<String>,
-    /// The sort order for the project within its organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    pub roadmap_id: String,
+    /// The sort order for the project within its workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
 }
+/// Input for updating an existing roadmap-to-project mapping.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct RoadmapToProjectUpdateInput {
-    /// The sort order for the project within its organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    /// The sort order for the project within its workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
 }
+/// Input for updating an existing roadmap.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct RoadmapUpdateInput {
     /// The name of the roadmap.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The description of the roadmap.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The owner of the roadmap.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner_id: Option<String>,
-    /// The sort order of the roadmap within the organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner_id: MaybeUndefined<String>,
+    /// The sort order of the roadmap within the workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
     /// The roadmap's color.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
 }
 /// Issue root-issue sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct RootIssueSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
     /// The sort to apply to the root issues
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort: Option<Box<IssueSortInput>>,
+    pub sort: Box<IssueSortInput>,
 }
 /// `INTERNAL` Comparator for Salesforce metadata.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct SalesforceMetadataIntegrationComparator {
     /// Salesforce Case metadata filter
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub case_metadata: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub case_metadata: MaybeUndefined<serde_json::Value>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct SalesforceSettingsInput {
     /// Whether an internal message should be added when a Linear issue changes status (for status types except completed or canceled).
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub send_note_on_status_change: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub send_note_on_status_change: MaybeUndefined<bool>,
     /// Whether an internal message should be added when someone comments on an issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub send_note_on_comment: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub send_note_on_comment: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when its linked Linear issue is completed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_completion: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_completion: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when its linked Linear issue is cancelled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_cancellation: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_cancellation: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when a comment is posted on its linked Linear issue
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_comment: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_comment: MaybeUndefined<bool>,
     /// `ALPHA` Whether customer and customer requests should not be automatically created when conversations are linked to a Linear issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub disable_customer_requests_auto_creation: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub disable_customer_requests_auto_creation: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when its linked Linear project is completed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_project_completion: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_project_completion: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when its linked Linear project is cancelled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_project_cancellation: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_project_cancellation: MaybeUndefined<bool>,
     /// Whether Linear Agent should be enabled for this integration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enable_ai_intake: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enable_ai_intake: MaybeUndefined<bool>,
     /// The Salesforce subdomain.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subdomain: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subdomain: MaybeUndefined<String>,
     /// The Salesforce instance URL.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub url: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub url: MaybeUndefined<String>,
     /// The Salesforce case status to use to reopen cases.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub reopen_case_status: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub reopen_case_status: MaybeUndefined<String>,
     /// Whether to restrict visibility of the integration to issues that have been either created from Salesforce or linked to Salesforce.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub restrict_visibility: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub restrict_visibility: MaybeUndefined<bool>,
     /// The Salesforce team to use when a template doesn't specify a team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub default_team: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub default_team: MaybeUndefined<String>,
 }
 /// Filters for semantic search results.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct SemanticSearchFilters {
     /// Filters applied to issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issues: Option<Box<IssueFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issues: MaybeUndefined<IssueFilter>,
     /// Filters applied to projects.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub projects: Option<Box<ProjectFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub projects: MaybeUndefined<ProjectFilter>,
     /// Filters applied to initiatives.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiatives: Option<Box<InitiativeFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiatives: MaybeUndefined<InitiativeFilter>,
     /// Filters applied to documents.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub documents: Option<Box<DocumentFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub documents: MaybeUndefined<DocumentFilter>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct SentrySettingsInput {
     /// The slug of the Sentry organization being connected.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub organization_slug: Option<String>,
+    pub organization_slug: String,
     /// The ID of the Sentry organization being connected.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub organization_id: Option<String>,
+    pub organization_id: String,
     /// Whether Sentry issues resolving completes Linear issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub resolving_completes_issues: Option<bool>,
+    pub resolving_completes_issues: bool,
     /// Whether Sentry issues unresolving reopens Linear issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub unresolving_reopens_issues: Option<bool>,
+    pub unresolving_reopens_issues: bool,
 }
 /// Customer size sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct SizeSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Comparator for sla status.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct SlaStatusComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<SlaStatus>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<SlaStatus>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<SlaStatus>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<SlaStatus>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<SlaStatus>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<SlaStatus>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<SlaStatus>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<SlaStatus>>,
     /// Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
 }
 /// Issue SLA status sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct SlaStatusSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
-#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct SlackAsksSettingsInput {
     /// Slack workspace name
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_name: MaybeUndefined<String>,
     /// Slack workspace id
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
     /// Enterprise name of the connected Slack enterprise
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enterprise_name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enterprise_name: MaybeUndefined<String>,
     /// Enterprise id of the connected Slack enterprise
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enterprise_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enterprise_id: MaybeUndefined<String>,
     /// Whether to show unfurl previews in Slack
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub should_unfurl: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub should_unfurl: MaybeUndefined<bool>,
     /// Whether to show unfurls in the default style instead of Work Objects in Slack
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub should_use_default_unfurl: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub should_use_default_unfurl: MaybeUndefined<bool>,
     /// Whether to allow external users to perform actions on unfurls
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_user_actions: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_user_actions: MaybeUndefined<bool>,
     /// The mapping of Slack channel ID => Slack channel name for connected channels.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_channel_mapping: Option<Vec<Box<SlackChannelNameMappingInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_channel_mapping: MaybeUndefined<Vec<SlackChannelNameMappingInput>>,
     /// The user role type that is allowed to manage Asks settings.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub can_administrate: Option<UserRoleType>,
+    pub can_administrate: UserRoleType,
     /// Controls who can see and set Customers when creating Asks in Slack.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub customer_visibility: Option<CustomerVisibilityMode>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub customer_visibility: MaybeUndefined<CustomerVisibilityMode>,
     /// Whether Linear Agent should be enabled for this Slack Asks integration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enable_agent: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enable_agent: MaybeUndefined<bool>,
     /// Whether Linear Agent should be given Org-wide access within Slack workflows.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enable_linear_agent_workflow_access: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enable_linear_agent_workflow_access: MaybeUndefined<bool>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct SlackAsksTeamSettingsInput {
     /// The Linear team ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    pub id: String,
     /// Whether the default Asks template is enabled in the given channel for this team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub has_default_ask: Option<bool>,
+    pub has_default_ask: bool,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct SlackChannelNameMappingInput {
     /// The Slack channel ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    pub id: String,
     /// The Slack channel name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// Whether or not the Slack channel is private.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_private: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_private: MaybeUndefined<bool>,
     /// Whether or not the Slack channel is shared with an external org.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_shared: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_shared: MaybeUndefined<bool>,
     /// Whether or not the Linear Asks bot has been added to this Slack channel.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub bot_added: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub bot_added: MaybeUndefined<bool>,
     /// Which teams are connected to the channel and settings for those teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub teams: Option<Vec<Box<SlackAsksTeamSettingsInput>>>,
+    pub teams: Vec<SlackAsksTeamSettingsInput>,
     /// Whether or not top-level messages in this channel should automatically create Asks.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_create_on_message: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_create_on_message: MaybeUndefined<bool>,
     /// Whether or not using the :ticket: emoji in this channel should automatically create Asks.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_create_on_emoji: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_create_on_emoji: MaybeUndefined<bool>,
     /// Whether or not @-mentioning the bot should automatically create an Ask with the message.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_create_on_bot_mention: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_create_on_bot_mention: MaybeUndefined<bool>,
     /// The optional template ID to use for Asks auto-created in this channel. If not set, auto-created Asks won't use any template.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_create_template_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_create_template_id: MaybeUndefined<String>,
     /// Whether or not synced Slack threads should be updated with a message and emoji when their Ask is canceled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub post_cancellation_updates: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub post_cancellation_updates: MaybeUndefined<bool>,
     /// Whether or not synced Slack threads should be updated with a message and emoji when their Ask is completed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub post_completion_updates: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub post_completion_updates: MaybeUndefined<bool>,
     /// Whether or not synced Slack threads should be updated with a message when their Ask is accepted from triage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub post_accepted_from_triage_updates: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub post_accepted_from_triage_updates: MaybeUndefined<bool>,
     /// Whether or not to use AI to generate titles for Asks created in this channel.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ai_titles: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ai_titles: MaybeUndefined<bool>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct SlackPostSettingsInput {
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub channel: Option<String>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub channel_id: Option<String>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub configuration_url: Option<String>,
-    /// Slack workspace id
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub channel_type: Option<SlackChannelType>,
+    /// The name of the Slack channel.
+    pub channel: String,
+    /// The Slack channel ID.
+    pub channel_id: String,
+    /// The URL to the Slack integration configuration page.
+    pub configuration_url: String,
+    /// The Slack workspace ID.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
+    /// The type of the Slack channel (e.g., public, private, or DM).
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub channel_type: MaybeUndefined<SlackChannelType>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct SlackSettingsInput {
     /// Slack workspace name
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_name: MaybeUndefined<String>,
     /// Slack workspace id
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
     /// Enterprise name of the connected Slack enterprise
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enterprise_name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enterprise_name: MaybeUndefined<String>,
     /// Enterprise id of the connected Slack enterprise
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enterprise_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enterprise_id: MaybeUndefined<String>,
     /// Whether to show unfurl previews in Slack
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub should_unfurl: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub should_unfurl: MaybeUndefined<bool>,
     /// Whether to show unfurls in the default style instead of Work Objects in Slack
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub should_use_default_unfurl: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub should_use_default_unfurl: MaybeUndefined<bool>,
     /// Whether to allow external users to perform actions on unfurls
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_user_actions: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_user_actions: MaybeUndefined<bool>,
     /// Whether Linear should automatically respond with issue unfurls when an issue identifier is mentioned in a Slack message.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub link_on_issue_id_mention: Option<bool>,
+    pub link_on_issue_id_mention: bool,
     /// Whether Linear Agent should be enabled for this Slack integration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enable_agent: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enable_agent: MaybeUndefined<bool>,
     /// Whether Linear Agent should be given Org-wide access within Slack workflows.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enable_linear_agent_workflow_access: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enable_linear_agent_workflow_access: MaybeUndefined<bool>,
+    /// Whether Code Intelligence should be enabled for this Slack integration.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enable_code_intelligence: MaybeUndefined<bool>,
 }
 /// Comparator for issue source type.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct SourceMetadataComparator {
-    /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<String>,
-    /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<String>,
-    /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<String>>,
-    /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<String>>,
     /// Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
     /// Comparator for the sub type.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sub_type: Option<Box<SubTypeComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sub_type: MaybeUndefined<SubTypeComparator>,
     /// `INTERNAL` Comparator for the salesforce metadata.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub salesforce_metadata: Option<Box<SalesforceMetadataIntegrationComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub salesforce_metadata: MaybeUndefined<SalesforceMetadataIntegrationComparator>,
 }
 /// Comparator for `sourceType` field.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct SourceTypeComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<String>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<String>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<String>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<String>>,
     /// Equals case insensitive. Matches any values that matches the given string case insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq_ignore_case: MaybeUndefined<String>,
     /// Not-equals case insensitive. Matches any values that don't match the given string case insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq_ignore_case: MaybeUndefined<String>,
     /// Starts with constraint. Matches any values that start with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub starts_with: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub starts_with: MaybeUndefined<String>,
     /// Starts with case insensitive constraint. Matches any values that start with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub starts_with_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub starts_with_ignore_case: MaybeUndefined<String>,
     /// Doesn't start with constraint. Matches any values that don't start with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_starts_with: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_starts_with: MaybeUndefined<String>,
     /// Ends with constraint. Matches any values that end with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ends_with: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ends_with: MaybeUndefined<String>,
     /// Doesn't end with constraint. Matches any values that don't end with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_ends_with: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_ends_with: MaybeUndefined<String>,
     /// Contains constraint. Matches any values that contain the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub contains: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub contains: MaybeUndefined<String>,
     /// Contains case insensitive constraint. Matches any values that contain the given string case insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub contains_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub contains_ignore_case: MaybeUndefined<String>,
     /// Doesn't contain constraint. Matches any values that don't contain the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_contains: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_contains: MaybeUndefined<String>,
     /// Doesn't contain case insensitive constraint. Matches any values that don't contain the given string case insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_contains_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_contains_ignore_case: MaybeUndefined<String>,
     /// Contains case and accent insensitive constraint. Matches any values that contain the given string case and accent insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub contains_ignore_case_and_accent: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub contains_ignore_case_and_accent: MaybeUndefined<String>,
 }
 /// Project start date sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct StartDateSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Comparator for strings.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct StringArrayComparator {
     /// Length of the array. Matches any values that have the given length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
     /// Compound filters, all of which need to be matched.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<StringItemComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<StringItemComparator>,
     /// Compound filters, one of which needs to be matched.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<StringItemComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<StringItemComparator>,
 }
 /// Comparator for strings.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct StringComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<String>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<String>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<String>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<String>>,
     /// Equals case insensitive. Matches any values that matches the given string case insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq_ignore_case: MaybeUndefined<String>,
     /// Not-equals case insensitive. Matches any values that don't match the given string case insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq_ignore_case: MaybeUndefined<String>,
     /// Starts with constraint. Matches any values that start with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub starts_with: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub starts_with: MaybeUndefined<String>,
     /// Starts with case insensitive constraint. Matches any values that start with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub starts_with_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub starts_with_ignore_case: MaybeUndefined<String>,
     /// Doesn't start with constraint. Matches any values that don't start with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_starts_with: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_starts_with: MaybeUndefined<String>,
     /// Ends with constraint. Matches any values that end with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ends_with: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ends_with: MaybeUndefined<String>,
     /// Doesn't end with constraint. Matches any values that don't end with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_ends_with: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_ends_with: MaybeUndefined<String>,
     /// Contains constraint. Matches any values that contain the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub contains: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub contains: MaybeUndefined<String>,
     /// Contains case insensitive constraint. Matches any values that contain the given string case insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub contains_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub contains_ignore_case: MaybeUndefined<String>,
     /// Doesn't contain constraint. Matches any values that don't contain the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_contains: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_contains: MaybeUndefined<String>,
     /// Doesn't contain case insensitive constraint. Matches any values that don't contain the given string case insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_contains_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_contains_ignore_case: MaybeUndefined<String>,
     /// Contains case and accent insensitive constraint. Matches any values that contain the given string case and accent insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub contains_ignore_case_and_accent: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub contains_ignore_case_and_accent: MaybeUndefined<String>,
 }
 /// Comparator for strings in arrays.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct StringItemComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<String>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<String>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<String>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<String>>,
     /// Equals case insensitive. Matches any values that matches the given string case insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq_ignore_case: MaybeUndefined<String>,
     /// Not-equals case insensitive. Matches any values that don't match the given string case insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq_ignore_case: MaybeUndefined<String>,
     /// Starts with constraint. Matches any values that start with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub starts_with: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub starts_with: MaybeUndefined<String>,
     /// Starts with case insensitive constraint. Matches any values that start with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub starts_with_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub starts_with_ignore_case: MaybeUndefined<String>,
     /// Doesn't start with constraint. Matches any values that don't start with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_starts_with: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_starts_with: MaybeUndefined<String>,
     /// Ends with constraint. Matches any values that end with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ends_with: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ends_with: MaybeUndefined<String>,
     /// Doesn't end with constraint. Matches any values that don't end with the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_ends_with: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_ends_with: MaybeUndefined<String>,
     /// Contains constraint. Matches any values that contain the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub contains: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub contains: MaybeUndefined<String>,
     /// Contains case insensitive constraint. Matches any values that contain the given string case insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub contains_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub contains_ignore_case: MaybeUndefined<String>,
     /// Doesn't contain constraint. Matches any values that don't contain the given string.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_contains: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_contains: MaybeUndefined<String>,
     /// Doesn't contain case insensitive constraint. Matches any values that don't contain the given string case insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub not_contains_ignore_case: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub not_contains_ignore_case: MaybeUndefined<String>,
     /// Contains case and accent insensitive constraint. Matches any values that contain the given string case and accent insensitive.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub contains_ignore_case_and_accent: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub contains_ignore_case_and_accent: MaybeUndefined<String>,
 }
 /// Comparator for source type.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct SubTypeComparator {
     /// Equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub eq: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub eq: MaybeUndefined<String>,
     /// Not-equals constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub neq: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub neq: MaybeUndefined<String>,
     /// In-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#in: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#in: MaybeUndefined<Vec<String>>,
     /// Not-in-array constraint.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nin: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nin: MaybeUndefined<Vec<String>>,
     /// Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub null: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub null: MaybeUndefined<bool>,
 }
 /// Project target date sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TargetDateSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Team collection filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TeamCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Compound filters, all of which need to be matched by the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<TeamCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<TeamCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<TeamCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<TeamCollectionFilter>>,
     /// Filters that needs to be matched by some teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<TeamFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<Box<TeamFilter>>,
     /// Filters that needs to be matched by all teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<TeamFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<Box<TeamFilter>>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
     /// Filters that the teams parent must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent: Option<Box<NullableTeamFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent: MaybeUndefined<Box<NullableTeamFilter>>,
+    /// Filters that the team's ancestors must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ancestors: MaybeUndefined<Box<TeamCollectionFilter>>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TeamCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The name of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The description of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The key of the team. If not given, the key will be generated based on the name of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub key: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub key: MaybeUndefined<String>,
     /// The icon of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub icon: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub icon: MaybeUndefined<String>,
     /// The color of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// Whether the team uses cycles.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycles_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycles_enabled: MaybeUndefined<bool>,
     /// The day of the week that a new cycle starts.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_start_day: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_start_day: MaybeUndefined<f64>,
     /// The duration of each cycle in weeks.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_duration: Option<i64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_duration: MaybeUndefined<i64>,
     /// The cooldown time after each cycle in weeks.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_cooldown_time: Option<i64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_cooldown_time: MaybeUndefined<i64>,
     /// Auto assign started issues to current active cycle setting.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_issue_auto_assign_started: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_issue_auto_assign_started: MaybeUndefined<bool>,
     /// Auto assign completed issues to current active cycle setting.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_issue_auto_assign_completed: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_issue_auto_assign_completed: MaybeUndefined<bool>,
     /// Only allow issues issues with cycles in Active Issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_lock_to_active: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_lock_to_active: MaybeUndefined<bool>,
     /// How many upcoming cycles to create.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub upcoming_cycle_count: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub upcoming_cycle_count: MaybeUndefined<f64>,
     /// Whether triage mode is enabled for the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub triage_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub triage_enabled: MaybeUndefined<bool>,
     /// Whether an issue needs to have a priority set before leaving triage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub require_priority_to_leave_triage: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub require_priority_to_leave_triage: MaybeUndefined<bool>,
     /// The timezone of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub timezone: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub timezone: MaybeUndefined<String>,
     /// Whether the team should inherit estimation settings from its parent. Only applies to sub-teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub inherit_issue_estimation: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub inherit_issue_estimation: MaybeUndefined<bool>,
     /// `Internal` Whether the team should inherit workflow statuses from its parent.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub inherit_workflow_statuses: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub inherit_workflow_statuses: MaybeUndefined<bool>,
     /// The issue estimation type to use. Must be one of "notUsed", "exponential", "fibonacci", "linear", "tShirt".
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_estimation_type: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_estimation_type: MaybeUndefined<String>,
     /// Whether to allow zeros in issues estimates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_estimation_allow_zero: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_estimation_allow_zero: MaybeUndefined<bool>,
     /// Whether to move issues to bottom of the column when changing state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub set_issue_sort_order_on_state_change: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub set_issue_sort_order_on_state_change: MaybeUndefined<String>,
     /// Whether to add additional points to the estimate scale.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_estimation_extended: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_estimation_extended: MaybeUndefined<bool>,
     /// What to use as an default estimate for unestimated issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub default_issue_estimate: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub default_issue_estimate: MaybeUndefined<f64>,
     /// Whether to group recent issue history entries.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub group_issue_history: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub group_issue_history: MaybeUndefined<bool>,
     /// The identifier of the default template for members of this team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub default_template_for_members_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub default_template_for_members_id: MaybeUndefined<String>,
     /// The identifier of the default template for non-members of this team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub default_template_for_non_members_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub default_template_for_non_members_id: MaybeUndefined<String>,
     /// The identifier of the default project template of this team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub default_project_template_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub default_project_template_id: MaybeUndefined<String>,
     /// Internal. Whether the team is private or not.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub private: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub private: MaybeUndefined<bool>,
     /// Period after which issues are automatically closed, in months.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_close_period: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_close_period: MaybeUndefined<f64>,
     /// The canceled workflow state which auto closed issues will be set to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_close_state_id: Option<String>,
-    /// Period after which closed and completed issues are automatically archived, in months. 0 means disabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_archive_period: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_close_state_id: MaybeUndefined<String>,
+    /// Period after which closed (completed, canceled, or duplicate) issues are automatically archived, in months. 0 means disabled.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_archive_period: MaybeUndefined<f64>,
     /// The workflow state into which issues are moved when they are marked as a duplicate of another issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub marked_as_duplicate_workflow_state_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub marked_as_duplicate_workflow_state_id: MaybeUndefined<String>,
     /// The parent team ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent_id: MaybeUndefined<String>,
     /// `Internal` Whether the team should inherit its product intelligence scope from its parent. Only applies to sub-teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub inherit_product_intelligence_scope: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub inherit_product_intelligence_scope: MaybeUndefined<bool>,
     /// `Internal` The scope of product intelligence suggestion data for the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub product_intelligence_scope: Option<ProductIntelligenceScope>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub product_intelligence_scope: MaybeUndefined<ProductIntelligenceScope>,
+    /// Whether issue sharing is enabled for this team.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_sharing_enabled: MaybeUndefined<bool>,
+    /// `Internal` Whether the team should inherit its Slack auto-create project channel setting from its parent. Only applies to sub-teams.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub inherit_slack_auto_create_project_channel: MaybeUndefined<bool>,
+    /// `Internal` Whether to automatically create a Slack channel when a new project is created in this team.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_auto_create_project_channel: MaybeUndefined<bool>,
 }
 /// Team filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TeamFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the team name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the team key.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub key: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub key: MaybeUndefined<StringComparator>,
     /// Comparator for the team description.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<Box<NullableStringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<NullableStringComparator>,
     /// Comparator for the team privacy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub private: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub private: MaybeUndefined<BooleanComparator>,
+    /// Comparator for the time at which the team was retired.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub retired_at: MaybeUndefined<NullableDateComparator>,
     /// Filters that the teams issues must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issues: Option<Box<IssueCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issues: MaybeUndefined<Box<IssueCollectionFilter>>,
     /// Filters that the teams parent must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent: Option<Box<NullableTeamFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent: MaybeUndefined<Box<NullableTeamFilter>>,
+    /// Filters that the team's ancestors must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ancestors: MaybeUndefined<Box<TeamCollectionFilter>>,
+    /// `ALPHA` Filters that the team's release pipelines must satisfy.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub release_pipelines: MaybeUndefined<Box<ReleasePipelineCollectionFilter>>,
     /// Compound filters, all of which need to be matched by the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<TeamFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<TeamFilter>>,
     /// Compound filters, one of which need to be matched by the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<TeamFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<TeamFilter>>,
 }
+/// Input for creating a new team membership.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TeamMembershipCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The identifier of the user associated with the membership.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user_id: Option<String>,
+    pub user_id: String,
     /// The identifier of the team associated with the membership.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    pub team_id: String,
     /// Internal. Whether the user is the owner of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner: MaybeUndefined<bool>,
     /// The position of the item in the users list.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
 }
+/// Input for updating an existing team membership.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TeamMembershipUpdateInput {
     /// Internal. Whether the user is the owner of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner: MaybeUndefined<bool>,
     /// The position of the item in the users list.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TeamSecuritySettingsInput {
+    /// The minimum team role required to share issues with non-team-members.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_sharing: MaybeUndefined<TeamRoleType>,
     /// The minimum team role required to manage labels in the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label_management: Option<TeamRoleType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub label_management: MaybeUndefined<TeamRoleType>,
     /// The minimum team role required to manage full workspace members (non-guests) in the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub member_management: Option<TeamRoleType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub member_management: MaybeUndefined<TeamRoleType>,
     /// The minimum team role required to manage team settings.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_management: Option<TeamRoleType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_management: MaybeUndefined<TeamRoleType>,
     /// The minimum team role required to manage templates in the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub template_management: Option<TeamRoleType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub template_management: MaybeUndefined<TeamRoleType>,
 }
 /// Issue team sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TeamSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TeamUpdateInput {
     /// The name of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The description of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The key of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub key: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub key: MaybeUndefined<String>,
     /// The icon of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub icon: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub icon: MaybeUndefined<String>,
     /// The color of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// Whether the team uses cycles.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycles_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycles_enabled: MaybeUndefined<bool>,
     /// The day of the week that a new cycle starts.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_start_day: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_start_day: MaybeUndefined<f64>,
     /// The duration of each cycle in weeks.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_duration: Option<i64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_duration: MaybeUndefined<i64>,
     /// The cooldown time after each cycle in weeks.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_cooldown_time: Option<i64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_cooldown_time: MaybeUndefined<i64>,
     /// Auto assign started issues to current active cycle setting.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_issue_auto_assign_started: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_issue_auto_assign_started: MaybeUndefined<bool>,
     /// Auto assign completed issues to current active cycle setting.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_issue_auto_assign_completed: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_issue_auto_assign_completed: MaybeUndefined<bool>,
     /// Only allow issues with cycles in Active Issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_lock_to_active: Option<bool>,
-    /// The date to begin cycles on.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub cycle_enabled_start_date: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_lock_to_active: MaybeUndefined<bool>,
+    /// The time at which to begin cycles.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub cycle_enabled_start_date: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
     /// How many upcoming cycles to create.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub upcoming_cycle_count: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub upcoming_cycle_count: MaybeUndefined<f64>,
     /// The timezone of the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub timezone: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub timezone: MaybeUndefined<String>,
     /// Whether the team should inherit estimation settings from its parent. Only applies to sub-teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub inherit_issue_estimation: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub inherit_issue_estimation: MaybeUndefined<bool>,
     /// The issue estimation type to use. Must be one of "notUsed", "exponential", "fibonacci", "linear", "tShirt".
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_estimation_type: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_estimation_type: MaybeUndefined<String>,
     /// Whether to allow zeros in issues estimates.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_estimation_allow_zero: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_estimation_allow_zero: MaybeUndefined<bool>,
     /// Whether to move issues to bottom of the column when changing state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub set_issue_sort_order_on_state_change: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub set_issue_sort_order_on_state_change: MaybeUndefined<String>,
     /// Whether to add additional points to the estimate scale.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issue_estimation_extended: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_estimation_extended: MaybeUndefined<bool>,
     /// What to use as an default estimate for unestimated issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub default_issue_estimate: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub default_issue_estimate: MaybeUndefined<f64>,
     /// Whether to send new issue notifications to Slack.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_new_issue: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_new_issue: MaybeUndefined<bool>,
     /// Whether to send new issue comment notifications to Slack.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_comments: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_comments: MaybeUndefined<bool>,
     /// Whether to send issue status update notifications to Slack.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub slack_issue_statuses: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_issue_statuses: MaybeUndefined<bool>,
     /// Whether to group recent issue history entries.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub group_issue_history: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub group_issue_history: MaybeUndefined<bool>,
     /// Whether to enable resolved thread AI summaries.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ai_thread_summaries_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ai_thread_summaries_enabled: MaybeUndefined<bool>,
     /// Whether to enable AI discussion summaries for issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ai_discussion_summaries_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub ai_discussion_summaries_enabled: MaybeUndefined<bool>,
     /// The identifier of the default template for members of this team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub default_template_for_members_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub default_template_for_members_id: MaybeUndefined<String>,
     /// The identifier of the default template for non-members of this team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub default_template_for_non_members_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub default_template_for_non_members_id: MaybeUndefined<String>,
     /// The identifier of the default project template of this team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub default_project_template_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub default_project_template_id: MaybeUndefined<String>,
     /// Whether the team is private or not.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub private: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub private: MaybeUndefined<bool>,
     /// Whether triage mode is enabled for the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub triage_enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub triage_enabled: MaybeUndefined<bool>,
     /// Whether an issue needs to have a priority set before leaving triage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub require_priority_to_leave_triage: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub require_priority_to_leave_triage: MaybeUndefined<bool>,
     /// Default status for newly created issues.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub default_issue_state_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub default_issue_state_id: MaybeUndefined<String>,
     /// Period after which issues are automatically closed, in months.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_close_period: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_close_period: MaybeUndefined<f64>,
     /// The canceled workflow state which auto closed issues will be set to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_close_state_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_close_state_id: MaybeUndefined<String>,
     /// Whether to automatically close a parent issue in this team if all its sub-issues are closed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_close_parent_issues: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_close_parent_issues: MaybeUndefined<bool>,
     /// Whether to automatically close all sub-issues when a parent issue in this team is closed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_close_child_issues: Option<bool>,
-    /// Period after which closed and completed issues are automatically archived, in months.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub auto_archive_period: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_close_child_issues: MaybeUndefined<bool>,
+    /// Period after which closed (completed, canceled, or duplicate) issues are automatically archived, in months.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub auto_archive_period: MaybeUndefined<f64>,
     /// The workflow state into which issues are moved when they are marked as a duplicate of another issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub marked_as_duplicate_workflow_state_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub marked_as_duplicate_workflow_state_id: MaybeUndefined<String>,
     /// Whether new users should join this team by default. Mutation restricted to workspace admins or owners!
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub join_by_default: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub join_by_default: MaybeUndefined<bool>,
     /// Whether the team is managed by SCIM integration. Mutation restricted to workspace admins or owners and only unsetting is allowed!
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub scim_managed: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub scim_managed: MaybeUndefined<bool>,
     /// The parent team ID.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub parent_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub parent_id: MaybeUndefined<String>,
     /// `Internal` Whether the team should inherit workflow statuses from its parent.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub inherit_workflow_statuses: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub inherit_workflow_statuses: MaybeUndefined<bool>,
     /// `Internal` Whether the team should inherit its product intelligence scope from its parent. Only applies to sub-teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub inherit_product_intelligence_scope: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub inherit_product_intelligence_scope: MaybeUndefined<bool>,
     /// `Internal` The scope of product intelligence suggestion data for the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub product_intelligence_scope: Option<ProductIntelligenceScope>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub product_intelligence_scope: MaybeUndefined<ProductIntelligenceScope>,
+    /// Whether issue sharing is enabled for this team.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issue_sharing_enabled: MaybeUndefined<bool>,
+    /// `Internal` Whether the team should inherit its Slack auto-create project channel setting from its parent. Only applies to sub-teams.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub inherit_slack_auto_create_project_channel: MaybeUndefined<bool>,
+    /// `Internal` Whether to automatically create a Slack channel when a new project is created in this team.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub slack_auto_create_project_channel: MaybeUndefined<bool>,
     /// The security settings for the team.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub security_settings: Option<Box<TeamSecuritySettingsInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub security_settings: MaybeUndefined<TeamSecuritySettingsInput>,
     /// Whether all members in the workspace can join the team. Only used for public teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub all_members_can_join: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub all_members_can_join: MaybeUndefined<bool>,
     /// When the team was retired.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub retired_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub retired_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
     /// `Internal` How to handle sub-teams when retiring. Required if the team has active sub-teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub handle_sub_teams_on_retirement: Option<TeamRetirementSubTeamHandling>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub handle_sub_teams_on_retirement: MaybeUndefined<TeamRetirementSubTeamHandling>,
 }
+/// Input for creating a new template. A name, type, and template data are required. If no team is specified, the template is shared across the workspace.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TemplateCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
-    /// The template type, e.g. 'issue'.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
+    /// The template type, e.g. 'issue', 'project', or 'document'.
+    pub r#type: String,
     /// The identifier or key of the team associated with the template. If not given, the template will be shared across all teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
     /// The template name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The template description.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
-    /// The template data as JSON encoded attributes of the type of entity, such as an issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub template_data: Option<serde_json::Value>,
-    /// The position of the template in the templates list.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
-}
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
+    /// The icon of the template.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub icon: MaybeUndefined<String>,
+    /// The color of the template icon.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
+    /// The template data as JSON-encoded attributes of the target entity type, such as pre-filled issue fields, project configuration, or document content.
+    pub template_data: serde_json::Value,
+    /// The sort position of the template in the templates list.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
+}
+/// Input for updating an existing template. All fields are optional; only provided fields will be updated.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TemplateUpdateInput {
     /// The template name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The template description.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
+    /// The icon of the template.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub icon: MaybeUndefined<String>,
+    /// The color of the template icon.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// The identifier or key of the team associated with the template. If set to null, the template will be shared across all teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
-    /// The template data as JSON encoded attributes of the type of entity, such as an issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub template_data: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
+    /// The template data as JSON-encoded attributes of the target entity type, such as pre-filled issue fields, project configuration, or document content.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub template_data: MaybeUndefined<serde_json::Value>,
     /// The position of the template in the templates list.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub sort_order: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub sort_order: MaybeUndefined<f64>,
 }
 /// Customer tier sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TierSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// Issue time in status sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TimeInStatusSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
+/// Input for creating a new time schedule.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TimeScheduleCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The name of the schedule.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The schedule entries.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub entries: Option<Vec<Box<TimeScheduleEntryInput>>>,
+    pub entries: Vec<TimeScheduleEntryInput>,
     /// The unique identifier of the external schedule.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_id: MaybeUndefined<String>,
     /// The URL to the external schedule.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_url: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_url: MaybeUndefined<String>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TimeScheduleEntryInput {
-    /// The start date of the schedule in ISO 8601 date-time format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub starts_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The end date of the schedule in ISO 8601 date-time format.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub ends_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The start time of the schedule entry in ISO 8601 date-time format.
+    pub starts_at: chrono::DateTime<chrono::Utc>,
+    /// The end time of the schedule entry in ISO 8601 date-time format.
+    pub ends_at: chrono::DateTime<chrono::Utc>,
     /// The Linear user id of the user on schedule. If the user cannot be mapped to a Linear user then `userEmail` can be used as a reference.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub user_id: MaybeUndefined<String>,
     /// The email, name or reference to the user on schedule. This is used in case the external user could not be mapped to a Linear user id.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user_email: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub user_email: MaybeUndefined<String>,
 }
+/// Input for updating an existing time schedule.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TimeScheduleUpdateInput {
     /// The name of the schedule.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The schedule entries.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub entries: Option<Vec<Box<TimeScheduleEntryInput>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub entries: MaybeUndefined<Vec<TimeScheduleEntryInput>>,
     /// The unique identifier of the external schedule.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_id: MaybeUndefined<String>,
     /// The URL to the external schedule.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub external_url: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub external_url: MaybeUndefined<String>,
 }
 /// Issue title sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TitleSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TokenUserAccountAuthInput {
     /// The email which to login via the magic login code.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub email: Option<String>,
+    pub email: String,
     /// The magic login code.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub token: Option<String>,
+    pub token: String,
     /// The timezone of the user's browser.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub timezone: Option<String>,
-    /// An optional invite link for an organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub invite_link: Option<String>,
+    pub timezone: String,
+    /// An optional invite link for a workspace.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub invite_link: MaybeUndefined<String>,
+    /// Auth code for the client initiating the login sequence.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub client_auth_code: MaybeUndefined<String>,
 }
+/// Input for creating a new triage responsibility.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TriageResponsibilityCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// The identifier of the team associated with the triage responsibility.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    pub team_id: String,
     /// The action to take when an issue is added to triage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub action: Option<String>,
+    pub action: String,
     /// The manual selection of users responsible for triage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub manual_selection: Option<Box<TriageResponsibilityManualSelectionInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub manual_selection: MaybeUndefined<TriageResponsibilityManualSelectionInput>,
     /// The identifier of the time schedule used for scheduling triage responsibility
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub time_schedule_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub time_schedule_id: MaybeUndefined<String>,
 }
 /// Manual triage responsibility using a set of users.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TriageResponsibilityManualSelectionInput {
     /// The set of users responsible for triage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user_ids: Option<Vec<String>>,
+    pub user_ids: Vec<String>,
     /// `Internal` The index of the current userId used for the assign action when having more than one user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub assignment_index: Option<i64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub assignment_index: MaybeUndefined<i64>,
 }
+/// Input for updating an existing triage responsibility.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TriageResponsibilityUpdateInput {
     /// The action to take when an issue is added to triage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub action: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub action: MaybeUndefined<String>,
     /// The manual selection of users responsible for triage.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub manual_selection: Option<Box<TriageResponsibilityManualSelectionInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub manual_selection: MaybeUndefined<TriageResponsibilityManualSelectionInput>,
     /// The identifier of the time schedule used for scheduling triage responsibility.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub time_schedule_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub time_schedule_id: MaybeUndefined<String>,
 }
 /// Issue update date sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct UpdatedAtSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// User filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct UserCollectionFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the user's name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the user's display name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub display_name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub display_name: MaybeUndefined<StringComparator>,
     /// Comparator for the user's email.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub email: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub email: MaybeUndefined<StringComparator>,
     /// Comparator for the user's activity status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub active: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub active: MaybeUndefined<BooleanComparator>,
     /// Filters that the users assigned issues must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub assigned_issues: Option<Box<IssueCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub assigned_issues: MaybeUndefined<Box<IssueCollectionFilter>>,
     /// Comparator for the user's admin status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub admin: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub admin: MaybeUndefined<BooleanComparator>,
     /// Comparator for the user's owner status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner: MaybeUndefined<BooleanComparator>,
     /// Comparator for the user's invited status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub invited: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub invited: MaybeUndefined<BooleanComparator>,
     /// Comparator for the user's invited status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_invited: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_invited: MaybeUndefined<BooleanComparator>,
     /// Comparator for the user's app status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub app: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub app: MaybeUndefined<BooleanComparator>,
     /// Filter based on the currently authenticated user. Set to true to filter for the authenticated user, false for any other user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_me: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_me: MaybeUndefined<BooleanComparator>,
     /// Compound filters, all of which need to be matched by the user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<UserCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<UserCollectionFilter>>,
     /// Compound filters, one of which need to be matched by the user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<UserCollectionFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<UserCollectionFilter>>,
     /// Filters that needs to be matched by some users.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub some: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub some: MaybeUndefined<Box<UserFilter>>,
     /// Filters that needs to be matched by all users.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub every: Option<Box<UserFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub every: MaybeUndefined<Box<UserFilter>>,
     /// Comparator for the collection length.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub length: Option<Box<NumberComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub length: MaybeUndefined<NumberComparator>,
 }
 /// User display name sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct UserDisplayNameSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 /// User filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct UserFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the user's name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the user's display name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub display_name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub display_name: MaybeUndefined<StringComparator>,
     /// Comparator for the user's email.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub email: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub email: MaybeUndefined<StringComparator>,
     /// Comparator for the user's activity status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub active: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub active: MaybeUndefined<BooleanComparator>,
     /// Filters that the users assigned issues must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub assigned_issues: Option<Box<IssueCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub assigned_issues: MaybeUndefined<Box<IssueCollectionFilter>>,
     /// Comparator for the user's admin status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub admin: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub admin: MaybeUndefined<BooleanComparator>,
     /// Comparator for the user's owner status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub owner: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub owner: MaybeUndefined<BooleanComparator>,
     /// Comparator for the user's invited status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub invited: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub invited: MaybeUndefined<BooleanComparator>,
     /// Comparator for the user's invited status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_invited: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_invited: MaybeUndefined<BooleanComparator>,
     /// Comparator for the user's app status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub app: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub app: MaybeUndefined<BooleanComparator>,
     /// Filter based on the currently authenticated user. Set to true to filter for the authenticated user, false for any other user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub is_me: Option<Box<BooleanComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub is_me: MaybeUndefined<BooleanComparator>,
     /// Compound filters, all of which need to be matched by the user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<UserFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<UserFilter>>,
     /// Compound filters, one of which need to be matched by the user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<UserFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<UserFilter>>,
 }
 /// User name sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct UserNameSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct UserSettingsUpdateInput {
     /// The user's settings.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub settings: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub settings: MaybeUndefined<serde_json::Value>,
     /// Whether this user is subscribed to changelog email or not.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subscribed_to_changelog: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subscribed_to_changelog: MaybeUndefined<bool>,
     /// Whether this user is subscribed to DPA emails or not.
     #[serde(
         rename = "subscribedToDPA",
         default,
-        skip_serializing_if = "Option::is_none"
+        skip_serializing_if = "MaybeUndefined::is_undefined"
     )]
-    pub subscribed_to_dpa: Option<bool>,
+    pub subscribed_to_dpa: MaybeUndefined<bool>,
     /// Whether this user is subscribed to invite accepted emails or not.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subscribed_to_invite_accepted: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subscribed_to_invite_accepted: MaybeUndefined<bool>,
     /// Whether this user is subscribed to privacy and legal update emails or not.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subscribed_to_privacy_legal_updates: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subscribed_to_privacy_legal_updates: MaybeUndefined<bool>,
     /// Whether this user is subscribed to general marketing communications or not.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subscribed_to_general_marketing_communications: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub subscribed_to_general_marketing_communications: MaybeUndefined<bool>,
     /// The user's notification category preferences.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub notification_category_preferences: Option<Box<NotificationCategoryPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub notification_category_preferences: MaybeUndefined<NotificationCategoryPreferencesInput>,
     /// The user's notification channel preferences.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub notification_channel_preferences: Option<Box<PartialNotificationChannelPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub notification_channel_preferences:
+        MaybeUndefined<PartialNotificationChannelPreferencesInput>,
     /// The user's notification delivery preferences.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub notification_delivery_preferences: Option<Box<NotificationDeliveryPreferencesInput>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub notification_delivery_preferences: MaybeUndefined<NotificationDeliveryPreferencesInput>,
     /// `Internal` The user's usage warning history.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub usage_warning_history: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub usage_warning_history: MaybeUndefined<serde_json::Value>,
     /// `Internal` How often to generate a feed summary.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub feed_summary_schedule: Option<FeedSummarySchedule>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub feed_summary_schedule: MaybeUndefined<FeedSummarySchedule>,
     /// `Internal` The user's last seen time for the pulse feed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub feed_last_seen_time: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub feed_last_seen_time: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
 }
 /// User sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct UserSortInput {
     /// Sort by user name
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<UserNameSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<UserNameSort>,
     /// Sort by user display name
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub display_name: Option<Box<UserDisplayNameSort>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub display_name: MaybeUndefined<UserDisplayNameSort>,
 }
+/// Input for updating the authenticated user.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct UserUpdateInput {
     /// The name of the user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The display name of the user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub display_name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub display_name: MaybeUndefined<String>,
     /// The avatar image URL of the user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub avatar_url: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub avatar_url: MaybeUndefined<String>,
     /// The user description or a short bio.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
+    /// The user's job title.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub title: MaybeUndefined<String>,
     /// The emoji part of the user status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status_emoji: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status_emoji: MaybeUndefined<String>,
     /// The label part of the user status.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status_label: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status_label: MaybeUndefined<String>,
     /// When the user status should be cleared.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub status_until_at: Option<chrono::DateTime<chrono::Utc>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub status_until_at: MaybeUndefined<chrono::DateTime<chrono::Utc>>,
     /// The local timezone of the user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub timezone: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub timezone: MaybeUndefined<String>,
 }
-#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+/// Input for creating view preferences.
+#[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ViewPreferencesCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
-    /// The type of view preferences (either user or organization level preferences).
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<ViewPreferencesType>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
+    /// The type of view preferences (either user or workspace level preferences).
+    pub r#type: ViewPreferencesType,
     /// The view type of the view preferences are associated with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub view_type: Option<ViewType>,
+    pub view_type: ViewType,
     /// View preferences object.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub preferences: Option<serde_json::Value>,
+    pub preferences: serde_json::Value,
     /// The default parameters for the insight on that view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub insights: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub insights: MaybeUndefined<serde_json::Value>,
     /// The team these view preferences are associated with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
     /// The project these view preferences are associated with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_id: MaybeUndefined<String>,
     /// `Internal` The initiative these view preferences are associated with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub initiative_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub initiative_id: MaybeUndefined<String>,
     /// The label these view preferences are associated with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub label_id: MaybeUndefined<String>,
     /// The project label these view preferences are associated with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub project_label_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub project_label_id: MaybeUndefined<String>,
+    /// The release pipeline these view preferences are associated with.
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub release_pipeline_id: MaybeUndefined<String>,
     /// The custom view these view preferences are associated with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub custom_view_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub custom_view_id: MaybeUndefined<String>,
     /// The user profile these view preferences are associated with.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub user_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub user_id: MaybeUndefined<String>,
 }
+/// Input for updating view preferences.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ViewPreferencesUpdateInput {
     /// View preferences.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub preferences: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub preferences: MaybeUndefined<serde_json::Value>,
     /// The default parameters for the insight on that view.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub insights: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub insights: MaybeUndefined<serde_json::Value>,
 }
+/// Input for creating a new webhook.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct WebhookCreateInput {
     /// Label for the webhook.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub label: MaybeUndefined<String>,
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
     /// Whether this webhook is enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enabled: MaybeUndefined<bool>,
     /// A secret token used to sign the webhook payload.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub secret: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub secret: MaybeUndefined<String>,
     /// The URL that will be called on data changes.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub url: Option<String>,
+    pub url: String,
     /// List of resources the webhook should subscribe to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub resource_types: Option<Vec<String>>,
+    pub resource_types: Vec<String>,
     /// The identifier or key of the team associated with the Webhook.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team_id: MaybeUndefined<String>,
     /// Whether this webhook is enabled for all public teams.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub all_public_teams: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub all_public_teams: MaybeUndefined<bool>,
 }
+/// Input for updating an existing webhook.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct WebhookUpdateInput {
     /// Label for the webhook.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub label: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub label: MaybeUndefined<String>,
     /// A secret token used to sign the webhook payload.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub secret: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub secret: MaybeUndefined<String>,
     /// Whether this webhook is enabled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enabled: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enabled: MaybeUndefined<bool>,
     /// The URL that will be called on data changes.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub url: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub url: MaybeUndefined<String>,
     /// List of resources the webhook should subscribe to.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub resource_types: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub resource_types: MaybeUndefined<Vec<String>>,
 }
+/// Input for creating a new workflow state (issue status) in a team. The name, type, color, and team are required.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct WorkflowStateCreateInput {
     /// The identifier in UUID v4 format. If none is provided, the backend will generate one.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<String>,
-    /// The workflow type.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<String>,
+    /// The workflow state type, which categorizes the state. Valid values: backlog, unstarted, started, completed, canceled. The type determines how the state is treated in workflow progression and reporting.
+    pub r#type: String,
     /// The name of the state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    pub name: String,
     /// The color of the state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    pub color: String,
     /// The description of the state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The position of the state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub position: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub position: MaybeUndefined<f64>,
     /// The team associated with the state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team_id: Option<String>,
+    pub team_id: String,
 }
 /// Workflow state filtering options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct WorkflowStateFilter {
     /// Comparator for the identifier.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub id: Option<Box<IDComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub id: MaybeUndefined<IDComparator>,
     /// Comparator for the created at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub created_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub created_at: MaybeUndefined<DateComparator>,
     /// Comparator for the updated at date.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub updated_at: Option<Box<DateComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub updated_at: MaybeUndefined<DateComparator>,
     /// Comparator for the workflow state name.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<StringComparator>,
     /// Comparator for the workflow state description.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<StringComparator>,
     /// Comparator for the workflow state position.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub position: Option<Box<NumberComparator>>,
-    /// Comparator for the workflow state type. Possible values are "triage", "backlog", "unstarted", "started", "completed", "canceled".
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub r#type: Option<Box<StringComparator>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub position: MaybeUndefined<NumberComparator>,
+    /// Comparator for the workflow state type. Possible values are "triage", "backlog", "unstarted", "started", "completed", "canceled", "duplicate".
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub r#type: MaybeUndefined<StringComparator>,
     /// Filters that the workflow states team must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub team: Option<Box<TeamFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub team: MaybeUndefined<Box<TeamFilter>>,
     /// Filters that the workflow states issues must satisfy.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub issues: Option<Box<IssueCollectionFilter>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub issues: MaybeUndefined<Box<IssueCollectionFilter>>,
     /// Compound filters, all of which need to be matched by the workflow state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub and: Option<Vec<Box<WorkflowStateFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub and: MaybeUndefined<Vec<WorkflowStateFilter>>,
     /// Compound filters, one of which need to be matched by the workflow state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub or: Option<Vec<Box<WorkflowStateFilter>>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub or: MaybeUndefined<Vec<WorkflowStateFilter>>,
 }
 /// Issue workflow state sorting options.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct WorkflowStateSort {
     /// Whether nulls should be sorted first or last
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub nulls: Option<PaginationNulls>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub nulls: MaybeUndefined<PaginationNulls>,
     /// The order for the individual sort
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub order: Option<PaginationSortOrder>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub order: MaybeUndefined<PaginationSortOrder>,
     /// Whether to sort closed issues by recency
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub closed_issues_ordered_by_recency: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub closed_issues_ordered_by_recency: MaybeUndefined<bool>,
 }
+/// Input for updating an existing workflow state. All fields are optional; only provided fields will be updated. The state type cannot be changed after creation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct WorkflowStateUpdateInput {
     /// The name of the state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub name: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub name: MaybeUndefined<String>,
     /// The color of the state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub color: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub color: MaybeUndefined<String>,
     /// The description of the state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub description: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub description: MaybeUndefined<String>,
     /// The position of the state.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub position: Option<f64>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub position: MaybeUndefined<f64>,
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase")]
 pub struct ZendeskSettingsInput {
     /// Whether an internal message should be added when a Linear issue changes status (for status types except completed or canceled).
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub send_note_on_status_change: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub send_note_on_status_change: MaybeUndefined<bool>,
     /// Whether an internal message should be added when someone comments on an issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub send_note_on_comment: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub send_note_on_comment: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when its linked Linear issue is completed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_completion: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_completion: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when its linked Linear issue is cancelled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_cancellation: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_cancellation: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when a comment is posted on its linked Linear issue
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_comment: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_comment: MaybeUndefined<bool>,
     /// `ALPHA` Whether customer and customer requests should not be automatically created when conversations are linked to a Linear issue.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub disable_customer_requests_auto_creation: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub disable_customer_requests_auto_creation: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when its linked Linear project is completed.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_project_completion: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_project_completion: MaybeUndefined<bool>,
     /// Whether a ticket should be automatically reopened when its linked Linear project is cancelled.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub automate_ticket_reopening_on_project_cancellation: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub automate_ticket_reopening_on_project_cancellation: MaybeUndefined<bool>,
     /// Whether Linear Agent should be enabled for this integration.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub enable_ai_intake: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub enable_ai_intake: MaybeUndefined<bool>,
     /// The subdomain of the Zendesk organization being connected.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub subdomain: Option<String>,
+    pub subdomain: String,
     /// The URL of the connected Zendesk organization.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub url: Option<String>,
+    pub url: String,
     /// The ID of the Linear bot user.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub bot_user_id: Option<String>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub bot_user_id: MaybeUndefined<String>,
     /// `INTERNAL` Temporary flag indicating if the integration has the necessary scopes for Customers
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub can_read_customers: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub can_read_customers: MaybeUndefined<bool>,
     /// `INTERNAL` Flag indicating if the integration supports OAuth refresh tokens
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub supports_o_auth_refresh: Option<bool>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub supports_o_auth_refresh: MaybeUndefined<bool>,
     /// The host mappings from Zendesk brands.
-    #[serde(default, skip_serializing_if = "Option::is_none")]
-    pub host_mappings: Option<Vec<String>>,
+    #[serde(default, skip_serializing_if = "MaybeUndefined::is_undefined")]
+    pub host_mappings: MaybeUndefined<Vec<String>>,
 }
diff --git a/crates/lineark-sdk/src/generated/mutations.rs b/crates/lineark-sdk/src/generated/mutations.rs
index c55e6f1..88d2fa9 100644
--- a/crates/lineark-sdk/src/generated/mutations.rs
+++ b/crates/lineark-sdk/src/generated/mutations.rs
@@ -49,97 +49,6 @@ pub async fn image_upload_from_url(
         .execute::<serde_json::Value>(&query, variables, "imageUploadFromUrl")
         .await
 }
-/// Creates a new comment.
-///
-/// Full type: [`Comment`](super::types::Comment)
-pub async fn comment_create<
-    T: serde::de::DeserializeOwned
-        + crate::field_selection::GraphQLFields<FullType = super::types::Comment>,
->(
-    client: &Client,
-    input: CommentCreateInput,
-) -> Result<T, LinearError> {
-    let variables = serde_json::json!({ "input" : input });
-    let query = String::from(
-        "mutation CommentCreate($input: CommentCreateInput!) { commentCreate(input: $input) { success comment { ",
-    ) + &T::selection() + " } } }";
-    client
-        .execute_mutation::<T>(&query, variables, "commentCreate", "comment")
-        .await
-}
-/// Updates a comment.
-///
-/// Full type: [`Comment`](super::types::Comment)
-pub async fn comment_update<
-    T: serde::de::DeserializeOwned
-        + crate::field_selection::GraphQLFields<FullType = super::types::Comment>,
->(
-    client: &Client,
-    skip_edited_at: Option<bool>,
-    input: CommentUpdateInput,
-    id: String,
-) -> Result<T, LinearError> {
-    let variables = serde_json::json!(
-        { "skipEditedAt" : skip_edited_at, "input" : input, "id" : id }
-    );
-    let query = String::from(
-        "mutation CommentUpdate($skipEditedAt: Boolean, $input: CommentUpdateInput!, $id: String!) { commentUpdate(skipEditedAt: $skipEditedAt, input: $input, id: $id) { success comment { ",
-    ) + &T::selection() + " } } }";
-    client
-        .execute_mutation::<T>(&query, variables, "commentUpdate", "comment")
-        .await
-}
-/// Deletes a comment.
-pub async fn comment_delete(client: &Client, id: String) -> Result<serde_json::Value, LinearError> {
-    let variables = serde_json::json!({ "id" : id });
-    let response_parts: Vec<String> = vec!["success".to_string(), "entityId".to_string()];
-    let query = String::from("mutation CommentDelete($id: String!) { commentDelete(id: $id) { ")
-        + &response_parts.join(" ")
-        + " } }";
-    client
-        .execute::<serde_json::Value>(&query, variables, "commentDelete")
-        .await
-}
-/// Resolves a comment.
-///
-/// Full type: [`Comment`](super::types::Comment)
-pub async fn comment_resolve<
-    T: serde::de::DeserializeOwned
-        + crate::field_selection::GraphQLFields<FullType = super::types::Comment>,
->(
-    client: &Client,
-    resolving_comment_id: Option<String>,
-    id: String,
-) -> Result<T, LinearError> {
-    let variables = serde_json::json!(
-        { "resolvingCommentId" : resolving_comment_id, "id" : id }
-    );
-    let query = String::from(
-        "mutation CommentResolve($resolvingCommentId: String, $id: String!) { commentResolve(resolvingCommentId: $resolvingCommentId, id: $id) { success comment { ",
-    ) + &T::selection() + " } } }";
-    client
-        .execute_mutation::<T>(&query, variables, "commentResolve", "comment")
-        .await
-}
-/// Unresolves a comment.
-///
-/// Full type: [`Comment`](super::types::Comment)
-pub async fn comment_unresolve<
-    T: serde::de::DeserializeOwned
-        + crate::field_selection::GraphQLFields<FullType = super::types::Comment>,
->(
-    client: &Client,
-    id: String,
-) -> Result<T, LinearError> {
-    let variables = serde_json::json!({ "id" : id });
-    let query = String::from(
-        "mutation CommentUnresolve($id: String!) { commentUnresolve(id: $id) { success comment { ",
-    ) + &T::selection()
-        + " } } }";
-    client
-        .execute_mutation::<T>(&query, variables, "commentUnresolve", "comment")
-        .await
-}
 /// Creates a new project.
 ///
 /// Full type: [`Project`](super::types::Project)
@@ -180,7 +89,7 @@ pub async fn project_update<
         .execute_mutation::<T>(&query, variables, "projectUpdate", "project")
         .await
 }
-/// Deletes (trashes) a project.
+/// Deletes (trashes) a project. The project can be restored later with projectUnarchive.
 ///
 /// Full type: [`Project`](super::types::Project)
 pub async fn project_delete<
@@ -199,7 +108,7 @@ pub async fn project_delete<
         .execute_mutation::<T>(&query, variables, "projectDelete", "entity")
         .await
 }
-/// Creates a new team. The user who creates the team will automatically be added as a member to the newly created team.
+/// Creates a new team. The user who creates the team will automatically be added as a member and owner of the newly created team. Default workflow states, labels, and other team resources are created alongside the team.
 ///
 /// Full type: [`Team`](super::types::Team)
 pub async fn team_create<
@@ -220,7 +129,7 @@ pub async fn team_create<
         .execute_mutation::<T>(&query, variables, "teamCreate", "team")
         .await
 }
-/// Updates a team.
+/// Updates a team's settings, properties, or configuration. Requires team owner or workspace admin permissions for most changes.
 ///
 /// Full type: [`Team`](super::types::Team)
 pub async fn team_update<
@@ -242,7 +151,7 @@ pub async fn team_update<
         .execute_mutation::<T>(&query, variables, "teamUpdate", "team")
         .await
 }
-/// Deletes a team.
+/// Archives a team and schedules its data for deletion. Requires team owner or workspace admin permissions.
 pub async fn team_delete(client: &Client, id: String) -> Result<serde_json::Value, LinearError> {
     let variables = serde_json::json!({ "id" : id });
     let response_parts: Vec<String> = vec!["success".to_string(), "entityId".to_string()];
@@ -253,7 +162,7 @@ pub async fn team_delete(client: &Client, id: String) -> Result<serde_json::Valu
         .execute::<serde_json::Value>(&query, variables, "teamDelete")
         .await
 }
-/// Creates a new team membership.
+/// Creates a new team membership, adding a user to a team. Validates that the user is not already a member, the team is not archived or retired, and the requesting user has permission to add members.
 ///
 /// Full type: [`TeamMembership`](super::types::TeamMembership)
 pub async fn team_membership_create<
@@ -271,7 +180,7 @@ pub async fn team_membership_create<
         .execute_mutation::<T>(&query, variables, "teamMembershipCreate", "teamMembership")
         .await
 }
-/// Deletes a team membership.
+/// Deletes a team membership, removing the user from the team. Users can remove their own membership, or team owners and workspace admins can remove other members.
 pub async fn team_membership_delete(
     client: &Client,
     also_leave_parent_teams: Option<bool>,
@@ -596,7 +505,7 @@ pub async fn document_update<
         .execute_mutation::<T>(&query, variables, "documentUpdate", "document")
         .await
 }
-/// Deletes (trashes) a document.
+/// Deletes (trashes) a document. The document is marked as trashed and archived, but not permanently removed.
 ///
 /// Full type: [`Document`](super::types::Document)
 pub async fn document_delete<
@@ -615,3 +524,94 @@ pub async fn document_delete<
         .execute_mutation::<T>(&query, variables, "documentDelete", "entity")
         .await
 }
+/// Creates a new comment.
+///
+/// Full type: [`Comment`](super::types::Comment)
+pub async fn comment_create<
+    T: serde::de::DeserializeOwned
+        + crate::field_selection::GraphQLFields<FullType = super::types::Comment>,
+>(
+    client: &Client,
+    input: CommentCreateInput,
+) -> Result<T, LinearError> {
+    let variables = serde_json::json!({ "input" : input });
+    let query = String::from(
+        "mutation CommentCreate($input: CommentCreateInput!) { commentCreate(input: $input) { success comment { ",
+    ) + &T::selection() + " } } }";
+    client
+        .execute_mutation::<T>(&query, variables, "commentCreate", "comment")
+        .await
+}
+/// Updates a comment.
+///
+/// Full type: [`Comment`](super::types::Comment)
+pub async fn comment_update<
+    T: serde::de::DeserializeOwned
+        + crate::field_selection::GraphQLFields<FullType = super::types::Comment>,
+>(
+    client: &Client,
+    skip_edited_at: Option<bool>,
+    input: CommentUpdateInput,
+    id: String,
+) -> Result<T, LinearError> {
+    let variables = serde_json::json!(
+        { "skipEditedAt" : skip_edited_at, "input" : input, "id" : id }
+    );
+    let query = String::from(
+        "mutation CommentUpdate($skipEditedAt: Boolean, $input: CommentUpdateInput!, $id: String!) { commentUpdate(skipEditedAt: $skipEditedAt, input: $input, id: $id) { success comment { ",
+    ) + &T::selection() + " } } }";
+    client
+        .execute_mutation::<T>(&query, variables, "commentUpdate", "comment")
+        .await
+}
+/// Deletes a comment.
+pub async fn comment_delete(client: &Client, id: String) -> Result<serde_json::Value, LinearError> {
+    let variables = serde_json::json!({ "id" : id });
+    let response_parts: Vec<String> = vec!["success".to_string(), "entityId".to_string()];
+    let query = String::from("mutation CommentDelete($id: String!) { commentDelete(id: $id) { ")
+        + &response_parts.join(" ")
+        + " } }";
+    client
+        .execute::<serde_json::Value>(&query, variables, "commentDelete")
+        .await
+}
+/// Resolves a comment thread. Marks the root comment as resolved by the current user.
+///
+/// Full type: [`Comment`](super::types::Comment)
+pub async fn comment_resolve<
+    T: serde::de::DeserializeOwned
+        + crate::field_selection::GraphQLFields<FullType = super::types::Comment>,
+>(
+    client: &Client,
+    resolving_comment_id: Option<String>,
+    id: String,
+) -> Result<T, LinearError> {
+    let variables = serde_json::json!(
+        { "resolvingCommentId" : resolving_comment_id, "id" : id }
+    );
+    let query = String::from(
+        "mutation CommentResolve($resolvingCommentId: String, $id: String!) { commentResolve(resolvingCommentId: $resolvingCommentId, id: $id) { success comment { ",
+    ) + &T::selection() + " } } }";
+    client
+        .execute_mutation::<T>(&query, variables, "commentResolve", "comment")
+        .await
+}
+/// Unresolves a previously resolved comment thread. Clears the resolved state on the root comment.
+///
+/// Full type: [`Comment`](super::types::Comment)
+pub async fn comment_unresolve<
+    T: serde::de::DeserializeOwned
+        + crate::field_selection::GraphQLFields<FullType = super::types::Comment>,
+>(
+    client: &Client,
+    id: String,
+) -> Result<T, LinearError> {
+    let variables = serde_json::json!({ "id" : id });
+    let query = String::from(
+        "mutation CommentUnresolve($id: String!) { commentUnresolve(id: $id) { success comment { ",
+    ) + &T::selection()
+        + " } } }";
+    client
+        .execute_mutation::<T>(&query, variables, "commentUnresolve", "comment")
+        .await
+}
diff --git a/crates/lineark-sdk/src/generated/queries.rs b/crates/lineark-sdk/src/generated/queries.rs
index 3efb697..406af4e 100644
--- a/crates/lineark-sdk/src/generated/queries.rs
+++ b/crates/lineark-sdk/src/generated/queries.rs
@@ -12,7 +12,7 @@ use crate::error::LinearError;
 use crate::field_selection::GraphQLFields;
 use crate::pagination::Connection;
 use serde::de::DeserializeOwned;
-/// Query builder: All issue workflow states.
+/// Query builder: All issue workflow states (issue statuses). Returns a paginated list of workflow states visible to the authenticated user, across all teams they have access to.
 ///
 /// Full type: [`WorkflowState`](super::types::WorkflowState)
 ///
@@ -99,7 +99,7 @@ impl<'a, T: DeserializeOwned + GraphQLFields<FullType = super::types::WorkflowSt
             .await
     }
 }
-/// Query builder: All users for the organization.
+/// Query builder: All users in the workspace. Supports filtering, sorting, and pagination.
 ///
 /// Full type: [`User`](super::types::User)
 ///
@@ -202,7 +202,7 @@ impl<'a, T: DeserializeOwned + GraphQLFields<FullType = super::types::User>>
             .await
     }
 }
-/// Query builder: All projects.
+/// Query builder: Returns all projects in the workspace, with optional filtering and sorting.
 ///
 /// Full type: [`Project`](super::types::Project)
 ///
@@ -297,7 +297,7 @@ impl<'a, T: DeserializeOwned + GraphQLFields<FullType = super::types::Project>>
             .await
     }
 }
-/// Query builder: All teams whose issues can be accessed by the user. This might be different from `administrableTeams`, which also includes teams whose settings can be changed by the user.
+/// Query builder: All teams whose issues the user can access. This includes public teams and private teams the user is a member of. This may differ from `administrableTeams`, which returns teams whose settings the user can change but whose issues they don't necessarily have access to.
 ///
 /// Full type: [`Team`](super::types::Team)
 ///
@@ -384,7 +384,7 @@ impl<'a, T: DeserializeOwned + GraphQLFields<FullType = super::types::Team>>
             .await
     }
 }
-/// Query builder: Search issues.
+/// Query builder: Search issues by text query using full-text and vector search. Results are ranked by relevance unless an orderBy parameter is specified. Supports optional issue filters and comment inclusion. Rate-limited to 30 requests per minute.
 ///
 /// Full type: [`IssueSearchResult`](super::types::IssueSearchResult)
 ///
@@ -489,7 +489,7 @@ impl<'a, T: DeserializeOwned + GraphQLFields<FullType = super::types::IssueSearc
             .await
     }
 }
-/// Query builder: All project statuses.
+/// Query builder: Returns all project statuses in the workspace.
 ///
 /// Full type: [`ProjectStatus`](super::types::ProjectStatus)
 ///
@@ -568,7 +568,7 @@ impl<'a, T: DeserializeOwned + GraphQLFields<FullType = super::types::ProjectSta
             .await
     }
 }
-/// Query builder: All milestones for the project.
+/// Query builder: Returns all project milestones in the workspace, with optional filtering.
 ///
 /// Full type: [`ProjectMilestone`](super::types::ProjectMilestone)
 ///
@@ -655,7 +655,7 @@ impl<'a, T: DeserializeOwned + GraphQLFields<FullType = super::types::ProjectMil
             .await
     }
 }
-/// Query builder: All project labels.
+/// Query builder: Returns all project labels in the workspace, with optional filtering.
 ///
 /// Full type: [`ProjectLabel`](super::types::ProjectLabel)
 ///
@@ -742,7 +742,7 @@ impl<'a, T: DeserializeOwned + GraphQLFields<FullType = super::types::ProjectLab
             .await
     }
 }
-/// Query builder: All issues.
+/// Query builder: All issues. Returns a paginated list of issues visible to the authenticated user. Can be filtered by various criteria including team, assignee, state, labels, project, and cycle.
 ///
 /// Full type: [`Issue`](super::types::Issue)
 ///
@@ -837,7 +837,7 @@ impl<'a, T: DeserializeOwned + GraphQLFields<FullType = super::types::Issue>>
             .await
     }
 }
-/// Query builder: All issue relationships.
+/// Query builder: All issue relations. Returns a paginated list of all issue relations (blocks, blocked by, relates to, duplicates) visible to the authenticated user.
 ///
 /// Full type: [`IssueRelation`](super::types::IssueRelation)
 ///
@@ -916,7 +916,7 @@ impl<'a, T: DeserializeOwned + GraphQLFields<FullType = super::types::IssueRelat
             .await
     }
 }
-/// Query builder: All issue labels.
+/// Query builder: All issue labels. Returns a paginated list of labels visible to the authenticated user, including both workspace-level and team-scoped labels.
 ///
 /// Full type: [`IssueLabel`](super::types::IssueLabel)
 ///
@@ -1003,7 +1003,7 @@ impl<'a, T: DeserializeOwned + GraphQLFields<FullType = super::types::IssueLabel
             .await
     }
 }
-/// Query builder: All documents in the workspace.
+/// Query builder: All documents the user has access to in the workspace.
 ///
 /// Full type: [`Document`](super::types::Document)
 ///
@@ -1090,7 +1090,7 @@ impl<'a, T: DeserializeOwned + GraphQLFields<FullType = super::types::Document>>
             .await
     }
 }
-/// Query builder: All cycles.
+/// Query builder: All cycles accessible to the user.
 ///
 /// Full type: [`Cycle`](super::types::Cycle)
 ///
@@ -1177,7 +1177,7 @@ impl<'a, T: DeserializeOwned + GraphQLFields<FullType = super::types::Cycle>>
             .await
     }
 }
-/// All issue workflow states.
+/// All issue workflow states (issue statuses). Returns a paginated list of workflow states visible to the authenticated user, across all teams they have access to.
 ///
 /// Full type: [`WorkflowState`](super::types::WorkflowState)
 pub fn workflow_states<'a, T>(client: &'a Client) -> WorkflowStatesQueryBuilder<'a, T> {
@@ -1193,7 +1193,7 @@ pub fn workflow_states<'a, T>(client: &'a Client) -> WorkflowStatesQueryBuilder<
         _marker: std::marker::PhantomData,
     }
 }
-/// All users for the organization.
+/// All users in the workspace. Supports filtering, sorting, and pagination.
 ///
 /// Full type: [`User`](super::types::User)
 pub fn users<'a, T>(client: &'a Client) -> UsersQueryBuilder<'a, T> {
@@ -1211,7 +1211,7 @@ pub fn users<'a, T>(client: &'a Client) -> UsersQueryBuilder<'a, T> {
         _marker: std::marker::PhantomData,
     }
 }
-/// The currently authenticated user.
+/// The currently authenticated user making the API request.
 ///
 /// Full type: [`User`](super::types::User)
 pub async fn whoami<T: DeserializeOwned + GraphQLFields<FullType = super::types::User>>(
@@ -1222,7 +1222,7 @@ pub async fn whoami<T: DeserializeOwned + GraphQLFields<FullType = super::types:
     let query = format!("query {} {{ {} {{ {} }} }}", "Viewer", "viewer", selection);
     client.execute::<T>(&query, variables, "viewer").await
 }
-/// All projects.
+/// Returns all projects in the workspace, with optional filtering and sorting.
 ///
 /// Full type: [`Project`](super::types::Project)
 pub fn projects<'a, T>(client: &'a Client) -> ProjectsQueryBuilder<'a, T> {
@@ -1239,7 +1239,7 @@ pub fn projects<'a, T>(client: &'a Client) -> ProjectsQueryBuilder<'a, T> {
         _marker: std::marker::PhantomData,
     }
 }
-/// One specific project.
+/// Returns a single project by its identifier or URL slug.
 ///
 /// Full type: [`Project`](super::types::Project)
 pub async fn project<T: DeserializeOwned + GraphQLFields<FullType = super::types::Project>>(
@@ -1254,7 +1254,7 @@ pub async fn project<T: DeserializeOwned + GraphQLFields<FullType = super::types
     );
     client.execute::<T>(&query, variables, "project").await
 }
-/// All teams whose issues can be accessed by the user. This might be different from `administrableTeams`, which also includes teams whose settings can be changed by the user.
+/// All teams whose issues the user can access. This includes public teams and private teams the user is a member of. This may differ from `administrableTeams`, which returns teams whose settings the user can change but whose issues they don't necessarily have access to.
 ///
 /// Full type: [`Team`](super::types::Team)
 pub fn teams<'a, T>(client: &'a Client) -> TeamsQueryBuilder<'a, T> {
@@ -1270,7 +1270,7 @@ pub fn teams<'a, T>(client: &'a Client) -> TeamsQueryBuilder<'a, T> {
         _marker: std::marker::PhantomData,
     }
 }
-/// One specific team.
+/// Fetches a specific team by its ID.
 ///
 /// Full type: [`Team`](super::types::Team)
 pub async fn team<T: DeserializeOwned + GraphQLFields<FullType = super::types::Team>>(
@@ -1285,7 +1285,7 @@ pub async fn team<T: DeserializeOwned + GraphQLFields<FullType = super::types::T
     );
     client.execute::<T>(&query, variables, "team").await
 }
-/// Search issues.
+/// Search issues by text query using full-text and vector search. Results are ranked by relevance unless an orderBy parameter is specified. Supports optional issue filters and comment inclusion. Rate-limited to 30 requests per minute.
 ///
 /// Full type: [`IssueSearchResult`](super::types::IssueSearchResult)
 pub fn search_issues<'a, T>(
@@ -1307,7 +1307,7 @@ pub fn search_issues<'a, T>(
         _marker: std::marker::PhantomData,
     }
 }
-/// All project statuses.
+/// Returns all project statuses in the workspace.
 ///
 /// Full type: [`ProjectStatus`](super::types::ProjectStatus)
 pub fn project_statuses<'a, T>(client: &'a Client) -> ProjectStatusesQueryBuilder<'a, T> {
@@ -1322,7 +1322,7 @@ pub fn project_statuses<'a, T>(client: &'a Client) -> ProjectStatusesQueryBuilde
         _marker: std::marker::PhantomData,
     }
 }
-/// All milestones for the project.
+/// Returns all project milestones in the workspace, with optional filtering.
 ///
 /// Full type: [`ProjectMilestone`](super::types::ProjectMilestone)
 pub fn project_milestones<'a, T>(client: &'a Client) -> ProjectMilestonesQueryBuilder<'a, T> {
@@ -1338,7 +1338,7 @@ pub fn project_milestones<'a, T>(client: &'a Client) -> ProjectMilestonesQueryBu
         _marker: std::marker::PhantomData,
     }
 }
-/// One specific project milestone.
+/// Returns a single project milestone by its identifier.
 ///
 /// Full type: [`ProjectMilestone`](super::types::ProjectMilestone)
 pub async fn project_milestone<
@@ -1357,7 +1357,7 @@ pub async fn project_milestone<
         .execute::<T>(&query, variables, "projectMilestone")
         .await
 }
-/// All project labels.
+/// Returns all project labels in the workspace, with optional filtering.
 ///
 /// Full type: [`ProjectLabel`](super::types::ProjectLabel)
 pub fn project_labels<'a, T>(client: &'a Client) -> ProjectLabelsQueryBuilder<'a, T> {
@@ -1373,7 +1373,7 @@ pub fn project_labels<'a, T>(client: &'a Client) -> ProjectLabelsQueryBuilder<'a
         _marker: std::marker::PhantomData,
     }
 }
-/// All issues.
+/// All issues. Returns a paginated list of issues visible to the authenticated user. Can be filtered by various criteria including team, assignee, state, labels, project, and cycle.
 ///
 /// Full type: [`Issue`](super::types::Issue)
 pub fn issues<'a, T>(client: &'a Client) -> IssuesQueryBuilder<'a, T> {
@@ -1390,7 +1390,7 @@ pub fn issues<'a, T>(client: &'a Client) -> IssuesQueryBuilder<'a, T> {
         _marker: std::marker::PhantomData,
     }
 }
-/// One specific issue.
+/// One specific issue, looked up by its unique identifier.
 ///
 /// Full type: [`Issue`](super::types::Issue)
 pub async fn issue<T: DeserializeOwned + GraphQLFields<FullType = super::types::Issue>>(
@@ -1428,7 +1428,7 @@ pub async fn issue_vcs_branch_search<
         .execute::<Option<T>>(&query, variables, "issueVcsBranchSearch")
         .await
 }
-/// All issue relationships.
+/// All issue relations. Returns a paginated list of all issue relations (blocks, blocked by, relates to, duplicates) visible to the authenticated user.
 ///
 /// Full type: [`IssueRelation`](super::types::IssueRelation)
 pub fn issue_relations<'a, T>(client: &'a Client) -> IssueRelationsQueryBuilder<'a, T> {
@@ -1443,7 +1443,7 @@ pub fn issue_relations<'a, T>(client: &'a Client) -> IssueRelationsQueryBuilder<
         _marker: std::marker::PhantomData,
     }
 }
-/// One specific issue relation.
+/// One specific issue relation, looked up by its unique identifier.
 ///
 /// Full type: [`IssueRelation`](super::types::IssueRelation)
 pub async fn issue_relation<
@@ -1462,7 +1462,7 @@ pub async fn issue_relation<
         .execute::<T>(&query, variables, "issueRelation")
         .await
 }
-/// All issue labels.
+/// All issue labels. Returns a paginated list of labels visible to the authenticated user, including both workspace-level and team-scoped labels.
 ///
 /// Full type: [`IssueLabel`](super::types::IssueLabel)
 pub fn issue_labels<'a, T>(client: &'a Client) -> IssueLabelsQueryBuilder<'a, T> {
@@ -1478,7 +1478,7 @@ pub fn issue_labels<'a, T>(client: &'a Client) -> IssueLabelsQueryBuilder<'a, T>
         _marker: std::marker::PhantomData,
     }
 }
-/// All documents in the workspace.
+/// All documents the user has access to in the workspace.
 ///
 /// Full type: [`Document`](super::types::Document)
 pub fn documents<'a, T>(client: &'a Client) -> DocumentsQueryBuilder<'a, T> {
@@ -1494,7 +1494,7 @@ pub fn documents<'a, T>(client: &'a Client) -> DocumentsQueryBuilder<'a, T> {
         _marker: std::marker::PhantomData,
     }
 }
-/// One specific document.
+/// A specific document by ID or slug.
 ///
 /// Full type: [`Document`](super::types::Document)
 pub async fn document<T: DeserializeOwned + GraphQLFields<FullType = super::types::Document>>(
@@ -1509,7 +1509,7 @@ pub async fn document<T: DeserializeOwned + GraphQLFields<FullType = super::type
     );
     client.execute::<T>(&query, variables, "document").await
 }
-/// All cycles.
+/// All cycles accessible to the user.
 ///
 /// Full type: [`Cycle`](super::types::Cycle)
 pub fn cycles<'a, T>(client: &'a Client) -> CyclesQueryBuilder<'a, T> {
@@ -1525,7 +1525,7 @@ pub fn cycles<'a, T>(client: &'a Client) -> CyclesQueryBuilder<'a, T> {
         _marker: std::marker::PhantomData,
     }
 }
-/// One specific cycle.
+/// One specific cycle, looked up by ID or slug.
 ///
 /// Full type: [`Cycle`](super::types::Cycle)
 pub async fn cycle<T: DeserializeOwned + GraphQLFields<FullType = super::types::Cycle>>(
diff --git a/crates/lineark-sdk/src/generated/types.rs b/crates/lineark-sdk/src/generated/types.rs
index 72daf75..73e45a2 100644
--- a/crates/lineark-sdk/src/generated/types.rs
+++ b/crates/lineark-sdk/src/generated/types.rs
@@ -4,48 +4,21 @@
 use super::enums::*;
 use crate::field_selection::GraphQLFields;
 use serde::{Deserialize, Serialize};
-/// `Internal` An access key for CI/CD integrations.
-#[derive(Debug, Clone, Default, Serialize, Deserialize)]
-#[serde(rename_all = "camelCase", default)]
-pub struct AccessKey {
-    /// The unique identifier of the entity.
-    pub id: Option<String>,
-    /// The time at which the entity was created.
-    pub created_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
-    /// been updated after creation.
-    pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the entity was archived. Null if the entity has not been archived.
-    pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Organization the API key belongs to.
-    pub organization: Option<Box<Organization>>,
-    /// The user who created the access key.
-    pub creator: Option<Box<User>>,
-    /// When the access key was last used.
-    pub last_used_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// When the access key was revoked.
-    pub revoked_at: Option<chrono::DateTime<chrono::Utc>>,
-}
-impl GraphQLFields for AccessKey {
-    type FullType = Self;
-    fn selection() -> String {
-        "id createdAt updatedAt archivedAt lastUsedAt revokedAt".into()
-    }
-}
-/// A bot actor is an actor that is not a user, but an application or integration.
+/// A bot actor representing a non-human entity that performed an action, such as an integration (GitHub, Slack, Zendesk), an AI assistant, or an automated workflow. Bot actors are displayed in activity feeds and history to indicate when changes were made by applications rather than users.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ActorBot {
+    /// A unique identifier for the bot actor.
     pub id: Option<String>,
-    /// The type of bot.
+    /// The source type of the bot, identifying the application or integration (e.g., 'github', 'slack', 'workflow', 'ai').
     pub r#type: Option<String>,
-    /// The sub type of the bot.
+    /// A more specific classification within the bot type, providing additional context about the integration or application variant.
     pub sub_type: Option<String>,
     /// The display name of the bot.
     pub name: Option<String>,
-    /// The display name of the external user on behalf of which the bot acted.
+    /// The display name of the external user on behalf of whom the bot acted. Shown when an integration action was triggered by a specific person in the external system.
     pub user_display_name: Option<String>,
-    /// A url pointing to the avatar representing this bot.
+    /// A URL pointing to the avatar image representing this bot, typically the integration's logo or icon.
     pub avatar_url: Option<String>,
 }
 impl GraphQLFields for ActorBot {
@@ -54,7 +27,7 @@ impl GraphQLFields for ActorBot {
         "id type subType name userDisplayName avatarUrl".into()
     }
 }
-/// An activity within an agent context.
+/// An activity performed by or directed at an AI coding agent during a session. Activities represent the observable steps of an agent's work, including thoughts, actions (tool calls), responses, prompts from users, errors, and elicitation requests. Each activity belongs to an agent session and is associated with the user who initiated it.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AgentActivity {
@@ -68,26 +41,26 @@ pub struct AgentActivity {
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The agent session this activity belongs to.
-    pub agent_session: Option<Box<AgentSession>>,
-    /// The comment this activity is linked to.
-    pub source_comment: Option<Box<Comment>>,
+    pub agent_session: Option<AgentSession>,
+    /// The source comment this activity is linked to. Null if the activity was not triggered by a comment.
+    pub source_comment: Option<Comment>,
     /// The user who created this agent activity.
-    pub user: Option<Box<User>>,
+    pub user: Option<User>,
     /// Metadata about the external source that created this agent activity.
     pub source_metadata: Option<serde_json::Value>,
     /// An optional modifier that provides additional instructions on how the activity should be interpreted.
     pub signal: Option<AgentActivitySignal>,
-    /// Metadata about this agent activity's signal.
-    pub signal_metadata: Option<serde_json::Value>,
     /// Whether the activity is ephemeral, and should disappear after the next agent activity.
     pub ephemeral: Option<bool>,
     /// `Internal` Metadata about user-provided contextual information for this agent activity.
     pub contextual_metadata: Option<serde_json::Value>,
+    /// Metadata about this agent activity's signal.
+    pub signal_metadata: Option<serde_json::Value>,
 }
 impl GraphQLFields for AgentActivity {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt sourceMetadata signal signalMetadata ephemeral contextualMetadata"
+        "id createdAt updatedAt archivedAt sourceMetadata signal ephemeral contextualMetadata signalMetadata"
             .into()
     }
 }
@@ -115,9 +88,9 @@ impl GraphQLFields for AgentActivityActionContent {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AgentActivityConnection {
-    pub edges: Option<Box<Vec<AgentActivityEdge>>>,
-    pub nodes: Option<Box<Vec<AgentActivity>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<AgentActivityEdge>>,
+    pub nodes: Option<Vec<AgentActivity>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for AgentActivityConnection {
     type FullType = Self;
@@ -128,7 +101,7 @@ impl GraphQLFields for AgentActivityConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AgentActivityEdge {
-    pub node: Option<Box<AgentActivity>>,
+    pub node: Option<AgentActivity>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -172,13 +145,14 @@ impl GraphQLFields for AgentActivityErrorContent {
         "type body bodyData".into()
     }
 }
+/// The result of an agent activity mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AgentActivityPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The agent activity that was created or updated.
-    pub agent_activity: Option<Box<AgentActivity>>,
+    pub agent_activity: Option<AgentActivity>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -239,7 +213,7 @@ impl GraphQLFields for AgentActivityThoughtContent {
         "type body bodyData".into()
     }
 }
-/// A session for agent activities and state management.
+/// A session representing an AI coding agent's work on an issue or conversation. Agent sessions track the lifecycle of an agent's engagement, from creation through active work to completion or dismissal. Each session is associated with an agent user (the bot), optionally a human creator, an issue, and a comment thread where the agent posts updates. Sessions contain activities that record the agent's observable steps and can be linked to pull requests created during the work.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AgentSession {
@@ -262,52 +236,54 @@ pub struct AgentSession {
     pub source_comment: Option<Box<Comment>>,
     /// The issue this agent session is associated with.
     pub issue: Option<Box<Issue>>,
-    /// The current status of the agent session.
+    /// The agent session's unique URL slug.
+    pub slug_id: Option<String>,
+    /// The current status of the agent session, such as pending, active, awaiting input, complete, error, or stale.
     pub status: Option<AgentSessionStatus>,
-    /// The time the agent session started.
+    /// The time the agent session transitioned to active status and began work. Null if the session has not yet started.
     pub started_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time the agent session ended.
+    /// The time the agent session completed. Null if the session is still in progress or was dismissed before completion.
     pub ended_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time the agent session was dismissed.
+    /// The time a user dismissed this agent session. When dismissed, the agent is removed as delegate from the associated issue. Null if the session has not been dismissed.
     pub dismissed_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The user who dismissed the agent session.
+    /// The user who dismissed the agent session. Automatically set when dismissedAt is updated. Null if the session has not been dismissed.
     pub dismissed_by: Option<Box<User>>,
     /// Activities associated with this agent session.
-    pub activities: Option<Box<AgentActivityConnection>>,
+    pub activities: Option<AgentActivityConnection>,
     /// The URL of an external agent-hosted page associated with this session.
     pub external_link: Option<String>,
-    /// A summary of the activities in this session.
+    /// A human-readable summary of the work performed in this session. Null if no summary has been generated yet.
     pub summary: Option<String>,
     /// Metadata about the external source that created this agent session.
     pub source_metadata: Option<serde_json::Value>,
-    /// A dynamically updated list of the agent's execution strategy.
+    /// A dynamically updated plan describing the agent's execution strategy, including steps to be taken and their current status. Updated as the agent progresses through its work. Null if no plan has been set.
     pub plan: Option<serde_json::Value>,
-    /// Serialized JSON representing the contexts this session is related to, for direct chat sessions.
+    /// The entity contexts this session is related to, such as issues or projects referenced in direct chat sessions. Used to provide contextual awareness to the agent.
     pub context: Option<serde_json::Value>,
     /// `DEPRECATED` The type of the agent session.
     pub r#type: Option<AgentSessionType>,
-    /// Agent session URL.
+    /// The URL to the agent session page in the Linear app. Null for direct chat sessions without an associated issue.
     pub url: Option<String>,
     /// `Internal` Pull requests associated with this agent session.
-    pub pull_requests: Option<Box<AgentSessionToPullRequestConnection>>,
+    pub pull_requests: Option<AgentSessionToPullRequestConnection>,
     /// External links associated with this session.
-    pub external_links: Option<Box<Vec<AgentSessionExternalLink>>>,
+    pub external_links: Option<Vec<AgentSessionExternalLink>>,
     /// URLs of external resources associated with this session.
     pub external_urls: Option<serde_json::Value>,
 }
 impl GraphQLFields for AgentSession {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt status startedAt endedAt dismissedAt externalLink summary sourceMetadata plan context type url externalUrls"
+        "id createdAt updatedAt archivedAt slugId status startedAt endedAt dismissedAt externalLink summary sourceMetadata plan context type url externalUrls"
             .into()
     }
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AgentSessionConnection {
-    pub edges: Option<Box<Vec<AgentSessionEdge>>>,
-    pub nodes: Option<Box<Vec<AgentSession>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<AgentSessionEdge>>,
+    pub nodes: Option<Vec<AgentSession>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for AgentSessionConnection {
     type FullType = Self;
@@ -318,7 +294,7 @@ impl GraphQLFields for AgentSessionConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AgentSessionEdge {
-    pub node: Option<Box<AgentSession>>,
+    pub node: Option<AgentSession>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -351,7 +327,7 @@ pub struct AgentSessionPayload {
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The agent session that was created or updated.
-    pub agent_session: Option<Box<AgentSession>>,
+    pub agent_session: Option<AgentSession>,
 }
 impl GraphQLFields for AgentSessionPayload {
     type FullType = Self;
@@ -359,7 +335,7 @@ impl GraphQLFields for AgentSessionPayload {
         "lastSyncId success".into()
     }
 }
-/// Join table between agent sessions and pull requests.
+/// A link between an agent session and a pull request created or associated during that session. This join entity tracks which pull requests were produced by or connected to a coding agent's work session, and handles backfilling links when pull requests are synced after the agent has already recorded the URL.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AgentSessionToPullRequest {
@@ -373,9 +349,9 @@ pub struct AgentSessionToPullRequest {
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The pull request that the agent session is associated with.
-    pub pull_request: Option<Box<PullRequest>>,
+    pub pull_request: Option<PullRequest>,
     /// The agent session that the pull request is associated with.
-    pub agent_session: Option<Box<AgentSession>>,
+    pub agent_session: Option<AgentSession>,
 }
 impl GraphQLFields for AgentSessionToPullRequest {
     type FullType = Self;
@@ -386,9 +362,9 @@ impl GraphQLFields for AgentSessionToPullRequest {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AgentSessionToPullRequestConnection {
-    pub edges: Option<Box<Vec<AgentSessionToPullRequestEdge>>>,
-    pub nodes: Option<Box<Vec<AgentSessionToPullRequest>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<AgentSessionToPullRequestEdge>>,
+    pub nodes: Option<Vec<AgentSessionToPullRequest>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for AgentSessionToPullRequestConnection {
     type FullType = Self;
@@ -399,7 +375,7 @@ impl GraphQLFields for AgentSessionToPullRequestConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AgentSessionToPullRequestEdge {
-    pub node: Option<Box<AgentSessionToPullRequest>>,
+    pub node: Option<AgentSessionToPullRequest>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -409,10 +385,10 @@ impl GraphQLFields for AgentSessionToPullRequestEdge {
         "cursor".into()
     }
 }
-/// AI prompt rules for a team.
+/// `Internal` A conversation between a user and the Linear AI assistant. Each conversation tracks the full thread state, context references (issues, projects, documents, etc.), and conversation parts (prompts, text responses, tool calls, widgets). Conversations can originate from direct chat, issue comments, Slack threads, Microsoft Teams, or automated workflows.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
-pub struct AiPromptRules {
+pub struct AiConversation {
     /// The unique identifier of the entity.
     pub id: Option<String>,
     /// The time at which the entity was created.
@@ -422,221 +398,1176 @@ pub struct AiPromptRules {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The user who last updated the AI prompt rules.
-    pub updated_by: Option<Box<User>>,
+    /// The user who the conversation belongs to.
+    pub user: Option<User>,
+    /// The entity contexts this conversation is related to, such as issues, projects, or documents that provide context for the AI assistant.
+    pub context: Option<serde_json::Value>,
+    /// A summary of the conversation.
+    pub summary: Option<String>,
+    /// The conversation's unique URL slug.
+    pub slug_id: Option<String>,
+    /// `Internal` The workflow definition that created this conversation.
+    pub workflow_definition: Option<WorkflowDefinition>,
+    /// The source from which this conversation was initiated, such as direct chat, an issue comment, a Slack thread, Microsoft Teams, or a workflow automation.
+    pub initial_source: Option<AiConversationInitialSource>,
+    /// The current processing status of the conversation, indicating whether the AI is actively generating a response or has completed its turn.
+    pub status: Option<AiConversationStatus>,
+    /// The time when the user marked the conversation as read. Null if the user hasn't read the conversation.
+    pub read_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The iteration ID when this conversation is part of an agentic workflow. Used to track multi-step workflow executions. Null for non-workflow conversations.
+    pub iteration_id: Option<String>,
+    /// `Internal` The log ID of the AI response.
+    pub eval_log_id: Option<String>,
 }
-impl GraphQLFields for AiPromptRules {
+impl GraphQLFields for AiConversation {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt".into()
+        "id createdAt updatedAt archivedAt context summary slugId initialSource status readAt iterationId evalLogId"
+            .into()
     }
 }
-/// Public information of the OAuth application.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
-pub struct Application {
-    /// OAuth application's ID.
-    pub id: Option<String>,
-    /// OAuth application's client ID.
-    pub client_id: Option<String>,
-    /// Application name.
-    pub name: Option<String>,
-    /// Information about the application.
-    pub description: Option<String>,
-    /// Name of the developer.
-    pub developer: Option<String>,
-    /// Url of the developer (homepage or docs).
-    pub developer_url: Option<String>,
-    /// Image of the application.
-    pub image_url: Option<String>,
+pub struct AiConversationCodeIntelligenceToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationCodeIntelligenceToolCallArgs>,
 }
-impl GraphQLFields for Application {
+impl GraphQLFields for AiConversationCodeIntelligenceToolCall {
     type FullType = Self;
     fn selection() -> String {
-        "id clientId name description developer developerUrl imageUrl".into()
+        "name rawArgs rawResult".into()
     }
 }
-/// Contains requested archived model objects.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
-pub struct ArchiveResponse {
-    /// A JSON serialized collection of model objects loaded from the archive
-    pub archive: Option<String>,
-    /// The total number of entities in the archive.
-    pub total_count: Option<f64>,
-    /// The version of the remote database. Incremented by 1 for each migration run on the database.
-    pub database_version: Option<f64>,
-    /// Whether the dependencies for the model objects are included in the archive.
-    pub includes_dependencies: Option<Vec<String>>,
+pub struct AiConversationCodeIntelligenceToolCallArgs {
+    pub question: Option<String>,
 }
-impl GraphQLFields for ArchiveResponse {
+impl GraphQLFields for AiConversationCodeIntelligenceToolCallArgs {
     type FullType = Self;
     fn selection() -> String {
-        "archive totalCount databaseVersion includesDependencies".into()
+        "question".into()
     }
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
-pub struct AsksChannelConnectPayload {
-    /// The identifier of the last sync operation.
-    pub last_sync_id: Option<f64>,
-    /// The integration that was created or updated.
-    pub integration: Option<Box<Integration>>,
-    /// Whether the operation was successful.
-    pub success: Option<bool>,
-    /// The new Asks Slack channel mapping for the connected channel.
-    pub mapping: Option<Box<SlackChannelNameMapping>>,
-    /// Whether the bot needs to be manually added to the channel.
-    pub add_bot: Option<bool>,
+pub struct AiConversationCreateEntityToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationCreateEntityToolCallArgs>,
 }
-impl GraphQLFields for AsksChannelConnectPayload {
+impl GraphQLFields for AiConversationCreateEntityToolCall {
     type FullType = Self;
     fn selection() -> String {
-        "lastSyncId success addBot".into()
+        "name rawArgs rawResult".into()
     }
 }
-/// A web page for an Asks web form.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
-pub struct AsksWebPage {
-    /// The unique identifier of the entity.
-    pub id: Option<String>,
-    /// The time at which the entity was created.
-    pub created_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
-    /// been updated after creation.
-    pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the entity was archived. Null if the entity has not been archived.
-    pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The organization that the Asks web page belongs to.
-    pub organization: Option<Box<Organization>>,
-    /// The Asks web settings this page belongs to.
-    pub asks_web_settings: Option<Box<AsksWebSettings>>,
-    /// The user who created the Asks web page.
-    pub creator: Option<Box<User>>,
-    /// The title of the page.
-    pub title: Option<String>,
-    /// The description of the page.
-    pub description: Option<String>,
-    /// The page's unique URL slug.
-    pub slug_id: Option<String>,
-    /// The auto-reply message for issue created. If not set, the default reply will be used.
-    pub issue_created_auto_reply: Option<String>,
-    /// Whether the auto-reply for issue created is enabled.
-    pub issue_created_auto_reply_enabled: Option<bool>,
-    /// The auto-reply message for issue completed. If not set, the default reply will be used.
-    pub issue_completed_auto_reply: Option<String>,
-    /// Whether the auto-reply for issue completed is enabled.
-    pub issue_completed_auto_reply_enabled: Option<bool>,
-    /// The auto-reply message for issue canceled. If not set, the default reply will be used.
-    pub issue_canceled_auto_reply: Option<String>,
-    /// Whether the auto-reply for issue canceled is enabled.
-    pub issue_canceled_auto_reply_enabled: Option<bool>,
+pub struct AiConversationCreateEntityToolCallArgs {
+    pub r#type: Option<String>,
+    pub count: Option<f64>,
 }
-impl GraphQLFields for AsksWebPage {
+impl GraphQLFields for AiConversationCreateEntityToolCallArgs {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt title description slugId issueCreatedAutoReply issueCreatedAutoReplyEnabled issueCompletedAutoReply issueCompletedAutoReplyEnabled issueCanceledAutoReply issueCanceledAutoReplyEnabled"
-            .into()
+        "type count".into()
     }
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
-pub struct AsksWebPagePayload {
-    /// The identifier of the last sync operation.
-    pub last_sync_id: Option<f64>,
-    /// The Asks web page that was created or updated.
-    pub asks_web_page: Option<Box<AsksWebPage>>,
-    /// Whether the operation was successful.
-    pub success: Option<bool>,
+pub struct AiConversationDeleteEntityToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationDeleteEntityToolCallArgs>,
 }
-impl GraphQLFields for AsksWebPagePayload {
+impl GraphQLFields for AiConversationDeleteEntityToolCall {
     type FullType = Self;
     fn selection() -> String {
-        "lastSyncId success".into()
+        "name rawArgs rawResult".into()
     }
 }
-/// Settings for an Asks web form.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
-pub struct AsksWebSettings {
-    /// The unique identifier of the entity.
+pub struct AiConversationDeleteEntityToolCallArgs {
+    pub entity: Option<AiConversationSearchEntitiesToolCallResultEntities>,
+}
+impl GraphQLFields for AiConversationDeleteEntityToolCallArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationEntityCardWidget {
+    /// The name of the widget.
+    pub name: Option<AiConversationWidgetName>,
+    /// The arguments of the widget.
+    pub raw_args: Option<serde_json::Value>,
+    /// Display information for the widget, including ProseMirror and Markdown representations.
+    pub display_info: Option<AiConversationWidgetDisplayInfo>,
+    /// The arguments to the widget.
+    pub args: Option<AiConversationEntityCardWidgetArgs>,
+}
+impl GraphQLFields for AiConversationEntityCardWidget {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationEntityCardWidgetArgs {
+    /// `Internal` The entity type
+    pub r#type: Option<AiConversationEntityCardWidgetArgsType>,
+    /// The UUID of the entity to display
     pub id: Option<String>,
-    /// The time at which the entity was created.
-    pub created_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
-    /// been updated after creation.
-    pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the entity was archived. Null if the entity has not been archived.
-    pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The organization that the Asks web settings are associated with.
-    pub organization: Option<Box<Organization>>,
-    /// The user who created the Asks web settings.
-    pub creator: Option<Box<User>>,
-    /// The custom domain for the Asks web form. If null, the default Linear-hosted domain will be used.
-    pub domain: Option<String>,
-    /// The email intake address associated with these Asks web settings.
-    pub email_intake_address: Option<Box<EmailIntakeAddress>>,
-    /// The identity provider for SAML authentication on this Asks web form.
-    pub identity_provider: Option<Box<IdentityProvider>>,
+    /// @deprecated Optional note to display about the entity
+    pub note: Option<String>,
+    /// The action performed on the entity (leave empty if just found)
+    pub action: Option<AiConversationEntityCardWidgetArgsAction>,
 }
-impl GraphQLFields for AsksWebSettings {
+impl GraphQLFields for AiConversationEntityCardWidgetArgs {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt domain".into()
+        "type id note action".into()
     }
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
-pub struct AsksWebSettingsPayload {
-    /// The identifier of the last sync operation.
-    pub last_sync_id: Option<f64>,
-    /// The Asks web settings that were created or updated.
-    pub asks_web_settings: Option<Box<AsksWebSettings>>,
-    /// Whether the operation was successful.
-    pub success: Option<bool>,
+pub struct AiConversationEntityListWidget {
+    /// The name of the widget.
+    pub name: Option<AiConversationWidgetName>,
+    /// The arguments of the widget.
+    pub raw_args: Option<serde_json::Value>,
+    /// Display information for the widget, including ProseMirror and Markdown representations.
+    pub display_info: Option<AiConversationWidgetDisplayInfo>,
+    /// The arguments to the widget.
+    pub args: Option<AiConversationEntityListWidgetArgs>,
 }
-impl GraphQLFields for AsksWebSettingsPayload {
+impl GraphQLFields for AiConversationEntityListWidget {
     type FullType = Self;
     fn selection() -> String {
-        "lastSyncId success".into()
+        "name rawArgs".into()
     }
 }
-/// Issue attachment (e.g. support ticket, pull request).
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
-pub struct Attachment {
-    /// The unique identifier of the entity.
+pub struct AiConversationEntityListWidgetArgs {
+    /// Total number of entities in the list
+    pub count: Option<f64>,
+    pub entities: Option<Vec<AiConversationEntityListWidgetArgsEntities>>,
+    /// The action performed on the entities (leave empty if just found)
+    pub action: Option<AiConversationEntityListWidgetArgsAction>,
+}
+impl GraphQLFields for AiConversationEntityListWidgetArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "count action".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationEntityListWidgetArgsEntities {
+    /// `Internal` The entity type
+    pub r#type: Option<AiConversationEntityListWidgetArgsEntitiesType>,
+    /// Entity UUID
     pub id: Option<String>,
-    /// The time at which the entity was created.
-    pub created_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
-    /// been updated after creation.
-    pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the entity was archived. Null if the entity has not been archived.
-    pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Content for the title line in the Linear attachment widget.
+    /// @deprecated Optional note to display about the entity
+    pub note: Option<String>,
+}
+impl GraphQLFields for AiConversationEntityListWidgetArgsEntities {
+    type FullType = Self;
+    fn selection() -> String {
+        "type id note".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationGetMicrosoftTeamsConversationHistoryToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+}
+impl GraphQLFields for AiConversationGetMicrosoftTeamsConversationHistoryToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationGetPullRequestDiffToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationGetPullRequestDiffToolCallArgs>,
+}
+impl GraphQLFields for AiConversationGetPullRequestDiffToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationGetPullRequestDiffToolCallArgs {
+    pub entity: Option<AiConversationSearchEntitiesToolCallResultEntities>,
+}
+impl GraphQLFields for AiConversationGetPullRequestDiffToolCallArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationGetPullRequestFileToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationGetPullRequestFileToolCallArgs>,
+}
+impl GraphQLFields for AiConversationGetPullRequestFileToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationGetPullRequestFileToolCallArgs {
+    pub entity: Option<AiConversationSearchEntitiesToolCallResultEntities>,
+    pub path: Option<String>,
+}
+impl GraphQLFields for AiConversationGetPullRequestFileToolCallArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "path".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationGetSlackConversationHistoryToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+}
+impl GraphQLFields for AiConversationGetSlackConversationHistoryToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationHandoffToCodingSessionToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationHandoffToCodingSessionToolCallArgs>,
+}
+impl GraphQLFields for AiConversationHandoffToCodingSessionToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationHandoffToCodingSessionToolCallArgs {
+    pub entity: Option<AiConversationSearchEntitiesToolCallResultEntities>,
+    pub instructions: Option<String>,
+}
+impl GraphQLFields for AiConversationHandoffToCodingSessionToolCallArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "instructions".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationInvokeMcpToolToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationInvokeMcpToolToolCallArgs>,
+}
+impl GraphQLFields for AiConversationInvokeMcpToolToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationInvokeMcpToolToolCallArgs {
+    pub server: Option<AiConversationInvokeMcpToolToolCallArgsServer>,
+    pub tool: Option<AiConversationInvokeMcpToolToolCallArgsTool>,
+}
+impl GraphQLFields for AiConversationInvokeMcpToolToolCallArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationInvokeMcpToolToolCallArgsServer {
+    pub integration_id: Option<String>,
+    pub name: Option<String>,
     pub title: Option<String>,
-    /// Content for the subtitle line in the Linear attachment widget.
-    pub subtitle: Option<String>,
-    /// Location of the attachment which is also used as an identifier.
-    pub url: Option<String>,
-    /// The creator of the attachment.
-    pub creator: Option<Box<User>>,
-    /// The non-Linear user who created the attachment.
-    pub external_user_creator: Option<Box<ExternalUser>>,
-    /// Custom metadata related to the attachment.
+}
+impl GraphQLFields for AiConversationInvokeMcpToolToolCallArgsServer {
+    type FullType = Self;
+    fn selection() -> String {
+        "integrationId name title".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationInvokeMcpToolToolCallArgsTool {
+    pub name: Option<String>,
+    pub title: Option<String>,
+}
+impl GraphQLFields for AiConversationInvokeMcpToolToolCallArgsTool {
+    type FullType = Self;
+    fn selection() -> String {
+        "name title".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationNavigateToPageToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationNavigateToPageToolCallArgs>,
+    /// The result of the tool call.
+    pub result: Option<AiConversationNavigateToPageToolCallResult>,
+}
+impl GraphQLFields for AiConversationNavigateToPageToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationNavigateToPageToolCallArgs {
+    pub entity_type: Option<String>,
+    pub identifier: Option<String>,
+}
+impl GraphQLFields for AiConversationNavigateToPageToolCallArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "entityType identifier".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationNavigateToPageToolCallResult {
+    pub url: Option<String>,
+    pub new_tab: Option<bool>,
+}
+impl GraphQLFields for AiConversationNavigateToPageToolCallResult {
+    type FullType = Self;
+    fn selection() -> String {
+        "url newTab".into()
+    }
+}
+/// Metadata about a part in an AI conversation.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationPartMetadata {
+    /// The turn ID of the part.
+    pub turn_id: Option<String>,
+    /// The eval log ID of the part.
+    pub eval_log_id: Option<String>,
+    /// The time when the part started, as an ISO 8601 string.
+    pub started_at: Option<String>,
+    /// The time when the part ended, as an ISO 8601 string.
+    pub ended_at: Option<String>,
+    /// The phase during which the part was generated.
+    pub phase: Option<AiConversationPartPhase>,
+    /// AI feedback state for this part.
+    pub feedback: Option<serde_json::Value>,
+}
+impl GraphQLFields for AiConversationPartMetadata {
+    type FullType = Self;
+    fn selection() -> String {
+        "turnId evalLogId startedAt endedAt phase feedback".into()
+    }
+}
+/// A prompt part in an AI conversation.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationPromptPart {
+    /// The ID of the part.
+    pub id: Option<String>,
+    /// The type of the part.
+    pub r#type: Option<AiConversationPartType>,
+    /// The metadata of the part.
+    pub metadata: Option<AiConversationPartMetadata>,
+    /// The data of the prompt part.
+    pub body_data: Option<serde_json::Value>,
+    /// The Markdown body of the prompt part.
+    pub body: Option<String>,
+    /// The user who created the prompt part.
+    pub user: Option<User>,
+}
+impl GraphQLFields for AiConversationPromptPart {
+    type FullType = Self;
+    fn selection() -> String {
+        "id type bodyData body".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationQueryActivityToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationQueryActivityToolCallArgs>,
+}
+impl GraphQLFields for AiConversationQueryActivityToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationQueryActivityToolCallArgs {
+    pub entities: Option<Vec<AiConversationSearchEntitiesToolCallResultEntities>>,
+}
+impl GraphQLFields for AiConversationQueryActivityToolCallArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationQueryUpdatesToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationQueryUpdatesToolCallArgs>,
+}
+impl GraphQLFields for AiConversationQueryUpdatesToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationQueryUpdatesToolCallArgs {
+    pub update_type: Option<AiConversationQueryUpdatesToolCallArgsUpdateType>,
+    pub entity: Option<AiConversationSearchEntitiesToolCallResultEntities>,
+}
+impl GraphQLFields for AiConversationQueryUpdatesToolCallArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "updateType".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationQueryViewToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationQueryViewToolCallArgs>,
+}
+impl GraphQLFields for AiConversationQueryViewToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationQueryViewToolCallArgs {
+    pub view: Option<AiConversationQueryViewToolCallArgsView>,
+    pub mode: Option<AiConversationQueryViewToolCallArgsMode>,
+    pub filter: Option<String>,
+}
+impl GraphQLFields for AiConversationQueryViewToolCallArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "mode filter".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationQueryViewToolCallArgsView {
+    pub r#type: Option<String>,
+    pub group: Option<AiConversationSearchEntitiesToolCallResultEntities>,
+    pub predefined_view: Option<String>,
+}
+impl GraphQLFields for AiConversationQueryViewToolCallArgsView {
+    type FullType = Self;
+    fn selection() -> String {
+        "type predefinedView".into()
+    }
+}
+/// A reasoning part in an AI conversation.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationReasoningPart {
+    /// The ID of the part.
+    pub id: Option<String>,
+    /// The type of the part.
+    pub r#type: Option<AiConversationPartType>,
+    /// The metadata of the part.
+    pub metadata: Option<AiConversationPartMetadata>,
+    /// The title of the reasoning part.
+    pub title: Option<String>,
+    /// The data of the reasoning part.
+    pub body_data: Option<serde_json::Value>,
+    /// The Markdown body of the reasoning part.
+    pub body: Option<String>,
+}
+impl GraphQLFields for AiConversationReasoningPart {
+    type FullType = Self;
+    fn selection() -> String {
+        "id type title bodyData body".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationResearchToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationResearchToolCallArgs>,
+    /// The result of the tool call.
+    pub result: Option<AiConversationResearchToolCallResult>,
+}
+impl GraphQLFields for AiConversationResearchToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationResearchToolCallArgs {
+    pub context: Option<String>,
+    pub query: Option<String>,
+    pub subjects: Option<Vec<AiConversationSearchEntitiesToolCallResultEntities>>,
+}
+impl GraphQLFields for AiConversationResearchToolCallArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "context query".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationResearchToolCallResult {
+    pub progress_id: Option<String>,
+}
+impl GraphQLFields for AiConversationResearchToolCallResult {
+    type FullType = Self;
+    fn selection() -> String {
+        "progressId".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationRestoreEntityToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationRestoreEntityToolCallArgs>,
+}
+impl GraphQLFields for AiConversationRestoreEntityToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationRestoreEntityToolCallArgs {
+    pub entity: Option<AiConversationSearchEntitiesToolCallResultEntities>,
+}
+impl GraphQLFields for AiConversationRestoreEntityToolCallArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationRetrieveEntitiesToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationRetrieveEntitiesToolCallArgs>,
+}
+impl GraphQLFields for AiConversationRetrieveEntitiesToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationRetrieveEntitiesToolCallArgs {
+    pub entities: Option<Vec<AiConversationSearchEntitiesToolCallResultEntities>>,
+}
+impl GraphQLFields for AiConversationRetrieveEntitiesToolCallArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationSearchDocumentationToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+}
+impl GraphQLFields for AiConversationSearchDocumentationToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationSearchEntitiesToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationSearchEntitiesToolCallArgs>,
+    /// The result of the tool call.
+    pub result: Option<AiConversationSearchEntitiesToolCallResult>,
+}
+impl GraphQLFields for AiConversationSearchEntitiesToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationSearchEntitiesToolCallArgs {
+    pub r#type: Option<String>,
+    pub queries: Option<Vec<String>>,
+}
+impl GraphQLFields for AiConversationSearchEntitiesToolCallArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "type queries".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationSearchEntitiesToolCallResult {
+    pub entities: Option<Vec<AiConversationSearchEntitiesToolCallResultEntities>>,
+}
+impl GraphQLFields for AiConversationSearchEntitiesToolCallResult {
+    type FullType = Self;
+    fn selection() -> String {
+        "".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationSearchEntitiesToolCallResultEntities {
+    pub r#type: Option<String>,
+    pub id: Option<String>,
+}
+impl GraphQLFields for AiConversationSearchEntitiesToolCallResultEntities {
+    type FullType = Self;
+    fn selection() -> String {
+        "type id".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationSuggestValuesToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationSuggestValuesToolCallArgs>,
+}
+impl GraphQLFields for AiConversationSuggestValuesToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationSuggestValuesToolCallArgs {
+    pub field: Option<String>,
+    pub query: Option<String>,
+}
+impl GraphQLFields for AiConversationSuggestValuesToolCallArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "field query".into()
+    }
+}
+/// A text part in an AI conversation.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationTextPart {
+    /// The ID of the part.
+    pub id: Option<String>,
+    /// The type of the part.
+    pub r#type: Option<AiConversationPartType>,
+    /// The metadata of the part.
+    pub metadata: Option<AiConversationPartMetadata>,
+    /// The data of the text part.
+    pub body_data: Option<serde_json::Value>,
+    /// The Markdown body of the text part.
+    pub body: Option<String>,
+}
+impl GraphQLFields for AiConversationTextPart {
+    type FullType = Self;
+    fn selection() -> String {
+        "id type bodyData body".into()
+    }
+}
+/// A tool call part in an AI conversation.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationToolCallPart {
+    /// The ID of the part.
+    pub id: Option<String>,
+    /// The type of the part.
+    pub r#type: Option<AiConversationPartType>,
+    /// The metadata of the part.
+    pub metadata: Option<AiConversationPartMetadata>,
+}
+impl GraphQLFields for AiConversationToolCallPart {
+    type FullType = Self;
+    fn selection() -> String {
+        "id type".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationToolDisplayInfo {
+    pub icon: Option<String>,
+    pub active_label: Option<String>,
+    pub inactive_label: Option<String>,
+    pub detail: Option<String>,
+    pub result: Option<String>,
+}
+impl GraphQLFields for AiConversationToolDisplayInfo {
+    type FullType = Self;
+    fn selection() -> String {
+        "icon activeLabel inactiveLabel detail result".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationTranscribeMediaToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+}
+impl GraphQLFields for AiConversationTranscribeMediaToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationTranscribeVideoToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+}
+impl GraphQLFields for AiConversationTranscribeVideoToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationUpdateEntityToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationUpdateEntityToolCallArgs>,
+}
+impl GraphQLFields for AiConversationUpdateEntityToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationUpdateEntityToolCallArgs {
+    pub entity: Option<AiConversationSearchEntitiesToolCallResultEntities>,
+    pub entities: Option<Vec<AiConversationSearchEntitiesToolCallResultEntities>>,
+}
+impl GraphQLFields for AiConversationUpdateEntityToolCallArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationWebSearchToolCall {
+    /// The name of the tool that was called.
+    pub name: Option<AiConversationTool>,
+    pub display_info: Option<AiConversationToolDisplayInfo>,
+    /// The arguments of the tool call.
+    pub raw_args: Option<serde_json::Value>,
+    /// The result of the tool call.
+    pub raw_result: Option<serde_json::Value>,
+    /// The arguments to the tool call.
+    pub args: Option<AiConversationWebSearchToolCallArgs>,
+}
+impl GraphQLFields for AiConversationWebSearchToolCall {
+    type FullType = Self;
+    fn selection() -> String {
+        "name rawArgs rawResult".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationWebSearchToolCallArgs {
+    pub query: Option<String>,
+    pub url: Option<String>,
+}
+impl GraphQLFields for AiConversationWebSearchToolCallArgs {
+    type FullType = Self;
+    fn selection() -> String {
+        "query url".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationWidgetDisplayInfo {
+    /// The ProseMirror data representation of the widget content.
+    pub body_data: Option<serde_json::Value>,
+    /// The Markdown representation of the widget content.
+    pub body: Option<String>,
+}
+impl GraphQLFields for AiConversationWidgetDisplayInfo {
+    type FullType = Self;
+    fn selection() -> String {
+        "bodyData body".into()
+    }
+}
+/// A widget part in an AI conversation.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiConversationWidgetPart {
+    /// The ID of the part.
+    pub id: Option<String>,
+    /// The type of the part.
+    pub r#type: Option<AiConversationPartType>,
+    /// The metadata of the part.
+    pub metadata: Option<AiConversationPartMetadata>,
+}
+impl GraphQLFields for AiConversationWidgetPart {
+    type FullType = Self;
+    fn selection() -> String {
+        "id type".into()
+    }
+}
+/// `Internal` Tracks the progress and state of an AI prompt workflow execution. Each progress record is associated with an issue or comment and contains the workflow type, current status, metadata about the execution, and optionally the conversation messages exchanged during the workflow. Progress records can form a hierarchy via parent-child relationships for multi-step workflows.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiPromptProgress {
+    /// The unique identifier of the entity.
+    pub id: Option<String>,
+    /// The time at which the entity was created.
+    pub created_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
+    /// been updated after creation.
+    pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The time at which the entity was archived. Null if the entity has not been archived.
+    pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// `Internal` The type of AI prompt workflow.
+    pub r#type: Option<AiPromptType>,
+    /// `Internal` The status of the prompt workflow.
+    pub status: Option<AiPromptProgressStatus>,
+    /// `Internal` The metadata for the prompt workflow.
+    pub metadata: Option<serde_json::Value>,
+    /// `Internal` The log ID for the prompt workflow, if available.
+    pub log_id: Option<String>,
+}
+impl GraphQLFields for AiPromptProgress {
+    type FullType = Self;
+    fn selection() -> String {
+        "id createdAt updatedAt archivedAt type status metadata logId".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiPromptProgressConnection {
+    pub edges: Option<Vec<AiPromptProgressEdge>>,
+    pub nodes: Option<Vec<AiPromptProgress>>,
+    pub page_info: Option<PageInfo>,
+}
+impl GraphQLFields for AiPromptProgressConnection {
+    type FullType = Self;
+    fn selection() -> String {
+        "".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiPromptProgressEdge {
+    pub node: Option<AiPromptProgress>,
+    /// Used in `before` and `after` args
+    pub cursor: Option<String>,
+}
+impl GraphQLFields for AiPromptProgressEdge {
+    type FullType = Self;
+    fn selection() -> String {
+        "cursor".into()
+    }
+}
+/// Custom rules that guide AI behavior for a specific scope. Rules can be defined at the workspace level, team level, integration level, or user level, and are applied hierarchically (workspace rules first, then parent team rules, then team rules). Rules contain structured content that instructs the AI assistant on how to handle specific types of prompts, such as coding agent guidance or triage intelligence configuration.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AiPromptRules {
+    /// The unique identifier of the entity.
+    pub id: Option<String>,
+    /// The time at which the entity was created.
+    pub created_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
+    /// been updated after creation.
+    pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The time at which the entity was archived. Null if the entity has not been archived.
+    pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The user who last updated the AI prompt rules.
+    pub updated_by: Option<Box<User>>,
+}
+impl GraphQLFields for AiPromptRules {
+    type FullType = Self;
+    fn selection() -> String {
+        "id createdAt updatedAt archivedAt".into()
+    }
+}
+/// Public-facing information about an OAuth application. Contains only the fields that are safe to display to users during the authorization flow, excluding sensitive data like client secrets and internal configuration.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct Application {
+    /// OAuth application's ID.
+    pub id: Option<String>,
+    /// OAuth application's client ID.
+    pub client_id: Option<String>,
+    /// Application name.
+    pub name: Option<String>,
+    /// Information about the application.
+    pub description: Option<String>,
+    /// Name of the developer.
+    pub developer: Option<String>,
+    /// URL of the developer's website, homepage, or documentation.
+    pub developer_url: Option<String>,
+    /// Image of the application.
+    pub image_url: Option<String>,
+}
+impl GraphQLFields for Application {
+    type FullType = Self;
+    fn selection() -> String {
+        "id clientId name description developer developerUrl imageUrl".into()
+    }
+}
+/// Contains requested archived model objects.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct ArchiveResponse {
+    /// A JSON serialized collection of model objects loaded from the archive
+    pub archive: Option<String>,
+    /// The total number of entities in the archive.
+    pub total_count: Option<f64>,
+    /// The version of the remote database. Incremented by 1 for each migration run on the database.
+    pub database_version: Option<f64>,
+    /// Whether the dependencies for the model objects are included in the archive.
+    pub includes_dependencies: Option<Vec<String>>,
+}
+impl GraphQLFields for ArchiveResponse {
+    type FullType = Self;
+    fn selection() -> String {
+        "archive totalCount databaseVersion includesDependencies".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct AsksChannelConnectPayload {
+    /// The identifier of the last sync operation.
+    pub last_sync_id: Option<f64>,
+    /// The integration that was created or updated.
+    pub integration: Option<Integration>,
+    /// Whether the operation was successful.
+    pub success: Option<bool>,
+    /// The new Asks Slack channel mapping for the connected channel.
+    pub mapping: Option<SlackChannelNameMapping>,
+    /// Whether the bot needs to be manually added to the channel.
+    pub add_bot: Option<bool>,
+}
+impl GraphQLFields for AsksChannelConnectPayload {
+    type FullType = Self;
+    fn selection() -> String {
+        "lastSyncId success addBot".into()
+    }
+}
+/// An attachment linking external content to an issue. Attachments represent connections to external resources such as GitHub pull requests, Slack messages, Zendesk tickets, Figma files, Sentry issues, Intercom conversations, and plain URLs. Each attachment has a title and subtitle displayed in the Linear UI, a URL serving as both the link destination and unique identifier per issue, and optional metadata specific to the source integration.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct Attachment {
+    /// The unique identifier of the entity.
+    pub id: Option<String>,
+    /// The time at which the entity was created.
+    pub created_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
+    /// been updated after creation.
+    pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The time at which the entity was archived. Null if the entity has not been archived.
+    pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// Content for the title line in the Linear attachment widget.
+    pub title: Option<String>,
+    /// Content for the subtitle line in the Linear attachment widget.
+    pub subtitle: Option<String>,
+    /// The URL of the external resource this attachment links to. Also serves as a unique identifier for the attachment within an issue; no two attachments on the same issue can share the same URL.
+    pub url: Option<String>,
+    /// The creator of the attachment.
+    pub creator: Option<User>,
+    /// The non-Linear user who created the attachment.
+    pub external_user_creator: Option<ExternalUser>,
+    /// Integration-specific metadata for this attachment. The schema varies by source type and may include fields such as pull request status, review counts, commit information, ticket status, or other data from the external system.
     pub metadata: Option<serde_json::Value>,
     /// Information about the source which created the attachment.
     pub source: Option<serde_json::Value>,
-    /// An accessor helper to source.type, defines the source type of the attachment.
+    /// The source type of the attachment, derived from the source metadata. Returns the integration type (e.g., 'github', 'slack', 'zendesk') or 'unknown' if no source is set.
     pub source_type: Option<String>,
-    /// Indicates if attachments for the same source application should be grouped in the Linear UI.
+    /// Whether attachments from the same source application should be visually grouped together in the Linear issue detail view.
     pub group_by_source: Option<bool>,
-    /// The issue this attachment was originally created on. Will be undefined if the attachment hasn't been moved.
-    pub original_issue: Option<Box<Issue>>,
+    /// The issue this attachment was originally created on. Null if the attachment hasn't been moved.
+    pub original_issue: Option<Issue>,
     /// The issue this attachment belongs to.
-    pub issue: Option<Box<Issue>>,
+    pub issue: Option<Issue>,
     /// The body data of the attachment, if any.
     pub body_data: Option<String>,
 }
@@ -650,9 +1581,9 @@ impl GraphQLFields for Attachment {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AttachmentConnection {
-    pub edges: Option<Box<Vec<AttachmentEdge>>>,
-    pub nodes: Option<Box<Vec<Attachment>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<AttachmentEdge>>,
+    pub nodes: Option<Vec<Attachment>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for AttachmentConnection {
     type FullType = Self;
@@ -663,7 +1594,7 @@ impl GraphQLFields for AttachmentConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AttachmentEdge {
-    pub node: Option<Box<Attachment>>,
+    pub node: Option<Attachment>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -673,13 +1604,14 @@ impl GraphQLFields for AttachmentEdge {
         "cursor".into()
     }
 }
+/// The result of an attachment mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AttachmentPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The issue attachment that was created.
-    pub attachment: Option<Box<Attachment>>,
+    pub attachment: Option<Attachment>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -689,6 +1621,7 @@ impl GraphQLFields for AttachmentPayload {
         "lastSyncId success".into()
     }
 }
+/// The result of an attachment sources query.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AttachmentSourcesPayload {
@@ -701,7 +1634,7 @@ impl GraphQLFields for AttachmentSourcesPayload {
         "sources".into()
     }
 }
-/// Workspace audit log entry object.
+/// A workspace audit log entry recording a security or compliance-relevant action. Audit entries capture who performed an action, when, from what IP address and country, and include type-specific metadata. The audit log is partitioned by time for performance and is accessible only to workspace administrators. Examples of audited actions include user authentication events, permission changes, data exports, and workspace setting modifications.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AuditEntry {
@@ -714,16 +1647,17 @@ pub struct AuditEntry {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The type of audited action (e.g., user authentication, permission change, data export, setting modification).
     pub r#type: Option<String>,
-    /// The organization the audit log belongs to.
-    pub organization: Option<Box<Organization>>,
+    /// The workspace the audit log belongs to.
+    pub organization: Option<Organization>,
     /// The user that caused the audit entry to be created.
-    pub actor: Option<Box<User>>,
+    pub actor: Option<User>,
     /// The ID of the user that caused the audit entry to be created.
     pub actor_id: Option<String>,
-    /// IP from actor when entry was recorded.
+    /// The IP address of the actor at the time the audited action was performed. Null if the IP was not captured.
     pub ip: Option<String>,
-    /// Country code of request resulting to audit entry.
+    /// The ISO 3166-1 alpha-2 country code derived from the request IP address. Null if geo-location could not be determined.
     pub country_code: Option<String>,
     /// Additional metadata related to the audit entry.
     pub metadata: Option<serde_json::Value>,
@@ -740,9 +1674,9 @@ impl GraphQLFields for AuditEntry {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AuditEntryConnection {
-    pub edges: Option<Box<Vec<AuditEntryEdge>>>,
-    pub nodes: Option<Box<Vec<AuditEntry>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<AuditEntryEdge>>,
+    pub nodes: Option<Vec<AuditEntry>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for AuditEntryConnection {
     type FullType = Self;
@@ -753,7 +1687,7 @@ impl GraphQLFields for AuditEntryConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AuditEntryEdge {
-    pub node: Option<Box<AuditEntry>>,
+    pub node: Option<AuditEntry>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -843,12 +1777,16 @@ pub struct AuthOrganization {
     pub saml_settings: Option<serde_json::Value>,
     /// Allowed authentication providers, empty array means all are allowed
     pub allowed_auth_services: Option<Vec<String>>,
+    /// Authentication settings for the organization.
+    pub auth_settings: Option<serde_json::Value>,
     /// Whether SCIM provisioning is enabled for organization.
     pub scim_enabled: Option<bool>,
     /// The email domain or URL key for the organization.
     pub service_id: Option<String>,
     /// The region the organization is hosted in.
     pub region: Option<String>,
+    /// An approximate count of users, updated once per day.
+    pub approximate_user_count: Option<f64>,
     /// Whether to hide other organizations for new users signing up with email domains claimed by this organization.
     pub hide_non_primary_organizations: Option<bool>,
     pub user_count: Option<f64>,
@@ -856,7 +1794,7 @@ pub struct AuthOrganization {
 impl GraphQLFields for AuthOrganization {
     type FullType = Self;
     fn selection() -> String {
-        "createdAt id name enabled urlKey previousUrlKeys logoUrl deletionRequestedAt releaseChannel samlEnabled samlSettings allowedAuthServices scimEnabled serviceId region hideNonPrimaryOrganizations userCount"
+        "createdAt id name enabled urlKey previousUrlKeys logoUrl deletionRequestedAt releaseChannel samlEnabled samlSettings allowedAuthServices authSettings scimEnabled serviceId region approximateUserCount hideNonPrimaryOrganizations userCount"
             .into()
     }
 }
@@ -870,13 +1808,13 @@ pub struct AuthResolverResponse {
     /// Should the signup flow allow access for the domain.
     pub allow_domain_access: Option<bool>,
     /// List of active users that belong to the user account.
-    pub users: Option<Box<Vec<AuthUser>>>,
+    pub users: Option<Vec<AuthUser>>,
     /// List of locked users that are locked by login restrictions
-    pub locked_users: Option<Box<Vec<AuthUser>>>,
+    pub locked_users: Option<Vec<AuthUser>>,
     /// List of organizations allowing this user account to join automatically.
-    pub available_organizations: Option<Box<Vec<AuthOrganization>>>,
+    pub available_organizations: Option<Vec<AuthOrganization>>,
     /// List of organization available to this user account but locked due to the current auth method.
-    pub locked_organizations: Option<Box<Vec<AuthOrganization>>>,
+    pub locked_organizations: Option<Vec<AuthOrganization>>,
     /// ID of the organization last accessed by the user.
     pub last_used_organization_id: Option<String>,
     /// The authentication service used for the current session (e.g., google, email, saml).
@@ -912,9 +1850,9 @@ pub struct AuthUser {
     /// User account ID the user belongs to.
     pub user_account_id: Option<String>,
     /// Organization the user belongs to.
-    pub organization: Option<Box<AuthOrganization>>,
+    pub organization: Option<AuthOrganization>,
     /// `INTERNAL` Identity provider the user is managed by.
-    pub identity_provider: Option<Box<AuthIdentityProvider>>,
+    pub identity_provider: Option<AuthIdentityProvider>,
 }
 impl GraphQLFields for AuthUser {
     type FullType = Self;
@@ -922,7 +1860,7 @@ impl GraphQLFields for AuthUser {
         "createdAt id name displayName email avatarUrl role active userAccountId".into()
     }
 }
-/// Authentication session information.
+/// Information about an active authentication session, including the device, location, and timestamps for when it was created and last used.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct AuthenticationSessionResponse {
@@ -961,17 +1899,72 @@ pub struct AuthenticationSessionResponse {
     pub client: Option<String>,
     /// Name of the session, derived from the client and operating system
     pub name: Option<String>,
-    /// Identifies the session used to make the request.
+    /// Detailed name of the session including version information, derived from the user agent.
+    pub detailed_name: Option<String>,
+    /// Whether this session is the one used to make the current API request.
     pub is_current_session: Option<bool>,
 }
 impl GraphQLFields for AuthenticationSessionResponse {
     type FullType = Self;
     fn selection() -> String {
-        "createdAt id type ip locationCountry locationCountryCode countryCodes locationRegionCode locationCity userAgent browserType service lastActiveAt updatedAt location operatingSystem client name isCurrentSession"
+        "createdAt id type ip locationCountry locationCountryCode countryCodes locationRegionCode locationCity userAgent browserType service lastActiveAt updatedAt location operatingSystem client name detailedName isCurrentSession"
+            .into()
+    }
+}
+/// `Internal` Detailed information about the coding agent sandbox environment associated with an agent session, including cloud infrastructure URLs for debugging and monitoring.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct CodingAgentSandboxEntry {
+    /// The sandbox identifier.
+    pub id: Option<String>,
+    /// The user who initiated the session.
+    pub creator_id: Option<String>,
+    /// The URL of the running sandbox environment. Null when the sandbox is hibernated or destroyed.
+    pub sandbox_url: Option<String>,
+    /// URL to the sandbox execution logs in Modal. Null if the sandbox has no URL or is not running on Modal.
+    pub sandbox_logs_url: Option<String>,
+    /// The Claude Agent SDK session ID used for resuming multi-turn conversations with the sandbox worker.
+    pub worker_conversation_id: Option<String>,
+    /// GitHub repository in owner/repo format.
+    pub repository: Option<String>,
+    /// The Git branch name created for this sandbox session. Null if a branch has not yet been assigned.
+    pub branch_name: Option<String>,
+    /// The Git ref (branch, tag, or commit) that was checked out as the base for this sandbox. Defaults to the repository's default branch.
+    pub base_ref: Option<String>,
+    /// The time at which the sandbox was created.
+    pub created_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The time at which the sandbox first became active. Null if not yet started.
+    pub started_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The time at which the session reached a terminal state. Null if still active.
+    pub ended_at: Option<chrono::DateTime<chrono::Utc>>,
+}
+impl GraphQLFields for CodingAgentSandboxEntry {
+    type FullType = Self;
+    fn selection() -> String {
+        "id creatorId sandboxUrl sandboxLogsUrl workerConversationId repository branchName baseRef createdAt startedAt endedAt"
             .into()
     }
 }
-/// A comment associated with an issue.
+/// `Internal` Coding agent sandbox details for an agent session.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct CodingAgentSandboxPayload {
+    /// The agent session identifier.
+    pub agent_session_id: Option<String>,
+    /// All sandbox containers for this session, oldest first.
+    pub sandboxes: Option<Vec<CodingAgentSandboxEntry>>,
+    /// Datadog logs URL covering all sandboxes in the session.
+    pub datadog_logs_url: Option<String>,
+    /// Temporal URL to view workflows for this session.
+    pub temporal_workflows_url: Option<String>,
+}
+impl GraphQLFields for CodingAgentSandboxPayload {
+    type FullType = Self;
+    fn selection() -> String {
+        "agentSessionId datadogLogsUrl temporalWorkflowsUrl".into()
+    }
+}
+/// A comment associated with an issue, project update, initiative update, document content, post, project, or initiative. Comments support rich text (ProseMirror), emoji reactions, and threaded replies via parentId. Comments can be created by workspace users or by external users through integrations (e.g., Slack, Intercom). Each comment belongs to exactly one parent entity.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Comment {
@@ -984,90 +1977,102 @@ pub struct Comment {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The comment content in markdown format.
+    /// The comment content in markdown format. This is a derived representation of the canonical bodyData ProseMirror content.
     pub body: Option<String>,
-    /// The issue that the comment is associated with.
+    /// The issue that the comment is associated with. Null if the comment belongs to a different parent entity type.
     pub issue: Option<Box<Issue>>,
-    /// The ID of the issue that the comment is associated with.
+    /// The ID of the issue that the comment is associated with. Null if the comment belongs to a different parent entity type.
     pub issue_id: Option<String>,
-    /// The document content that the comment is associated with.
+    /// The document content that the comment is associated with. Null if the comment belongs to a different parent entity type. Used for inline comments on documents.
     pub document_content: Option<Box<DocumentContent>>,
-    /// The ID of the document content that the comment is associated with.
+    /// The ID of the document content that the comment is associated with. Null if the comment belongs to a different parent entity type.
     pub document_content_id: Option<String>,
-    /// The project update that the comment is associated with.
+    /// The project update that the comment is associated with. Null if the comment belongs to a different parent entity type.
     pub project_update: Option<Box<ProjectUpdate>>,
-    /// The ID of the project update that the comment is associated with.
+    /// The ID of the project update that the comment is associated with. Null if the comment belongs to a different parent entity type.
     pub project_update_id: Option<String>,
-    /// The initiative update that the comment is associated with.
+    /// The initiative update that the comment is associated with. Null if the comment belongs to a different parent entity type.
     pub initiative_update: Option<Box<InitiativeUpdate>>,
-    /// The ID of the initiative update that the comment is associated with.
+    /// The ID of the initiative update that the comment is associated with. Null if the comment belongs to a different parent entity type.
     pub initiative_update_id: Option<String>,
-    /// The post that the comment is associated with.
+    /// The post that the comment is associated with. Null if the comment belongs to a different parent entity type.
     pub post: Option<Box<Post>>,
-    /// The parent comment under which the current comment is nested.
+    /// `Internal` The project that the comment is associated with. Used for project-level discussion threads. Null if the comment belongs to a different parent entity type.
+    pub project: Option<Box<Project>>,
+    /// `Internal` The ID of the project that the comment is associated with. Null if the comment belongs to a different parent entity type.
+    pub project_id: Option<String>,
+    /// `Internal` The initiative that the comment is associated with. Null if the comment belongs to a different parent entity type.
+    pub initiative: Option<Box<Initiative>>,
+    /// `Internal` The ID of the initiative that the comment is associated with. Null if the comment belongs to a different parent entity type.
+    pub initiative_id: Option<String>,
+    /// The parent comment under which the current comment is nested. Null for top-level comments that are not replies.
     pub parent: Option<Box<Comment>>,
-    /// The ID of the parent comment under which the current comment is nested.
+    /// The ID of the parent comment under which the current comment is nested. Null for top-level comments.
     pub parent_id: Option<String>,
-    /// The user that resolved the thread.
+    /// The user that resolved the comment thread. Null if the thread has not been resolved or if this is not a top-level comment.
     pub resolving_user: Option<Box<User>>,
-    /// The time the resolvingUser resolved the thread.
+    /// The time when the comment thread was resolved. Null if the thread is unresolved.
     pub resolved_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The comment that resolved the thread.
+    /// The child comment that resolved this thread. Only set on top-level (parent) comments. Null if the thread is unresolved.
     pub resolving_comment: Option<Box<Comment>>,
-    /// The ID of the comment that resolved the thread.
+    /// The ID of the child comment that resolved this thread. Null if the thread is unresolved.
     pub resolving_comment_id: Option<String>,
-    /// The user who wrote the comment.
+    /// The user who wrote the comment. Null for comments created by integrations or bots without a user association.
     pub user: Option<Box<User>>,
-    /// The external user who wrote the comment.
+    /// The external user who wrote the comment, when the comment was created through an integration such as Slack or Intercom. Null for comments created by workspace users.
     pub external_user: Option<Box<ExternalUser>>,
-    /// The time user edited the comment.
+    /// The time the comment was last edited by its author. Null if the comment has not been edited since creation.
     pub edited_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// `Internal` The comment content as a Prosemirror document.
+    /// `Internal` The comment content as a ProseMirror document. This is the canonical rich-text representation of the comment body.
     pub body_data: Option<String>,
-    /// The text that this comment references. Only defined for inline comments.
+    /// The text that this comment references, used for inline comments on documents or issue descriptions. Null for standard comments that do not quote specific text.
     pub quoted_text: Option<String>,
-    /// Emoji reaction summary, grouped by emoji type.
+    /// Emoji reaction summary for this comment, grouped by emoji type. Each entry contains the emoji name, count, and the IDs of users who reacted.
     pub reaction_data: Option<serde_json::Value>,
-    /// `Internal` A generated summary of the comment thread.
+    /// `Internal` An AI-generated summary of the comment thread. Null if no summary has been generated or if this is not a top-level comment.
     pub thread_summary: Option<serde_json::Value>,
     /// `Internal` Whether the comment is an artificial placeholder for an agent session thread created without a comment mention.
     pub is_artificial_agent_session_root: Option<bool>,
     /// Comment's URL.
     pub url: Option<String>,
     /// The children of the comment.
-    pub children: Option<Box<CommentConnection>>,
+    pub children: Option<CommentConnection>,
     /// Agent session associated with this comment.
     pub agent_session: Option<Box<AgentSession>>,
     /// `Internal` Agent sessions associated with this comment.
-    pub agent_sessions: Option<Box<AgentSessionConnection>>,
+    pub agent_sessions: Option<AgentSessionConnection>,
+    /// `Internal` Agent sessions spawned from this comment.
+    pub spawned_agent_sessions: Option<AgentSessionConnection>,
+    /// `Internal` AI prompt progresses associated with this comment.
+    pub ai_prompt_progresses: Option<AiPromptProgressConnection>,
     /// Issues created from this comment.
-    pub created_issues: Option<Box<IssueConnection>>,
+    pub created_issues: Option<IssueConnection>,
     /// The bot that created the comment.
-    pub bot_actor: Option<Box<ActorBot>>,
+    pub bot_actor: Option<ActorBot>,
     /// `Internal` The user on whose behalf the comment was created, e.g. when the Linear assistant creates a comment for a user.
     pub on_behalf_of: Option<Box<User>>,
     /// The external thread that the comment is synced with.
-    pub external_thread: Option<Box<SyncedExternalThread>>,
+    pub external_thread: Option<SyncedExternalThread>,
     /// `Internal` Whether the comment should be hidden from Linear clients. This is typically used for bot comments that provide redundant information (e.g., Slack Asks confirmation messages).
     pub hide_in_linear: Option<bool>,
     /// Reactions associated with the comment.
-    pub reactions: Option<Box<Vec<Reaction>>>,
+    pub reactions: Option<Vec<Reaction>>,
     /// The external services the comment is synced with.
-    pub synced_with: Option<Box<Vec<ExternalEntityInfo>>>,
+    pub synced_with: Option<Vec<ExternalEntityInfo>>,
 }
 impl GraphQLFields for Comment {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt body issueId documentContentId projectUpdateId initiativeUpdateId parentId resolvedAt resolvingCommentId editedAt bodyData quotedText reactionData threadSummary isArtificialAgentSessionRoot url hideInLinear"
+        "id createdAt updatedAt archivedAt body issueId documentContentId projectUpdateId initiativeUpdateId projectId initiativeId parentId resolvedAt resolvingCommentId editedAt bodyData quotedText reactionData threadSummary isArtificialAgentSessionRoot url hideInLinear"
             .into()
     }
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CommentConnection {
-    pub edges: Option<Box<Vec<CommentEdge>>>,
-    pub nodes: Option<Box<Vec<Comment>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<CommentEdge>>,
+    pub nodes: Option<Vec<Comment>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for CommentConnection {
     type FullType = Self;
@@ -1078,7 +2083,7 @@ impl GraphQLFields for CommentConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CommentEdge {
-    pub node: Option<Box<Comment>>,
+    pub node: Option<Comment>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -1088,13 +2093,14 @@ impl GraphQLFields for CommentEdge {
         "cursor".into()
     }
 }
+/// The result of a comment mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CommentPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The comment that was created or updated.
-    pub comment: Option<Box<Comment>>,
+    pub comment: Option<Comment>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -1104,6 +2110,7 @@ impl GraphQLFields for CommentPayload {
         "lastSyncId success".into()
     }
 }
+/// Return type for contact mutations.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ContactPayload {
@@ -1116,6 +2123,7 @@ impl GraphQLFields for ContactPayload {
         "success".into()
     }
 }
+/// The payload returned by the createCsvExportReport mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CreateCsvExportReportPayload {
@@ -1128,11 +2136,14 @@ impl GraphQLFields for CreateCsvExportReportPayload {
         "success".into()
     }
 }
+/// `INTERNAL` Response from creating or joining a workspace.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CreateOrJoinOrganizationResponse {
-    pub organization: Option<Box<AuthOrganization>>,
-    pub user: Option<Box<AuthUser>>,
+    /// The workspace that was created or joined.
+    pub organization: Option<AuthOrganization>,
+    /// The user who created or joined the workspace.
+    pub user: Option<AuthUser>,
 }
 impl GraphQLFields for CreateOrJoinOrganizationResponse {
     type FullType = Self;
@@ -1140,7 +2151,7 @@ impl GraphQLFields for CreateOrJoinOrganizationResponse {
         "".into()
     }
 }
-/// A custom view that has been saved by a user.
+/// A custom view built from a saved filter, sort, and grouping configuration. Views can be personal (visible only to the owner) or shared with the entire workspace. They define which issues, projects, initiatives, or feed items are displayed and how they are organized. Views can optionally be scoped to a team, project, or initiative.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomView {
@@ -1153,56 +2164,56 @@ pub struct CustomView {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The name of the custom view.
+    /// The name of the custom view, displayed in the sidebar and navigation.
     pub name: Option<String>,
     /// The description of the custom view.
     pub description: Option<String>,
-    /// The icon of the custom view.
+    /// The icon of the custom view. Can be an emoji or a decorative icon identifier.
     pub icon: Option<String>,
-    /// The color of the icon of the custom view.
+    /// The hex color code of the custom view icon.
     pub color: Option<String>,
-    /// The organization of the custom view.
+    /// The workspace of the custom view.
     pub organization: Option<Box<Organization>>,
-    /// The user who created the custom view.
+    /// The user who originally created the custom view.
     pub creator: Option<Box<User>>,
-    /// The user who owns the custom view.
+    /// The user who owns the custom view. For personal views, only the owner can see and edit the view.
     pub owner: Option<Box<User>>,
-    /// The user who last updated the custom view.
+    /// The user who last updated the custom view. Null if the updater's account has been deleted.
     pub updated_by: Option<Box<User>>,
-    /// The filters applied to issues in the custom view.
+    /// The legacy serialized filters applied to issues in the custom view.
     pub filters: Option<serde_json::Value>,
-    /// The filter applied to issues in the custom view.
+    /// The structured filter applied to issues in the custom view. Used when the view's modelName is "Issue".
     pub filter_data: Option<serde_json::Value>,
-    /// The filter applied to projects in the custom view.
+    /// The filter applied to projects in the custom view. When set, this view displays projects instead of issues.
     pub project_filter_data: Option<serde_json::Value>,
-    /// The filter applied to initiatives in the custom view.
+    /// The filter applied to initiatives in the custom view. When set, this view displays initiatives instead of issues.
     pub initiative_filter_data: Option<serde_json::Value>,
-    /// The filter applied to feed items in the custom view.
+    /// The filter applied to feed items in the custom view. When set, this view displays feed items (updates) instead of issues.
     pub feed_item_filter_data: Option<serde_json::Value>,
-    /// Whether the custom view is shared with everyone in the organization.
+    /// Whether the custom view is shared with everyone in the organization. Shared views appear in the workspace sidebar for all members. Personal (non-shared) views are only visible to their owner.
     pub shared: Option<bool>,
-    /// The custom view's unique URL slug.
+    /// The custom view's unique URL slug, used to construct human-readable URLs. Automatically generated on creation.
     pub slug_id: Option<String>,
-    /// The model name of the custom view.
+    /// The entity type this view displays. Determined by which filter is set: "Project" if projectFilterData is set, "Initiative" if initiativeFilterData is set, "FeedItem" if feedItemFilterData is set, or "Issue" by default.
     pub model_name: Option<String>,
-    /// `INTERNAL` The facet associated with the custom view.
+    /// `INTERNAL` The facet that links this custom view to its parent entity (project, initiative, team page, etc.). Null if the view is not attached to any parent via a facet.
     pub facet: Option<Box<Facet>>,
-    /// The team associated with the custom view.
+    /// The team that the custom view is scoped to. Null if the view is workspace-wide or scoped to a project/initiative instead.
     pub team: Option<Box<Team>>,
-    /// Projects associated with the custom view.
-    pub projects: Option<Box<ProjectConnection>>,
-    /// Issues associated with the custom view.
-    pub issues: Option<Box<IssueConnection>>,
-    /// Feed items associated with the custom view.
-    pub updates: Option<Box<FeedItemConnection>>,
-    /// The current users view preferences for this custom view.
-    pub user_view_preferences: Option<Box<ViewPreferences>>,
-    /// The organizations default view preferences for this custom view.
-    pub organization_view_preferences: Option<Box<ViewPreferences>>,
-    /// The calculated view preferences values for this custom view.
-    pub view_preferences_values: Option<Box<ViewPreferencesValues>>,
-    /// Initiatives associated with the custom view.
-    pub initiatives: Option<Box<InitiativeConnection>>,
+    /// Projects matching the custom view's project filter. Returns an empty connection if the view's modelName is not "Project".
+    pub projects: Option<ProjectConnection>,
+    /// Issues matching the custom view's issue filter. Returns an empty connection if the view's modelName is not "Issue".
+    pub issues: Option<IssueConnection>,
+    /// Feed items (updates) matching the custom view's feed item filter. Returns an empty connection if the view's modelName is not "FeedItem".
+    pub updates: Option<FeedItemConnection>,
+    /// The current user's personal view preferences for this custom view, if they have set any.
+    pub user_view_preferences: Option<ViewPreferences>,
+    /// The workspace-level default view preferences for this custom view, if any have been set.
+    pub organization_view_preferences: Option<ViewPreferences>,
+    /// The computed view preferences values for this custom view, merging organization defaults with user overrides and system defaults. Use this for the effective display settings rather than reading raw preferences directly.
+    pub view_preferences_values: Option<ViewPreferencesValues>,
+    /// Initiatives matching the custom view's initiative filter. Returns an empty connection if the view's modelName is not "Initiative".
+    pub initiatives: Option<InitiativeConnection>,
 }
 impl GraphQLFields for CustomView {
     type FullType = Self;
@@ -1214,9 +2225,9 @@ impl GraphQLFields for CustomView {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomViewConnection {
-    pub edges: Option<Box<Vec<CustomViewEdge>>>,
-    pub nodes: Option<Box<Vec<CustomView>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<CustomViewEdge>>,
+    pub nodes: Option<Vec<CustomView>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for CustomViewConnection {
     type FullType = Self;
@@ -1227,7 +2238,7 @@ impl GraphQLFields for CustomViewConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomViewEdge {
-    pub node: Option<Box<CustomView>>,
+    pub node: Option<CustomView>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -1237,6 +2248,7 @@ impl GraphQLFields for CustomViewEdge {
         "cursor".into()
     }
 }
+/// The result of a custom view subscribers check.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomViewHasSubscribersPayload {
@@ -1249,7 +2261,7 @@ impl GraphQLFields for CustomViewHasSubscribersPayload {
         "hasSubscribers".into()
     }
 }
-/// A custom view notification subscription.
+/// A notification subscription scoped to a specific custom view. The subscriber receives notifications for events matching the custom view's filter criteria.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomViewNotificationSubscription {
@@ -1262,31 +2274,31 @@ pub struct CustomViewNotificationSubscription {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The user that subscribed to receive notifications.
-    pub subscriber: Option<Box<User>>,
-    /// The customer associated with the notification subscription.
-    pub customer: Option<Box<Customer>>,
+    /// The user who will receive notifications from this subscription.
+    pub subscriber: Option<User>,
+    /// The customer that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub customer: Option<Customer>,
     /// The custom view subscribed to.
-    pub custom_view: Option<Box<CustomView>>,
-    /// The contextual cycle view associated with the notification subscription.
-    pub cycle: Option<Box<Cycle>>,
-    /// The contextual label view associated with the notification subscription.
-    pub label: Option<Box<IssueLabel>>,
-    /// The contextual project view associated with the notification subscription.
-    pub project: Option<Box<Project>>,
-    /// The contextual initiative view associated with the notification subscription.
-    pub initiative: Option<Box<Initiative>>,
-    /// The team associated with the notification subscription.
-    pub team: Option<Box<Team>>,
-    /// The user view associated with the notification subscription.
-    pub user: Option<Box<User>>,
-    /// The type of view to which the notification subscription context is associated with.
+    pub custom_view: Option<CustomView>,
+    /// The cycle that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub cycle: Option<Cycle>,
+    /// The issue label that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub label: Option<IssueLabel>,
+    /// The project that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub project: Option<Project>,
+    /// The initiative that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub initiative: Option<Initiative>,
+    /// The team that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub team: Option<Team>,
+    /// The user that this notification subscription is scoped to, for user-specific view subscriptions. Null if the subscription targets a different entity type.
+    pub user: Option<User>,
+    /// The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type.
     pub context_view_type: Option<ContextViewType>,
-    /// The type of user view to which the notification subscription context is associated with.
+    /// The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type.
     pub user_context_view_type: Option<UserContextViewType>,
-    /// Whether the subscription is active or not.
+    /// Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists.
     pub active: Option<bool>,
-    /// The type of subscription.
+    /// The notification event types that this subscription will deliver to the subscriber.
     pub notification_subscription_types: Option<Vec<String>>,
 }
 impl GraphQLFields for CustomViewNotificationSubscription {
@@ -1296,13 +2308,14 @@ impl GraphQLFields for CustomViewNotificationSubscription {
             .into()
     }
 }
+/// The result of a custom view mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomViewPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The custom view that was created or updated.
-    pub custom_view: Option<Box<CustomView>>,
+    pub custom_view: Option<CustomView>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -1312,6 +2325,7 @@ impl GraphQLFields for CustomViewPayload {
         "lastSyncId success".into()
     }
 }
+/// The result of a custom view suggestion query.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomViewSuggestionPayload {
@@ -1328,7 +2342,7 @@ impl GraphQLFields for CustomViewSuggestionPayload {
         "name description icon".into()
     }
 }
-/// A customer whose needs will be tied to issues or projects.
+/// A customer organization tracked in Linear's customer management system. Customers represent external companies or organizations whose product requests and feedback are captured as customer needs, which can be linked to issues and projects. Customers can be associated with domains, external system IDs, Slack channels, and managed by integrations such as Intercom or Salesforce.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Customer {
@@ -1341,35 +2355,37 @@ pub struct Customer {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The customer's name.
+    /// The display name of the customer organization.
     pub name: Option<String>,
-    /// The customer's logo URL.
+    /// URL of the customer's logo image. Null if no logo has been uploaded.
     pub logo_url: Option<String>,
-    /// The domains associated with this customer.
+    /// The email domains associated with this customer (e.g., 'acme.com'). Used to automatically match incoming requests to this customer. Public email domains (e.g., gmail.com) are not allowed. Domains must be unique across all customers in the workspace.
     pub domains: Option<Vec<String>>,
-    /// The ids of the customers in external systems.
+    /// Identifiers for this customer in external systems (e.g., CRM IDs from Intercom, Salesforce, or HubSpot). Used for matching customers during integration syncs and upsert operations. External IDs must be unique across customers in the workspace.
     pub external_ids: Option<Vec<String>>,
-    /// The ID of the Slack channel used to interact with the customer.
+    /// The ID of the Slack channel linked to this customer for communication. Null if no Slack channel has been associated. Must be unique across all customers in the workspace.
     pub slack_channel_id: Option<String>,
-    /// The user who owns the customer.
+    /// The workspace member assigned as the owner of this customer. Null if no owner has been assigned. App users cannot be set as customer owners.
     pub owner: Option<Box<User>>,
-    /// The current status of the customer.
-    pub status: Option<Box<CustomerStatus>>,
-    /// The annual revenue generated by the customer.
+    /// The current lifecycle status of the customer. Defaults to the first status by position when a customer is created without an explicit status.
+    pub status: Option<CustomerStatus>,
+    /// The annual revenue generated by this customer. Null if revenue data has not been provided. May be synced from an external data source such as a CRM integration.
     pub revenue: Option<i64>,
-    /// The size of the customer.
+    /// The number of employees or seats at the customer organization. Null if size data has not been provided. May be synced from an external data source such as a CRM integration.
     pub size: Option<f64>,
-    /// The tier of the customer.
-    pub tier: Option<Box<CustomerTier>>,
-    /// The approximate number of needs of the customer.
+    /// The tier or segment assigned to this customer for prioritization (e.g., Enterprise, Pro, Free). Null if no tier has been assigned.
+    pub tier: Option<CustomerTier>,
+    /// The approximate count of customer needs (requests) associated with this customer. This is a denormalized counter and may not reflect the exact count at all times.
     pub approximate_need_count: Option<f64>,
-    /// The customer's unique URL slug.
+    /// A unique, human-readable URL slug for the customer. Automatically generated and used in customer page URLs.
     pub slug_id: Option<String>,
-    /// The ID of the main source, when a customer has multiple sources. Must be one of externalIds.
+    /// The primary external source ID when a customer has data from multiple external systems. Must be one of the values in the externalIds array. Null if the customer has zero or one external source.
     pub main_source_id: Option<String>,
-    /// The integration that manages the Customer.
+    /// The list of customer needs (product requests and feedback) associated with this customer.
+    pub needs: Option<Vec<CustomerNeed>>,
+    /// The integration that manages this customer's data (e.g., Intercom, Salesforce). Null if the customer is not managed by any data source integration.
     pub integration: Option<Box<Integration>>,
-    /// URL of the customer in Linear.
+    /// The URL of the customer's page in the Linear application.
     pub url: Option<String>,
 }
 impl GraphQLFields for Customer {
@@ -1382,9 +2398,9 @@ impl GraphQLFields for Customer {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerConnection {
-    pub edges: Option<Box<Vec<CustomerEdge>>>,
-    pub nodes: Option<Box<Vec<Customer>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<CustomerEdge>>,
+    pub nodes: Option<Vec<Customer>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for CustomerConnection {
     type FullType = Self;
@@ -1395,7 +2411,7 @@ impl GraphQLFields for CustomerConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerEdge {
-    pub node: Option<Box<Customer>>,
+    pub node: Option<Customer>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -1405,7 +2421,7 @@ impl GraphQLFields for CustomerEdge {
         "cursor".into()
     }
 }
-/// A customer need, expressed through a reference to an issue, project, or comment.
+/// A customer need represents a specific product request or piece of feedback from a customer. Customer needs serve as the bridge between customer feedback and engineering work by linking a customer to an issue or project, optionally with a comment or attachment providing additional context. Needs can be created manually, from integrations, or from intake sources like email.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerNeed {
@@ -1418,29 +2434,29 @@ pub struct CustomerNeed {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The customer that this need is attached to.
-    pub customer: Option<Box<Customer>>,
-    /// The issue this need is referencing.
-    pub issue: Option<Box<Issue>>,
-    /// The project this need is referencing.
-    pub project: Option<Box<Project>>,
-    /// The comment this need is referencing.
-    pub comment: Option<Box<Comment>>,
-    /// The attachment this need is referencing.
-    pub attachment: Option<Box<Attachment>>,
-    /// The project attachment this need is referencing.
-    pub project_attachment: Option<Box<ProjectAttachment>>,
+    /// The customer organization this need belongs to. Null if the need has not yet been associated with a customer.
+    pub customer: Option<Customer>,
+    /// The issue this need is linked to. Either issueId or projectId must be set. When set, the need's projectId is denormalized from the issue's project.
+    pub issue: Option<Issue>,
+    /// The project this need is linked to. For issue-based needs, this is denormalized from the issue's project. For project-only needs, this is set directly.
+    pub project: Option<Project>,
+    /// An optional comment providing additional context for this need. Null if the need was not created from or associated with a specific comment.
+    pub comment: Option<Comment>,
+    /// The issue attachment linked to this need. Populated when the need originates from an intake source (e.g., Slack, Intercom) or when a URL is manually provided. Provides a link back to the original source of the customer feedback. Mutually exclusive with projectAttachment.
+    pub attachment: Option<Attachment>,
+    /// The project attachment linked to this need. Populated when the need originates from an intake source or when a URL is manually provided for a project-level need. Provides a link back to the original source of the customer feedback. Mutually exclusive with attachment.
+    pub project_attachment: Option<ProjectAttachment>,
     /// Whether the customer need is important or not. 0 = Not important, 1 = Important.
     pub priority: Option<f64>,
-    /// The need content in markdown format.
+    /// The body content of the need in Markdown format. Used to capture manual input about needs that cannot be directly tied to an attachment. Null if the need's content comes from an attached source.
     pub body: Option<String>,
-    /// `Internal` The content of the need as a Prosemirror document.
+    /// `Internal` The body content of the need as a Prosemirror document JSON string. This is the structured representation of the body field, used for rich text rendering in the editor.
     pub body_data: Option<String>,
-    /// The creator of the customer need.
-    pub creator: Option<Box<User>>,
-    /// The issue this customer need was originally created on. Will be undefined if the customer need hasn't been moved.
-    pub original_issue: Option<Box<Issue>>,
-    /// The URL of the underlying attachment, if any
+    /// The user who manually created this customer need. Null for needs created automatically by integrations or intake sources.
+    pub creator: Option<User>,
+    /// The issue this customer need was originally created on, before being moved to a different issue or project. Null if the customer need has not been moved from its original location.
+    pub original_issue: Option<Issue>,
+    /// The URL of the source attachment linked to this need, if any. Returns the URL from either the issue attachment or project attachment. Null if the need has no attached source.
     pub url: Option<String>,
 }
 impl GraphQLFields for CustomerNeed {
@@ -1458,7 +2474,7 @@ pub struct CustomerNeedArchivePayload {
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The archived/unarchived entity. Null if entity was deleted.
-    pub entity: Option<Box<CustomerNeed>>,
+    pub entity: Option<CustomerNeed>,
 }
 impl GraphQLFields for CustomerNeedArchivePayload {
     type FullType = Self;
@@ -1469,9 +2485,9 @@ impl GraphQLFields for CustomerNeedArchivePayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerNeedConnection {
-    pub edges: Option<Box<Vec<CustomerNeedEdge>>>,
-    pub nodes: Option<Box<Vec<CustomerNeed>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<CustomerNeedEdge>>,
+    pub nodes: Option<Vec<CustomerNeed>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for CustomerNeedConnection {
     type FullType = Self;
@@ -1482,7 +2498,7 @@ impl GraphQLFields for CustomerNeedConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerNeedEdge {
-    pub node: Option<Box<CustomerNeed>>,
+    pub node: Option<CustomerNeed>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -1492,7 +2508,7 @@ impl GraphQLFields for CustomerNeedEdge {
         "cursor".into()
     }
 }
-/// A customer need related notification.
+/// A notification related to a customer need (request), such as creation, resolution, or being marked as important.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerNeedNotification {
@@ -1505,22 +2521,21 @@ pub struct CustomerNeedNotification {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Notification type.
+    /// Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated.
     pub r#type: Option<String>,
-    /// The user that caused the notification.
-    pub actor: Option<Box<User>>,
-    /// The external user that caused the notification.
-    pub external_user_actor: Option<Box<ExternalUser>>,
-    /// The user that received the notification.
-    pub user: Option<Box<User>>,
-    /// The time at when the user marked the notification as read. Null, if the the user hasn't read the notification
+    /// The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event.
+    pub actor: Option<User>,
+    /// The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member.
+    pub external_user_actor: Option<ExternalUser>,
+    /// The recipient user of this notification.
+    pub user: Option<User>,
+    /// The time at which the user marked the notification as read. Null if the notification is unread.
     pub read_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at when an email reminder for this notification was sent to the user. Null, if no email
-    /// reminder has been sent.
+    /// The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent.
     pub emailed_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time until a notification will be snoozed. After that it will appear in the inbox again.
+    /// The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed.
     pub snoozed_until_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which a notification was unsnoozed..
+    /// The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed.
     pub unsnoozed_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The category of the notification.
     pub category: Option<NotificationCategory>,
@@ -1551,15 +2566,15 @@ pub struct CustomerNeedNotification {
     /// `Internal` Priority of the notification with the same grouping key. Higher number means higher priority. If priority is the same, notifications should be sorted by `createdAt`.
     pub grouping_priority: Option<f64>,
     /// The bot that caused the notification.
-    pub bot_actor: Option<Box<ActorBot>>,
+    pub bot_actor: Option<ActorBot>,
     /// Related customer need.
     pub customer_need_id: Option<String>,
     /// The issue related to the notification.
-    pub related_issue: Option<Box<Issue>>,
+    pub related_issue: Option<Issue>,
     /// The project related to the notification.
-    pub related_project: Option<Box<Project>>,
+    pub related_project: Option<Project>,
     /// The customer need related to the notification.
-    pub customer_need: Option<Box<CustomerNeed>>,
+    pub customer_need: Option<CustomerNeed>,
 }
 impl GraphQLFields for CustomerNeedNotification {
     type FullType = Self;
@@ -1568,13 +2583,14 @@ impl GraphQLFields for CustomerNeedNotification {
             .into()
     }
 }
+/// Return type for customer need mutations.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerNeedPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    /// The customer need that was created or updated.
-    pub need: Option<Box<CustomerNeed>>,
+    /// The customer need entity that was created or updated by the mutation.
+    pub need: Option<CustomerNeed>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -1584,17 +2600,18 @@ impl GraphQLFields for CustomerNeedPayload {
         "lastSyncId success".into()
     }
 }
+/// Return type for customer need update mutations, including any related needs that were also updated.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerNeedUpdatePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    /// The customer need that was created or updated.
-    pub need: Option<Box<CustomerNeed>>,
+    /// The customer need entity that was created or updated by the mutation.
+    pub need: Option<CustomerNeed>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
-    /// The related customer needs that were updated.
-    pub updated_related_needs: Option<Box<Vec<CustomerNeed>>>,
+    /// Additional customer needs from the same customer on the same issue/project that were updated when applyPriorityToRelatedNeeds was set.
+    pub updated_related_needs: Option<Vec<CustomerNeed>>,
 }
 impl GraphQLFields for CustomerNeedUpdatePayload {
     type FullType = Self;
@@ -1602,7 +2619,7 @@ impl GraphQLFields for CustomerNeedUpdatePayload {
         "lastSyncId success".into()
     }
 }
-/// A customer related notification.
+/// A notification related to a customer, such as being added as the customer owner.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerNotification {
@@ -1615,22 +2632,21 @@ pub struct CustomerNotification {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Notification type.
+    /// Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated.
     pub r#type: Option<String>,
-    /// The user that caused the notification.
-    pub actor: Option<Box<User>>,
-    /// The external user that caused the notification.
-    pub external_user_actor: Option<Box<ExternalUser>>,
-    /// The user that received the notification.
-    pub user: Option<Box<User>>,
-    /// The time at when the user marked the notification as read. Null, if the the user hasn't read the notification
+    /// The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event.
+    pub actor: Option<User>,
+    /// The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member.
+    pub external_user_actor: Option<ExternalUser>,
+    /// The recipient user of this notification.
+    pub user: Option<User>,
+    /// The time at which the user marked the notification as read. Null if the notification is unread.
     pub read_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at when an email reminder for this notification was sent to the user. Null, if no email
-    /// reminder has been sent.
+    /// The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent.
     pub emailed_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time until a notification will be snoozed. After that it will appear in the inbox again.
+    /// The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed.
     pub snoozed_until_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which a notification was unsnoozed..
+    /// The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed.
     pub unsnoozed_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The category of the notification.
     pub category: Option<NotificationCategory>,
@@ -1661,11 +2677,11 @@ pub struct CustomerNotification {
     /// `Internal` Priority of the notification with the same grouping key. Higher number means higher priority. If priority is the same, notifications should be sorted by `createdAt`.
     pub grouping_priority: Option<f64>,
     /// The bot that caused the notification.
-    pub bot_actor: Option<Box<ActorBot>>,
+    pub bot_actor: Option<ActorBot>,
     /// Related customer.
     pub customer_id: Option<String>,
     /// The customer related to the notification.
-    pub customer: Option<Box<Customer>>,
+    pub customer: Option<Customer>,
 }
 impl GraphQLFields for CustomerNotification {
     type FullType = Self;
@@ -1674,7 +2690,7 @@ impl GraphQLFields for CustomerNotification {
             .into()
     }
 }
-/// A customer notification subscription.
+/// A notification subscription scoped to a specific customer. The subscriber receives notifications for events related to this customer, such as new customer needs or ownership changes.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerNotificationSubscription {
@@ -1687,31 +2703,31 @@ pub struct CustomerNotificationSubscription {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The user that subscribed to receive notifications.
-    pub subscriber: Option<Box<User>>,
+    /// The user who will receive notifications from this subscription.
+    pub subscriber: Option<User>,
     /// The customer subscribed to.
-    pub customer: Option<Box<Customer>>,
-    /// The contextual custom view associated with the notification subscription.
-    pub custom_view: Option<Box<CustomView>>,
-    /// The contextual cycle view associated with the notification subscription.
-    pub cycle: Option<Box<Cycle>>,
-    /// The contextual label view associated with the notification subscription.
-    pub label: Option<Box<IssueLabel>>,
-    /// The contextual project view associated with the notification subscription.
-    pub project: Option<Box<Project>>,
-    /// The contextual initiative view associated with the notification subscription.
-    pub initiative: Option<Box<Initiative>>,
-    /// The team associated with the notification subscription.
-    pub team: Option<Box<Team>>,
-    /// The user view associated with the notification subscription.
-    pub user: Option<Box<User>>,
-    /// The type of view to which the notification subscription context is associated with.
+    pub customer: Option<Customer>,
+    /// The custom view that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub custom_view: Option<CustomView>,
+    /// The cycle that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub cycle: Option<Cycle>,
+    /// The issue label that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub label: Option<IssueLabel>,
+    /// The project that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub project: Option<Project>,
+    /// The initiative that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub initiative: Option<Initiative>,
+    /// The team that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub team: Option<Team>,
+    /// The user that this notification subscription is scoped to, for user-specific view subscriptions. Null if the subscription targets a different entity type.
+    pub user: Option<User>,
+    /// The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type.
     pub context_view_type: Option<ContextViewType>,
-    /// The type of user view to which the notification subscription context is associated with.
+    /// The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type.
     pub user_context_view_type: Option<UserContextViewType>,
-    /// Whether the subscription is active or not.
+    /// Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists.
     pub active: Option<bool>,
-    /// The type of subscription.
+    /// The notification event types that this subscription will deliver to the subscriber.
     pub notification_subscription_types: Option<Vec<String>>,
 }
 impl GraphQLFields for CustomerNotificationSubscription {
@@ -1721,13 +2737,14 @@ impl GraphQLFields for CustomerNotificationSubscription {
             .into()
     }
 }
+/// Return type for customer mutations.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    /// The customer that was created or updated.
-    pub customer: Option<Box<Customer>>,
+    /// The customer entity that was created or updated by the mutation.
+    pub customer: Option<Customer>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -1737,7 +2754,7 @@ impl GraphQLFields for CustomerPayload {
         "lastSyncId success".into()
     }
 }
-/// A customer status.
+/// A workspace-defined lifecycle status for customers (e.g., Active, Churned, Trial). Customer statuses are ordered by position and displayed with a color in the UI. Every workspace has at least one status, and a default status is assigned to new customers when none is specified.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerStatus {
@@ -1750,17 +2767,17 @@ pub struct CustomerStatus {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The name of the status.
+    /// The internal name of the status. Used as the default display name if no displayName is explicitly set.
     pub name: Option<String>,
-    /// The UI color of the status as a HEX string.
+    /// The color of the status indicator in the UI, as a HEX string (e.g., '#ff0000').
     pub color: Option<String>,
-    /// Description of the status.
+    /// An optional description explaining what this status represents in the customer lifecycle.
     pub description: Option<String>,
-    /// The position of the status in the workspace's customers flow.
+    /// The sort position of the status in the workspace's customer lifecycle flow. Lower values appear first. Collisions are automatically resolved by redistributing positions.
     pub position: Option<f64>,
-    /// The display name of the status.
+    /// The user-facing display name of the status shown in the UI. Defaults to the internal name if not explicitly set.
     pub display_name: Option<String>,
-    /// The type of the customer status.
+    /// `Deprecated` The type of the customer status. Always returns null as statuses are no longer grouped by type.
     pub r#type: Option<CustomerStatusType>,
 }
 impl GraphQLFields for CustomerStatus {
@@ -1772,9 +2789,9 @@ impl GraphQLFields for CustomerStatus {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerStatusConnection {
-    pub edges: Option<Box<Vec<CustomerStatusEdge>>>,
-    pub nodes: Option<Box<Vec<CustomerStatus>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<CustomerStatusEdge>>,
+    pub nodes: Option<Vec<CustomerStatus>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for CustomerStatusConnection {
     type FullType = Self;
@@ -1785,7 +2802,7 @@ impl GraphQLFields for CustomerStatusConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerStatusEdge {
-    pub node: Option<Box<CustomerStatus>>,
+    pub node: Option<CustomerStatus>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -1795,13 +2812,14 @@ impl GraphQLFields for CustomerStatusEdge {
         "cursor".into()
     }
 }
+/// Return type for customer status mutations.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerStatusPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    /// The customer status that was created or updated.
-    pub status: Option<Box<CustomerStatus>>,
+    /// The customer status entity that was created or updated by the mutation.
+    pub status: Option<CustomerStatus>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -1811,7 +2829,7 @@ impl GraphQLFields for CustomerStatusPayload {
         "lastSyncId success".into()
     }
 }
-/// A customer tier.
+/// A workspace-defined tier or segment for categorizing customers (e.g., Enterprise, Pro, Free). Customer tiers are used for prioritization and filtering, are ordered by position, and displayed with a color in the UI. Tier names are unique within a workspace.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerTier {
@@ -1824,15 +2842,15 @@ pub struct CustomerTier {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The name of the tier.
+    /// The internal name of the tier. Must be unique within the workspace. Used as the default display name if no displayName is explicitly set.
     pub name: Option<String>,
-    /// The UI color of the tier as a HEX string.
+    /// The color of the tier indicator in the UI, as a HEX string (e.g., '#ff0000').
     pub color: Option<String>,
-    /// Description of the tier.
+    /// An optional description explaining what this tier represents and its intended use for customer segmentation.
     pub description: Option<String>,
-    /// The position of the tier in the workspace's customers flow.
+    /// The sort position of the tier in the workspace's customer tier ordering. Lower values appear first. Collisions are automatically resolved by redistributing positions.
     pub position: Option<f64>,
-    /// The display name of the tier.
+    /// The user-facing display name of the tier shown in the UI. Defaults to the internal name if not explicitly set.
     pub display_name: Option<String>,
 }
 impl GraphQLFields for CustomerTier {
@@ -1844,9 +2862,9 @@ impl GraphQLFields for CustomerTier {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerTierConnection {
-    pub edges: Option<Box<Vec<CustomerTierEdge>>>,
-    pub nodes: Option<Box<Vec<CustomerTier>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<CustomerTierEdge>>,
+    pub nodes: Option<Vec<CustomerTier>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for CustomerTierConnection {
     type FullType = Self;
@@ -1857,7 +2875,7 @@ impl GraphQLFields for CustomerTierConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerTierEdge {
-    pub node: Option<Box<CustomerTier>>,
+    pub node: Option<CustomerTier>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -1867,13 +2885,14 @@ impl GraphQLFields for CustomerTierEdge {
         "cursor".into()
     }
 }
+/// Return type for customer tier mutations.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CustomerTierPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    /// The customer tier that was created or updated.
-    pub tier: Option<Box<CustomerTier>>,
+    /// The customer tier entity that was created or updated by the mutation.
+    pub tier: Option<CustomerTier>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -1883,7 +2902,7 @@ impl GraphQLFields for CustomerTierPayload {
         "lastSyncId success".into()
     }
 }
-/// A set of issues to be resolved in a specified amount of time.
+/// A time-boxed iteration (similar to a sprint) used for planning and tracking work. Cycles belong to a team and have defined start and end dates. Issues are assigned to cycles for time-based planning, and progress is tracked via completed, in-progress, and total scope. Cycles are automatically completed when their end date passes, and uncompleted issues can be carried over to the next cycle.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Cycle {
@@ -1896,58 +2915,58 @@ pub struct Cycle {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The number of the cycle.
+    /// The auto-incrementing number of the cycle, unique within its team. This value is assigned automatically by the database and cannot be set on creation.
     pub number: Option<f64>,
-    /// The custom name of the cycle.
+    /// The custom name of the cycle. If not set, the cycle is displayed using its number (e.g., "Cycle 5").
     pub name: Option<String>,
-    /// The cycle's description.
+    /// The description of the cycle.
     pub description: Option<String>,
-    /// The start time of the cycle.
+    /// The start date and time of the cycle.
     pub starts_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The end time of the cycle.
+    /// The end date and time of the cycle. When a cycle is completed prematurely, this is updated to match the completion time. When cycles are disabled, both endsAt and completedAt are set to the current time.
     pub ends_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The completion time of the cycle. If null, the cycle hasn't been completed.
+    /// The completion time of the cycle. If null, the cycle has not been completed yet. A cycle is completed either when its end date passes or when it is manually completed early.
     pub completed_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the cycle was automatically archived by the auto pruning process.
+    /// The time at which the cycle was automatically archived by the auto-pruning process. Null if the cycle has not been auto-archived.
     pub auto_archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The total number of issues in the cycle after each day.
+    /// The total number of issues in the cycle after each day. Each entry represents a snapshot at the end of that day, forming the basis for burndown charts.
     pub issue_count_history: Option<Vec<f64>>,
-    /// The number of completed issues in the cycle after each day.
+    /// The number of completed issues in the cycle after each day. Each entry corresponds to the same day index as issueCountHistory.
     pub completed_issue_count_history: Option<Vec<f64>>,
-    /// The total number of estimation points after each day.
+    /// The total number of estimation points (scope) in the cycle after each day. Used for scope-based burndown charts.
     pub scope_history: Option<Vec<f64>>,
-    /// The number of completed estimation points after each day.
+    /// The number of completed estimation points after each day. Used together with scopeHistory for burndown charts.
     pub completed_scope_history: Option<Vec<f64>>,
-    /// The number of in progress estimation points after each day.
+    /// The number of in-progress estimation points after each day. Tracks work that has been started but not yet completed.
     pub in_progress_scope_history: Option<Vec<f64>>,
-    /// The team that the cycle is associated with.
+    /// The team that the cycle belongs to. Each cycle is scoped to exactly one team.
     pub team: Option<Box<Team>>,
-    /// `Internal` The progress history of the cycle.
+    /// `Internal` The detailed progress history of the cycle, including per-status breakdowns over time.
     pub progress_history: Option<serde_json::Value>,
-    /// `Internal` The current progress of the cycle.
+    /// `Internal` The current progress snapshot of the cycle, broken down by issue status categories.
     pub current_progress: Option<serde_json::Value>,
-    /// The cycle inherited from.
+    /// The parent cycle this cycle was inherited from. When a parent team creates cycles, sub-teams automatically receive corresponding inherited cycles.
     pub inherited_from: Option<Box<Cycle>>,
-    /// Whether the cycle is currently active.
+    /// Whether the cycle is currently active. A cycle is active if the current time is between its start and end dates and it has not been completed.
     pub is_active: Option<bool>,
-    /// Whether the cycle is in the future.
+    /// Whether the cycle has not yet started. True if the cycle's start date is in the future.
     pub is_future: Option<bool>,
-    /// Whether the cycle is in the past.
+    /// Whether the cycle's end date has passed.
     pub is_past: Option<bool>,
-    /// Issues associated with the cycle.
-    pub issues: Option<Box<IssueConnection>>,
-    /// Issues that weren't completed when the cycle was closed.
-    pub uncompleted_issues_upon_close: Option<Box<IssueConnection>>,
-    /// The overall progress of the cycle. This is the (completed estimate points + 0.25 * in progress estimate points) / total estimate points.
+    /// Issues that are currently assigned to this cycle.
+    pub issues: Option<IssueConnection>,
+    /// Issues that were still open (not completed) when the cycle was closed. These issues may have been moved to the next cycle.
+    pub uncompleted_issues_upon_close: Option<IssueConnection>,
+    /// The overall progress of the cycle as a number between 0 and 1. Calculated as (completed estimate points + 0.25 * in-progress estimate points) / total estimate points. Returns 0 if no estimate points exist.
     pub progress: Option<f64>,
-    /// Whether the cycle is the next cycle for the team.
+    /// Whether this cycle is the next upcoming (not yet started) cycle for the team.
     pub is_next: Option<bool>,
-    /// Whether the cycle is the previous cycle for the team.
+    /// Whether this cycle is the most recently completed cycle for the team.
     pub is_previous: Option<bool>,
     /// `Internal` Documents associated with the cycle.
-    pub documents: Option<Box<DocumentConnection>>,
+    pub documents: Option<DocumentConnection>,
     /// `Internal` Links associated with the cycle.
-    pub links: Option<Box<EntityExternalLinkConnection>>,
+    pub links: Option<EntityExternalLinkConnection>,
 }
 impl GraphQLFields for Cycle {
     type FullType = Self;
@@ -1965,7 +2984,7 @@ pub struct CycleArchivePayload {
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The archived/unarchived entity. Null if entity was deleted.
-    pub entity: Option<Box<Cycle>>,
+    pub entity: Option<Cycle>,
 }
 impl GraphQLFields for CycleArchivePayload {
     type FullType = Self;
@@ -1976,9 +2995,9 @@ impl GraphQLFields for CycleArchivePayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CycleConnection {
-    pub edges: Option<Box<Vec<CycleEdge>>>,
-    pub nodes: Option<Box<Vec<Cycle>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<CycleEdge>>,
+    pub nodes: Option<Vec<Cycle>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for CycleConnection {
     type FullType = Self;
@@ -1989,7 +3008,7 @@ impl GraphQLFields for CycleConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CycleEdge {
-    pub node: Option<Box<Cycle>>,
+    pub node: Option<Cycle>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -1999,7 +3018,7 @@ impl GraphQLFields for CycleEdge {
         "cursor".into()
     }
 }
-/// A cycle notification subscription.
+/// A notification subscription scoped to a specific cycle. The subscriber receives notifications for events related to issues in this cycle.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CycleNotificationSubscription {
@@ -2012,31 +3031,31 @@ pub struct CycleNotificationSubscription {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The user that subscribed to receive notifications.
-    pub subscriber: Option<Box<User>>,
-    /// The customer associated with the notification subscription.
-    pub customer: Option<Box<Customer>>,
-    /// The contextual custom view associated with the notification subscription.
-    pub custom_view: Option<Box<CustomView>>,
+    /// The user who will receive notifications from this subscription.
+    pub subscriber: Option<User>,
+    /// The customer that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub customer: Option<Customer>,
+    /// The custom view that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub custom_view: Option<CustomView>,
     /// The cycle subscribed to.
-    pub cycle: Option<Box<Cycle>>,
-    /// The contextual label view associated with the notification subscription.
-    pub label: Option<Box<IssueLabel>>,
-    /// The contextual project view associated with the notification subscription.
-    pub project: Option<Box<Project>>,
-    /// The contextual initiative view associated with the notification subscription.
-    pub initiative: Option<Box<Initiative>>,
-    /// The team associated with the notification subscription.
-    pub team: Option<Box<Team>>,
-    /// The user view associated with the notification subscription.
-    pub user: Option<Box<User>>,
-    /// The type of view to which the notification subscription context is associated with.
+    pub cycle: Option<Cycle>,
+    /// The issue label that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub label: Option<IssueLabel>,
+    /// The project that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub project: Option<Project>,
+    /// The initiative that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub initiative: Option<Initiative>,
+    /// The team that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub team: Option<Team>,
+    /// The user that this notification subscription is scoped to, for user-specific view subscriptions. Null if the subscription targets a different entity type.
+    pub user: Option<User>,
+    /// The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type.
     pub context_view_type: Option<ContextViewType>,
-    /// The type of user view to which the notification subscription context is associated with.
+    /// The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type.
     pub user_context_view_type: Option<UserContextViewType>,
-    /// Whether the subscription is active or not.
+    /// Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists.
     pub active: Option<bool>,
-    /// The type of subscription.
+    /// The notification event types that this subscription will deliver to the subscriber.
     pub notification_subscription_types: Option<Vec<String>>,
 }
 impl GraphQLFields for CycleNotificationSubscription {
@@ -2046,13 +3065,14 @@ impl GraphQLFields for CycleNotificationSubscription {
             .into()
     }
 }
+/// The payload returned by cycle mutations.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct CyclePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    /// The Cycle that was created or updated.
-    pub cycle: Option<Box<Cycle>>,
+    /// The cycle that was created or updated.
+    pub cycle: Option<Cycle>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -2062,7 +3082,7 @@ impl GraphQLFields for CyclePayload {
         "lastSyncId success".into()
     }
 }
-/// `Internal` A dashboard, usually a collection of widgets to display several insights at once.
+/// `Internal` A configurable dashboard composed of widgets that display analytics, metrics, and insights. Dashboards can be personal or shared with the workspace, and optionally scoped to one or more teams. Each dashboard contains a set of widget configurations that define what data is visualized.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Dashboard {
@@ -2075,36 +3095,34 @@ pub struct Dashboard {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The dashboard's unique URL slug.
+    /// The dashboard's unique URL slug, used to construct human-readable URLs. Automatically generated on creation.
     pub slug_id: Option<String>,
     /// The name of the dashboard.
     pub name: Option<String>,
     /// The description of the dashboard.
     pub description: Option<String>,
-    /// The icon of the dashboard.
+    /// The icon of the dashboard. Can be an emoji or a decorative icon identifier.
     pub icon: Option<String>,
-    /// The color of the icon of the dashboard.
+    /// The hex color code of the dashboard icon.
     pub color: Option<String>,
-    /// The sort order of the dashboard within the organization or its team.
+    /// The sort order of the dashboard within the workspace or its team. Lower values appear first.
     pub sort_order: Option<f64>,
-    /// Whether the dashboard is shared with everyone in the organization.
+    /// Whether the dashboard is shared with everyone in the workspace. Shared dashboards are visible to all members; unshared dashboards are only visible to the owner.
     pub shared: Option<bool>,
-    /// The organization of the dashboard.
+    /// The organization that the dashboard belongs to.
     pub organization: Option<Box<Organization>>,
-    /// The user who created the dashboard.
+    /// The user who created the dashboard. Null if the creator's account has been deleted.
     pub creator: Option<Box<User>>,
-    /// The user who last updated the dashboard.
+    /// The user who last updated the dashboard. Null if no user has updated it or the updater's account has been deleted.
     pub updated_by: Option<Box<User>>,
-    /// The owner of the dashboard.
+    /// The owner of the dashboard. For personal dashboards, only the owner can view them. Null if the owner's account has been deleted.
     pub owner: Option<Box<User>>,
-    /// The filter applied to all dashboard widgets showing issues data.
+    /// A global issue filter applied to all dashboard widgets that display issue data. Individual widgets may apply additional filters on top of this.
     pub issue_filter: Option<serde_json::Value>,
-    /// The filter applied to all dashboard widgets showing projects data.
+    /// A global project filter applied to all dashboard widgets that display project data. Individual widgets may apply additional filters on top of this.
     pub project_filter: Option<serde_json::Value>,
-    /// The widgets on the dashboard.
+    /// The widget configuration for the dashboard, defining the layout grid of rows and the widgets within each row, including their type, size, and data settings.
     pub widgets: Option<serde_json::Value>,
-    /// The team associated with the dashboard.
-    pub team: Option<Box<Team>>,
 }
 impl GraphQLFields for Dashboard {
     type FullType = Self;
@@ -2130,7 +3148,7 @@ impl GraphQLFields for DeletePayload {
         "lastSyncId success entityId".into()
     }
 }
-/// A document that can be attached to different entities.
+/// A rich-text document that lives within a project, initiative, team, issue, release, or cycle. Documents support collaborative editing via ProseMirror/Yjs and store their content in a separate DocumentContent entity. Each document is associated with exactly one parent entity.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Document {
@@ -2143,43 +3161,45 @@ pub struct Document {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The document title.
+    /// The title of the document. An empty string indicates an untitled document.
     pub title: Option<String>,
-    /// The icon of the document.
+    /// `Internal` A one-sentence AI-generated summary of the document content. Null if no summary has been generated.
+    pub summary: Option<String>,
+    /// The icon of the document, either a decorative icon type or an emoji string. Null if no icon has been set.
     pub icon: Option<String>,
-    /// The color of the icon.
+    /// The hex color of the document icon. Null if no custom color has been set.
     pub color: Option<String>,
-    /// The user who created the document.
+    /// The user who created the document. Null if the creator's account has been deleted.
     pub creator: Option<Box<User>>,
-    /// The user who last updated the document.
+    /// The user who last updated the document. Null if the user's account has been deleted.
     pub updated_by: Option<Box<User>>,
-    /// The project that the document is associated with.
+    /// The project that the document is associated with. Null if the document belongs to a different parent entity type.
     pub project: Option<Box<Project>>,
-    /// The initiative that the document is associated with.
+    /// The initiative that the document is associated with. Null if the document belongs to a different parent entity type.
     pub initiative: Option<Box<Initiative>>,
-    /// `Internal` The team that the document is associated with.
+    /// `Internal` The team that the document is associated with. Null if the document belongs to a different parent entity type.
     pub team: Option<Box<Team>>,
-    /// The issue that the document is associated with.
+    /// The issue that the document is associated with. Null if the document belongs to a different parent entity type.
     pub issue: Option<Box<Issue>>,
-    /// `Internal` The release that the document is associated with.
+    /// `Internal` The release that the document is associated with. Null if the document belongs to a different parent entity type.
     pub release: Option<Box<Release>>,
-    /// `Internal` The cycle that the document is associated with.
+    /// `Internal` The cycle that the document is associated with. Null if the document belongs to a different parent entity type.
     pub cycle: Option<Box<Cycle>>,
-    /// The document's unique URL slug.
+    /// The document's unique URL slug, used to construct human-readable URLs.
     pub slug_id: Option<String>,
-    /// The last template that was applied to this document.
+    /// The last template that was applied to this document. Null if no template has been applied.
     pub last_applied_template: Option<Box<Template>>,
-    /// The time at which the document was hidden. Null if the entity has not been hidden.
+    /// The time at which the document was hidden from the default view. Null if the document has not been hidden.
     pub hidden_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// A flag that indicates whether the document is in the trash bin.
+    /// A flag that indicates whether the document is in the trash bin. Trashed documents are archived and can be restored.
     pub trashed: Option<bool>,
-    /// The order of the item in the resources list.
+    /// The sort order of the document in its parent entity's resources list. This order is shared with other resource types such as external links.
     pub sort_order: Option<f64>,
     /// Comments associated with the document.
-    pub comments: Option<Box<CommentConnection>>,
-    /// The documents content in markdown format.
+    pub comments: Option<CommentConnection>,
+    /// The document's content in markdown format.
     pub content: Option<String>,
-    /// `Internal` The documents content as YJS state.
+    /// `Internal` The document's content as a base64-encoded Yjs state update.
     pub content_state: Option<String>,
     /// The ID of the document content associated with the document.
     pub document_content_id: Option<String>,
@@ -2189,7 +3209,7 @@ pub struct Document {
 impl GraphQLFields for Document {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt title icon color slugId hiddenAt trashed sortOrder content contentState documentContentId url"
+        "id createdAt updatedAt archivedAt title summary icon color slugId hiddenAt trashed sortOrder content contentState documentContentId url"
             .into()
     }
 }
@@ -2202,7 +3222,7 @@ pub struct DocumentArchivePayload {
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The archived/unarchived entity. Null if entity was deleted.
-    pub entity: Option<Box<Document>>,
+    pub entity: Option<Document>,
 }
 impl GraphQLFields for DocumentArchivePayload {
     type FullType = Self;
@@ -2213,9 +3233,9 @@ impl GraphQLFields for DocumentArchivePayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct DocumentConnection {
-    pub edges: Option<Box<Vec<DocumentEdge>>>,
-    pub nodes: Option<Box<Vec<Document>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<DocumentEdge>>,
+    pub nodes: Option<Vec<Document>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for DocumentConnection {
     type FullType = Self;
@@ -2223,7 +3243,7 @@ impl GraphQLFields for DocumentConnection {
         "".into()
     }
 }
-/// A document content for a project.
+/// The rich-text content body of a document, issue, project, initiative, project milestone, pull request, release note, AI prompt rules, or welcome message. Content is stored as a base64-encoded Yjs state and can be converted to Markdown or ProseMirror JSON. Each DocumentContent belongs to exactly one parent entity and supports real-time collaborative editing.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct DocumentContent {
@@ -2236,32 +3256,28 @@ pub struct DocumentContent {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The document content in markdown format.
+    /// The document content in markdown format. This is a derived representation of the canonical Yjs content state.
     pub content: Option<String>,
-    /// The document content state as a base64 encoded string.
+    /// The document content state as a base64-encoded Yjs state update. This is the canonical representation of the document content used for collaborative editing.
     pub content_state: Option<String>,
-    /// The issue that the content is associated with.
+    /// The issue that the content is associated with. Null if the content belongs to a different parent entity type.
     pub issue: Option<Box<Issue>>,
-    /// `Internal` The pull request that the content is associated with.
+    /// `Internal` The pull request that the content is associated with. Null if the content belongs to a different parent entity type.
     pub pull_request: Option<Box<PullRequest>>,
-    /// The project that the content is associated with.
+    /// The project that the content is associated with. Null if the content belongs to a different parent entity type.
     pub project: Option<Box<Project>>,
-    /// The initiative that the content is associated with.
+    /// The initiative that the content is associated with. Null if the content belongs to a different parent entity type.
     pub initiative: Option<Box<Initiative>>,
-    /// The project milestone that the content is associated with.
+    /// The project milestone that the content is associated with. Null if the content belongs to a different parent entity type.
     pub project_milestone: Option<Box<ProjectMilestone>>,
-    /// The document that the content is associated with.
+    /// The document that the content is associated with. Null if the content belongs to a different parent entity type.
     pub document: Option<Box<Document>>,
-    /// The AI prompt rules that the content is associated with.
+    /// The AI prompt rules that the content is associated with. Null if the content belongs to a different parent entity type.
     pub ai_prompt_rules: Option<Box<AiPromptRules>>,
-    /// The welcome message that the content is associated with.
+    /// The welcome message that the content is associated with. Null if the content belongs to a different parent entity type.
     pub welcome_message: Option<Box<WelcomeMessage>>,
-    /// The time at which the document content was restored from a previous version.
+    /// The time at which the document content was restored from a previous version in the content history. Null if the content has never been restored.
     pub restored_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Comments associated with the document content.
-    pub comments: Option<Box<CommentConnection>>,
-    /// `ALPHA` The histories of the document content.
-    pub history: Option<Box<DocumentContentHistoryConnection>>,
 }
 impl GraphQLFields for DocumentContent {
     type FullType = Self;
@@ -2269,10 +3285,10 @@ impl GraphQLFields for DocumentContent {
         "id createdAt updatedAt archivedAt content contentState restoredAt".into()
     }
 }
-/// A document content history for a document.
+/// A draft revision of document content, pending user review. Each user can have at most one draft per document content. Drafts are seeded from the live document state and stored as base64-encoded Yjs state updates, allowing independent editing without affecting the published document until the user explicitly applies their changes.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
-pub struct DocumentContentHistory {
+pub struct DocumentContentDraft {
     /// The unique identifier of the entity.
     pub id: Option<String>,
     /// The time at which the entity was created.
@@ -2282,52 +3298,28 @@ pub struct DocumentContentHistory {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The document content that this history item is associated with.
-    pub document_content: Option<Box<DocumentContent>>,
-    /// `Internal` The document content as a Prosemirror document.
-    pub content_data: Option<serde_json::Value>,
-    /// IDs of actors whose edits went into this history item.
-    pub actor_ids: Option<Vec<String>>,
-    /// The timestamp associated with the DocumentContent when it was originally saved.
-    pub content_data_snapshot_at: Option<chrono::DateTime<chrono::Utc>>,
-}
-impl GraphQLFields for DocumentContentHistory {
-    type FullType = Self;
-    fn selection() -> String {
-        "id createdAt updatedAt archivedAt contentData actorIds contentDataSnapshotAt".into()
-    }
-}
-#[derive(Debug, Clone, Default, Serialize, Deserialize)]
-#[serde(rename_all = "camelCase", default)]
-pub struct DocumentContentHistoryConnection {
-    pub edges: Option<Box<Vec<DocumentContentHistoryEdge>>>,
-    pub nodes: Option<Box<Vec<DocumentContentHistory>>>,
-    pub page_info: Option<Box<PageInfo>>,
-}
-impl GraphQLFields for DocumentContentHistoryConnection {
-    type FullType = Self;
-    fn selection() -> String {
-        "".into()
-    }
-}
-#[derive(Debug, Clone, Default, Serialize, Deserialize)]
-#[serde(rename_all = "camelCase", default)]
-pub struct DocumentContentHistoryEdge {
-    pub node: Option<Box<DocumentContentHistory>>,
-    /// Used in `before` and `after` args
-    pub cursor: Option<String>,
+    /// The document content that this draft is a revision of.
+    pub document_content: Option<DocumentContent>,
+    /// The identifier of the document content that this draft is a revision of.
+    pub document_content_id: Option<String>,
+    /// The draft content state as a base64-encoded Yjs state update. This represents the user's in-progress edits that have not yet been applied to the live document.
+    pub content_state: Option<String>,
+    /// The user who created or owns this draft.
+    pub user: Option<User>,
+    /// The identifier of the user who owns this draft.
+    pub user_id: Option<String>,
 }
-impl GraphQLFields for DocumentContentHistoryEdge {
+impl GraphQLFields for DocumentContentDraft {
     type FullType = Self;
     fn selection() -> String {
-        "cursor".into()
+        "id createdAt updatedAt archivedAt documentContentId contentState userId".into()
     }
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct DocumentContentHistoryPayload {
     /// The document content history entries.
-    pub history: Option<Box<Vec<DocumentContentHistoryType>>>,
+    pub history: Option<Vec<DocumentContentHistoryType>>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -2340,27 +3332,29 @@ impl GraphQLFields for DocumentContentHistoryPayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct DocumentContentHistoryType {
-    /// The UUID of the document content history entry.
+    /// The unique identifier of the document content history entry.
     pub id: Option<String>,
-    /// The date when the document content history entry was created.
+    /// The date when this document content history entry record was created.
     pub created_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The date when the document content history snapshot was taken. This can be different than createdAt since the content is captured from its state at the previously known updatedAt timestamp in the case of an update. On document create, these timestamps can be the same.
+    /// The timestamp of the document content state when this snapshot was captured. This can differ from createdAt because the content is captured from its state at the previously known updatedAt timestamp in the case of an update. On document creation, these timestamps can be identical.
     pub content_data_snapshot_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// `Internal` The document content as Prosemirror document.
+    /// `Internal` The document content as a ProseMirror document at the time this history entry was captured.
     pub content_data: Option<serde_json::Value>,
-    /// The ID of the author of the change.
+    /// IDs of users whose edits are included in this history entry.
     pub actor_ids: Option<Vec<String>>,
+    /// Metadata associated with the history entry, including content diffs and AI-generated change summaries.
+    pub metadata: Option<serde_json::Value>,
 }
 impl GraphQLFields for DocumentContentHistoryType {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt contentDataSnapshotAt contentData actorIds".into()
+        "id createdAt contentDataSnapshotAt contentData actorIds metadata".into()
     }
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct DocumentEdge {
-    pub node: Option<Box<Document>>,
+    pub node: Option<Document>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -2370,7 +3364,7 @@ impl GraphQLFields for DocumentEdge {
         "cursor".into()
     }
 }
-/// A document related notification.
+/// A notification related to a document, such as comments, mentions, content changes, or document lifecycle events.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct DocumentNotification {
@@ -2389,22 +3383,21 @@ pub struct DocumentNotification {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Notification type.
+    /// Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated.
     pub r#type: Option<String>,
-    /// The user that caused the notification.
-    pub actor: Option<Box<User>>,
-    /// The external user that caused the notification.
-    pub external_user_actor: Option<Box<ExternalUser>>,
-    /// The user that received the notification.
-    pub user: Option<Box<User>>,
-    /// The time at when the user marked the notification as read. Null, if the the user hasn't read the notification
+    /// The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event.
+    pub actor: Option<User>,
+    /// The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member.
+    pub external_user_actor: Option<ExternalUser>,
+    /// The recipient user of this notification.
+    pub user: Option<User>,
+    /// The time at which the user marked the notification as read. Null if the notification is unread.
     pub read_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at when an email reminder for this notification was sent to the user. Null, if no email
-    /// reminder has been sent.
+    /// The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent.
     pub emailed_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time until a notification will be snoozed. After that it will appear in the inbox again.
+    /// The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed.
     pub snoozed_until_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which a notification was unsnoozed..
+    /// The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed.
     pub unsnoozed_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The category of the notification.
     pub category: Option<NotificationCategory>,
@@ -2435,7 +3428,7 @@ pub struct DocumentNotification {
     /// `Internal` Priority of the notification with the same grouping key. Higher number means higher priority. If priority is the same, notifications should be sorted by `createdAt`.
     pub grouping_priority: Option<f64>,
     /// The bot that caused the notification.
-    pub bot_actor: Option<Box<ActorBot>>,
+    pub bot_actor: Option<ActorBot>,
     /// Related document ID.
     pub document_id: Option<String>,
 }
@@ -2446,13 +3439,14 @@ impl GraphQLFields for DocumentNotification {
             .into()
     }
 }
+/// The result of a document mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct DocumentPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The document that was created or updated.
-    pub document: Option<Box<Document>>,
+    pub document: Option<Document>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -2465,12 +3459,12 @@ impl GraphQLFields for DocumentPayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct DocumentSearchPayload {
-    pub edges: Option<Box<Vec<DocumentSearchResultEdge>>>,
-    pub nodes: Option<Box<Vec<DocumentSearchResult>>>,
-    pub page_info: Option<Box<PageInfo>>,
-    /// Archived entities matching the search term along with all their dependencies.
-    pub archive_payload: Option<Box<ArchiveResponse>>,
-    /// Total number of results for query without filters applied.
+    pub edges: Option<Vec<DocumentSearchResultEdge>>,
+    pub nodes: Option<Vec<DocumentSearchResult>>,
+    pub page_info: Option<PageInfo>,
+    /// Archived entities matching the search term along with all their dependencies, serialized for the client sync engine.
+    pub archive_payload: Option<ArchiveResponse>,
+    /// Total number of matching results before pagination is applied.
     pub total_count: Option<f64>,
 }
 impl GraphQLFields for DocumentSearchPayload {
@@ -2491,43 +3485,45 @@ pub struct DocumentSearchResult {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The document title.
+    /// The title of the document. An empty string indicates an untitled document.
     pub title: Option<String>,
-    /// The icon of the document.
+    /// `Internal` A one-sentence AI-generated summary of the document content. Null if no summary has been generated.
+    pub summary: Option<String>,
+    /// The icon of the document, either a decorative icon type or an emoji string. Null if no icon has been set.
     pub icon: Option<String>,
-    /// The color of the icon.
+    /// The hex color of the document icon. Null if no custom color has been set.
     pub color: Option<String>,
-    /// The user who created the document.
-    pub creator: Option<Box<User>>,
-    /// The user who last updated the document.
-    pub updated_by: Option<Box<User>>,
-    /// The project that the document is associated with.
-    pub project: Option<Box<Project>>,
-    /// The initiative that the document is associated with.
-    pub initiative: Option<Box<Initiative>>,
-    /// `Internal` The team that the document is associated with.
-    pub team: Option<Box<Team>>,
-    /// The issue that the document is associated with.
-    pub issue: Option<Box<Issue>>,
-    /// `Internal` The release that the document is associated with.
-    pub release: Option<Box<Release>>,
-    /// `Internal` The cycle that the document is associated with.
-    pub cycle: Option<Box<Cycle>>,
-    /// The document's unique URL slug.
+    /// The user who created the document. Null if the creator's account has been deleted.
+    pub creator: Option<User>,
+    /// The user who last updated the document. Null if the user's account has been deleted.
+    pub updated_by: Option<User>,
+    /// The project that the document is associated with. Null if the document belongs to a different parent entity type.
+    pub project: Option<Project>,
+    /// The initiative that the document is associated with. Null if the document belongs to a different parent entity type.
+    pub initiative: Option<Initiative>,
+    /// `Internal` The team that the document is associated with. Null if the document belongs to a different parent entity type.
+    pub team: Option<Team>,
+    /// The issue that the document is associated with. Null if the document belongs to a different parent entity type.
+    pub issue: Option<Issue>,
+    /// `Internal` The release that the document is associated with. Null if the document belongs to a different parent entity type.
+    pub release: Option<Release>,
+    /// `Internal` The cycle that the document is associated with. Null if the document belongs to a different parent entity type.
+    pub cycle: Option<Cycle>,
+    /// The document's unique URL slug, used to construct human-readable URLs.
     pub slug_id: Option<String>,
-    /// The last template that was applied to this document.
-    pub last_applied_template: Option<Box<Template>>,
-    /// The time at which the document was hidden. Null if the entity has not been hidden.
+    /// The last template that was applied to this document. Null if no template has been applied.
+    pub last_applied_template: Option<Template>,
+    /// The time at which the document was hidden from the default view. Null if the document has not been hidden.
     pub hidden_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// A flag that indicates whether the document is in the trash bin.
+    /// A flag that indicates whether the document is in the trash bin. Trashed documents are archived and can be restored.
     pub trashed: Option<bool>,
-    /// The order of the item in the resources list.
+    /// The sort order of the document in its parent entity's resources list. This order is shared with other resource types such as external links.
     pub sort_order: Option<f64>,
     /// Comments associated with the document.
-    pub comments: Option<Box<CommentConnection>>,
-    /// The documents content in markdown format.
+    pub comments: Option<CommentConnection>,
+    /// The document's content in markdown format.
     pub content: Option<String>,
-    /// `Internal` The documents content as YJS state.
+    /// `Internal` The document's content as a base64-encoded Yjs state update.
     pub content_state: Option<String>,
     /// The ID of the document content associated with the document.
     pub document_content_id: Option<String>,
@@ -2539,14 +3535,14 @@ pub struct DocumentSearchResult {
 impl GraphQLFields for DocumentSearchResult {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt title icon color slugId hiddenAt trashed sortOrder content contentState documentContentId url metadata"
+        "id createdAt updatedAt archivedAt title summary icon color slugId hiddenAt trashed sortOrder content contentState documentContentId url metadata"
             .into()
     }
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct DocumentSearchResultEdge {
-    pub node: Option<Box<DocumentSearchResult>>,
+    pub node: Option<DocumentSearchResult>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -2556,7 +3552,7 @@ impl GraphQLFields for DocumentSearchResultEdge {
         "cursor".into()
     }
 }
-/// A general purpose draft. Used for comments, project updates, etc.
+/// A general-purpose draft for unsaved content. Drafts store in-progress text for comments, project updates, initiative updates, posts, pull request comments, and customer needs. Each draft belongs to a user and is associated with exactly one parent entity. Drafts are automatically deleted when the user publishes the corresponding comment or update.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Draft {
@@ -2569,36 +3565,36 @@ pub struct Draft {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The text content as a Prosemirror document.
+    /// The draft text content as a ProseMirror document.
     pub body_data: Option<serde_json::Value>,
-    /// Additional properties for the draft.
+    /// Additional properties for the draft, such as generation metadata for AI-generated drafts, health status for project updates, or post titles.
     pub data: Option<serde_json::Value>,
     /// Whether the draft was autogenerated for the user.
     pub is_autogenerated: Option<bool>,
     /// `INTERNAL` Whether the draft was ported from a local draft.
     pub was_local_draft: Option<bool>,
     /// The user who created the draft.
-    pub user: Option<Box<User>>,
-    /// The issue for which this is a draft comment.
-    pub issue: Option<Box<Issue>>,
-    /// The project for which this is a draft project update.
-    pub project: Option<Box<Project>>,
-    /// The project update for which this is a draft comment.
-    pub project_update: Option<Box<ProjectUpdate>>,
-    /// The initiative for which this is a draft initiative update.
-    pub initiative: Option<Box<Initiative>>,
-    /// The initiative update for which this is a draft comment.
-    pub initiative_update: Option<Box<InitiativeUpdate>>,
-    /// The post for which this is a draft comment.
-    pub post: Option<Box<Post>>,
-    /// The comment for which this is a draft comment reply.
-    pub parent_comment: Option<Box<Comment>>,
-    /// The customer need that this draft is referencing.
-    pub customer_need: Option<Box<CustomerNeed>>,
+    pub user: Option<User>,
+    /// The issue for which this is a draft comment. Null if the draft belongs to a different parent entity type.
+    pub issue: Option<Issue>,
+    /// The project for which this is a draft comment or project update. Null if the draft belongs to a different parent entity type.
+    pub project: Option<Project>,
+    /// The project update for which this is a draft comment. Null if the draft belongs to a different parent entity type.
+    pub project_update: Option<ProjectUpdate>,
+    /// The initiative for which this is a draft comment or initiative update. Null if the draft belongs to a different parent entity type.
+    pub initiative: Option<Initiative>,
+    /// The initiative update for which this is a draft comment. Null if the draft belongs to a different parent entity type.
+    pub initiative_update: Option<InitiativeUpdate>,
+    /// The post for which this is a draft comment. Null if the draft belongs to a different parent entity type.
+    pub post: Option<Post>,
+    /// The parent comment for which this is a draft reply. Null if the draft is a top-level comment or belongs to a different parent entity type.
+    pub parent_comment: Option<Comment>,
+    /// The customer need that this draft is referencing. Null if the draft belongs to a different parent entity type.
+    pub customer_need: Option<CustomerNeed>,
     /// `INTERNAL` Allows for multiple drafts per entity (currently constrained to Pull Requests).
     pub anchor: Option<String>,
-    /// The team for which this is a draft post.
-    pub team: Option<Box<Team>>,
+    /// The team for which this is a draft post. Null if the draft belongs to a different parent entity type.
+    pub team: Option<Team>,
 }
 impl GraphQLFields for Draft {
     type FullType = Self;
@@ -2610,9 +3606,9 @@ impl GraphQLFields for Draft {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct DraftConnection {
-    pub edges: Option<Box<Vec<DraftEdge>>>,
-    pub nodes: Option<Box<Vec<Draft>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<DraftEdge>>,
+    pub nodes: Option<Vec<Draft>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for DraftConnection {
     type FullType = Self;
@@ -2623,7 +3619,7 @@ impl GraphQLFields for DraftConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct DraftEdge {
-    pub node: Option<Box<Draft>>,
+    pub node: Option<Draft>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -2633,7 +3629,7 @@ impl GraphQLFields for DraftEdge {
         "cursor".into()
     }
 }
-/// An email address that can be used for submitting issues.
+/// An email address that creates Linear issues when emails are sent to it. Email intake addresses can be scoped to a specific team or issue template, and support configurable auto-reply messages for issue creation, completion, and cancellation events. They can also be configured for the Asks web form feature, enabling external users to submit requests via email.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct EmailIntakeAddress {
@@ -2646,7 +3642,7 @@ pub struct EmailIntakeAddress {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Unique email address user name (before @) used for incoming email.
+    /// The unique local part (before the @) of the intake email address, used to route incoming emails to the correct intake handler.
     pub address: Option<String>,
     /// The type of the email address.
     pub r#type: Option<EmailIntakeAddressType>,
@@ -2661,16 +3657,16 @@ pub struct EmailIntakeAddress {
     /// Whether the commenter's name is included in the email replies.
     pub use_user_names_in_replies: Option<bool>,
     /// The template that the email address is associated with.
-    pub template: Option<Box<Template>>,
+    pub template: Option<Template>,
     /// The team that the email address is associated with.
-    pub team: Option<Box<Team>>,
-    /// The organization that the email address is associated with.
-    pub organization: Option<Box<Organization>>,
+    pub team: Option<Team>,
+    /// The workspace that the email address is associated with.
+    pub organization: Option<Organization>,
     /// The SES domain identity that the email address is associated with.
-    pub ses_domain_identity: Option<Box<SesDomainIdentity>>,
+    pub ses_domain_identity: Option<SesDomainIdentity>,
     /// The user who created the email intake address.
-    pub creator: Option<Box<User>>,
-    /// Whether issues created from that email address will be turned into customer requests.
+    pub creator: Option<User>,
+    /// Whether issues created from emails sent to this address are automatically converted into customer requests, linking the sender as a customer contact.
     pub customer_requests_enabled: Option<bool>,
     /// The auto-reply message for issue created. If not set, the default reply will be used.
     pub issue_created_auto_reply: Option<String>,
@@ -2684,21 +3680,24 @@ pub struct EmailIntakeAddress {
     pub issue_canceled_auto_reply_enabled: Option<bool>,
     /// The auto-reply message for issue canceled. If not set, the default reply will be used.
     pub issue_canceled_auto_reply: Option<String>,
+    /// Whether to reopen completed or canceled issues when a substantive email reply is received.
+    pub reopen_on_reply: Option<bool>,
 }
 impl GraphQLFields for EmailIntakeAddress {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt address type forwardingEmailAddress senderName enabled repliesEnabled useUserNamesInReplies customerRequestsEnabled issueCreatedAutoReply issueCreatedAutoReplyEnabled issueCompletedAutoReplyEnabled issueCompletedAutoReply issueCanceledAutoReplyEnabled issueCanceledAutoReply"
+        "id createdAt updatedAt archivedAt address type forwardingEmailAddress senderName enabled repliesEnabled useUserNamesInReplies customerRequestsEnabled issueCreatedAutoReply issueCreatedAutoReplyEnabled issueCompletedAutoReplyEnabled issueCompletedAutoReply issueCanceledAutoReplyEnabled issueCanceledAutoReply reopenOnReply"
             .into()
     }
 }
+/// The result of an email intake address mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct EmailIntakeAddressPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The email address that was created or updated.
-    pub email_intake_address: Option<Box<EmailIntakeAddress>>,
+    pub email_intake_address: Option<EmailIntakeAddress>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -2708,6 +3707,7 @@ impl GraphQLFields for EmailIntakeAddressPayload {
         "lastSyncId success".into()
     }
 }
+/// The result of an email unsubscribe mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct EmailUnsubscribePayload {
@@ -2734,7 +3734,7 @@ impl GraphQLFields for EmailUserAccountAuthChallengeResponse {
         "success authType".into()
     }
 }
-/// A custom emoji.
+/// A custom emoji defined in the workspace. Custom emojis are uploaded by users and can be used in reactions and other places where standard emojis are supported. Each emoji has a unique name within the workspace.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Emoji {
@@ -2747,16 +3747,16 @@ pub struct Emoji {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The emoji's name.
+    /// The unique name of the custom emoji within the workspace.
     pub name: Option<String>,
-    /// The emoji image URL.
+    /// The URL of the uploaded image for this custom emoji.
     pub url: Option<String>,
-    /// The source of the emoji.
+    /// The source of the emoji, indicating how it was created (e.g., uploaded by a user or imported).
     pub source: Option<String>,
     /// The user who created the emoji.
-    pub creator: Option<Box<User>>,
-    /// The organization that the emoji belongs to.
-    pub organization: Option<Box<Organization>>,
+    pub creator: Option<User>,
+    /// The workspace that the emoji belongs to.
+    pub organization: Option<Organization>,
 }
 impl GraphQLFields for Emoji {
     type FullType = Self;
@@ -2767,9 +3767,9 @@ impl GraphQLFields for Emoji {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct EmojiConnection {
-    pub edges: Option<Box<Vec<EmojiEdge>>>,
-    pub nodes: Option<Box<Vec<Emoji>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<EmojiEdge>>,
+    pub nodes: Option<Vec<Emoji>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for EmojiConnection {
     type FullType = Self;
@@ -2780,7 +3780,7 @@ impl GraphQLFields for EmojiConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct EmojiEdge {
-    pub node: Option<Box<Emoji>>,
+    pub node: Option<Emoji>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -2790,13 +3790,14 @@ impl GraphQLFields for EmojiEdge {
         "cursor".into()
     }
 }
+/// The result of a custom emoji mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct EmojiPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The emoji that was created.
-    pub emoji: Option<Box<Emoji>>,
+    pub emoji: Option<Emoji>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -2806,7 +3807,7 @@ impl GraphQLFields for EmojiPayload {
         "lastSyncId success".into()
     }
 }
-/// An external link for an entity like initiative, etc...
+/// An external link attached to a Linear entity such as an initiative, project, team, release, or cycle. External links provide a way to reference related resources outside of Linear (e.g., documentation, design files, dashboards) directly from the entity's resources section. Each link has a URL, display label, and sort order within its parent entity.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct EntityExternalLink {
@@ -2823,12 +3824,12 @@ pub struct EntityExternalLink {
     pub url: Option<String>,
     /// The link's label.
     pub label: Option<String>,
-    /// The order of the item in the resources list.
+    /// The sort order of this link within the parent entity's resources list. Links are sorted together with documents and other resources attached to the entity.
     pub sort_order: Option<f64>,
     /// The user who created the link.
-    pub creator: Option<Box<User>>,
+    pub creator: Option<User>,
     /// The initiative that the link is associated with.
-    pub initiative: Option<Box<Initiative>>,
+    pub initiative: Option<Initiative>,
 }
 impl GraphQLFields for EntityExternalLink {
     type FullType = Self;
@@ -2839,9 +3840,9 @@ impl GraphQLFields for EntityExternalLink {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct EntityExternalLinkConnection {
-    pub edges: Option<Box<Vec<EntityExternalLinkEdge>>>,
-    pub nodes: Option<Box<Vec<EntityExternalLink>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<EntityExternalLinkEdge>>,
+    pub nodes: Option<Vec<EntityExternalLink>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for EntityExternalLinkConnection {
     type FullType = Self;
@@ -2852,7 +3853,7 @@ impl GraphQLFields for EntityExternalLinkConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct EntityExternalLinkEdge {
-    pub node: Option<Box<EntityExternalLink>>,
+    pub node: Option<EntityExternalLink>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -2862,13 +3863,14 @@ impl GraphQLFields for EntityExternalLinkEdge {
         "cursor".into()
     }
 }
+/// The result of an entity external link mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct EntityExternalLinkPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The link that was created or updated.
-    pub entity_external_link: Option<Box<EntityExternalLink>>,
+    pub entity_external_link: Option<EntityExternalLink>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -2878,13 +3880,25 @@ impl GraphQLFields for EntityExternalLinkPayload {
         "lastSyncId success".into()
     }
 }
-/// Information about an external entity.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct EventTrackingPayload {
+    /// Whether the operation was successful.
+    pub success: Option<bool>,
+}
+impl GraphQLFields for EventTrackingPayload {
+    type FullType = Self;
+    fn selection() -> String {
+        "success".into()
+    }
+}
+/// Information about an entity in an external system that is linked to a Linear entity. Provides the external ID, the service it belongs to, and optional service-specific metadata.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ExternalEntityInfo {
-    /// The id of the external entity.
+    /// The unique identifier of the entity in the external system (e.g., the Jira issue ID, GitHub issue node ID, or Slack message timestamp).
     pub id: Option<String>,
-    /// The name of the service this entity is synced with.
+    /// The external service that this entity belongs to (e.g., jira, github, slack).
     pub service: Option<ExternalSyncService>,
 }
 impl GraphQLFields for ExternalEntityInfo {
@@ -2946,7 +3960,7 @@ impl GraphQLFields for ExternalEntitySlackMetadata {
         "isFromSlack channelId channelName messageUrl".into()
     }
 }
-/// An external authenticated (e.g., through Slack) user which doesn't have a Linear account, but can create and update entities in Linear from the external system that authenticated them.
+/// An external user who interacts with Linear through an integrated external service (such as Slack, Jira, GitHub, GitLab, Salesforce, or Microsoft Teams) but does not have a Linear account. External users can create issues, post comments, and add reactions from their respective platforms. They are identified by service-specific user IDs and may optionally have an email address. External users are scoped to a single workspace.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ExternalUser {
@@ -2961,15 +3975,15 @@ pub struct ExternalUser {
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The external user's full name.
     pub name: Option<String>,
-    /// The external user's display name. Unique within each organization. Can match the display name of an actual user.
+    /// The external user's display name. Unique within each workspace. Can match the display name of an actual user.
     pub display_name: Option<String>,
     /// The external user's email address.
     pub email: Option<String>,
-    /// An URL to the external user's avatar image.
+    /// A URL to the external user's avatar image. Null if no avatar is available from the external service.
     pub avatar_url: Option<String>,
-    /// Organization the external user belongs to.
+    /// The workspace that the external user belongs to.
     pub organization: Option<Box<Organization>>,
-    /// The last time the external user was seen interacting with Linear.
+    /// The last time the external user was seen interacting with Linear through their external service. Defaults to the creation time and is updated on subsequent interactions.
     pub last_seen: Option<chrono::DateTime<chrono::Utc>>,
 }
 impl GraphQLFields for ExternalUser {
@@ -2981,9 +3995,9 @@ impl GraphQLFields for ExternalUser {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ExternalUserConnection {
-    pub edges: Option<Box<Vec<ExternalUserEdge>>>,
-    pub nodes: Option<Box<Vec<ExternalUser>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<ExternalUserEdge>>,
+    pub nodes: Option<Vec<ExternalUser>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for ExternalUserConnection {
     type FullType = Self;
@@ -2994,7 +4008,7 @@ impl GraphQLFields for ExternalUserConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ExternalUserEdge {
-    pub node: Option<Box<ExternalUser>>,
+    pub node: Option<ExternalUser>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -3004,7 +4018,7 @@ impl GraphQLFields for ExternalUserEdge {
         "cursor".into()
     }
 }
-/// A facet. Facets are joins between entities. A facet can tie a custom view to a project, or a a project to a roadmap for example.
+/// A facet representing a join between entities. Facets connect a custom view to an owning entity such as a project, initiative, team page, workspace page, or user feed. They control the order of views within their parent via the sortOrder field. Exactly one source entity and one target entity must be set.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Facet {
@@ -3017,21 +4031,21 @@ pub struct Facet {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The sort order of the facet.
+    /// The sort order of the facet within its owning entity scope. Lower values appear first. Sort order is scoped by the source entity (e.g., all facets on a project are sorted independently from facets on an initiative).
     pub sort_order: Option<f64>,
-    /// The owning organization.
+    /// The owning organization. Set for workspace-level facets that are not scoped to a specific team, project, or initiative.
     pub source_organization: Option<Box<Organization>>,
-    /// The owning team.
+    /// The owning team. Set when this facet represents a view on a team-level page.
     pub source_team: Option<Box<Team>>,
-    /// The owning project.
+    /// The owning project. Set when this facet represents a view tab on a project.
     pub source_project: Option<Box<Project>>,
-    /// The owning initiative.
+    /// The owning initiative. Set when this facet represents a view tab on an initiative.
     pub source_initiative: Option<Box<Initiative>>,
-    /// The owning feed user.
+    /// The user whose feed this facet belongs to. Set when this facet represents a view in a user's personal feed.
     pub source_feed_user: Option<Box<User>>,
-    /// The owning page.
+    /// The fixed page type (e.g., projects, issues) that this facet is displayed on. Used together with sourceOrganizationId or sourceTeamId to place a view on a specific page at the workspace or team level.
     pub source_page: Option<FacetPageSource>,
-    /// The targeted custom view.
+    /// The custom view that this facet points to. Each facet targets exactly one custom view, establishing a one-to-one relationship.
     pub target_custom_view: Option<Box<CustomView>>,
 }
 impl GraphQLFields for Facet {
@@ -3043,9 +4057,9 @@ impl GraphQLFields for Facet {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct FacetConnection {
-    pub edges: Option<Box<Vec<FacetEdge>>>,
-    pub nodes: Option<Box<Vec<Facet>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<FacetEdge>>,
+    pub nodes: Option<Vec<Facet>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for FacetConnection {
     type FullType = Self;
@@ -3056,7 +4070,7 @@ impl GraphQLFields for FacetConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct FacetEdge {
-    pub node: Option<Box<Facet>>,
+    pub node: Option<Facet>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -3066,7 +4080,7 @@ impl GraphQLFields for FacetEdge {
         "cursor".into()
     }
 }
-/// User favorites presented in the sidebar.
+/// A user's bookmarked item that appears in their sidebar for quick access. Favorites can reference various entity types including issues, projects, cycles, views, documents, initiatives, labels, users, customers, dashboards, and pull requests. Favorites can be organized into folders and ordered by the user. Each favorite is owned by a single user and links to exactly one target entity (or is a folder containing other favorites).
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Favorite {
@@ -3079,24 +4093,24 @@ pub struct Favorite {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The type of the favorite.
+    /// The type of entity this favorite references, such as 'issue', 'project', 'cycle', 'customView', 'document', 'folder', etc. Determines which associated entity field is populated.
     pub r#type: Option<String>,
-    /// The parent folder of the favorite.
+    /// The parent folder of the favorite. Null if the favorite is at the top level of the sidebar. Only favorites of type 'folder' can be parents.
     pub parent: Option<Box<Favorite>>,
     /// The name of the folder. Only applies to favorites of type folder.
     pub folder_name: Option<String>,
     /// The targeted tab of the project.
     pub project_tab: Option<ProjectTab>,
-    /// The type of favorited predefined view.
+    /// The type of favorited predefined view (e.g., 'allIssues', 'activeCycle', 'backlog', 'triage'). Only populated when the favorite type is 'predefinedView'.
     pub predefined_view_type: Option<String>,
     /// The targeted tab of the initiative.
     pub initiative_tab: Option<InitiativeTab>,
-    /// The owner of the favorite.
+    /// The user who owns this favorite. Favorites are personal and only visible to their owner.
     pub owner: Option<Box<User>>,
-    /// The order of the item in the favorites list.
+    /// The position of this item in the user's favorites list. Lower values appear first. Used to maintain user-defined ordering within the sidebar.
     pub sort_order: Option<f64>,
     /// Children of the favorite. Only applies to favorites of type folder.
-    pub children: Option<Box<FavoriteConnection>>,
+    pub children: Option<FavoriteConnection>,
     /// The favorited issue.
     pub issue: Option<Box<Issue>>,
     /// The favorited project.
@@ -3130,7 +4144,7 @@ pub struct Favorite {
     /// `ALPHA` The favorited release.
     pub release: Option<Box<Release>>,
     /// `ALPHA` The favorited release pipeline.
-    pub release_pipeline: Option<Box<ReleasePipeline>>,
+    pub release_pipeline: Option<ReleasePipeline>,
     /// URL of the favorited entity. Folders return 'null' value.
     pub url: Option<String>,
     /// `Internal` Favorite's title text (name of the favorite'd object or folder).
@@ -3152,9 +4166,9 @@ impl GraphQLFields for Favorite {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct FavoriteConnection {
-    pub edges: Option<Box<Vec<FavoriteEdge>>>,
-    pub nodes: Option<Box<Vec<Favorite>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<FavoriteEdge>>,
+    pub nodes: Option<Vec<Favorite>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for FavoriteConnection {
     type FullType = Self;
@@ -3165,7 +4179,7 @@ impl GraphQLFields for FavoriteConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct FavoriteEdge {
-    pub node: Option<Box<Favorite>>,
+    pub node: Option<Favorite>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -3175,13 +4189,14 @@ impl GraphQLFields for FavoriteEdge {
         "cursor".into()
     }
 }
+/// Return type for favorite mutations.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct FavoritePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    /// The object that was added as a favorite.
-    pub favorite: Option<Box<Favorite>>,
+    /// The favorite that was created or updated.
+    pub favorite: Option<Favorite>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -3191,7 +4206,7 @@ impl GraphQLFields for FavoritePayload {
         "lastSyncId success".into()
     }
 }
-/// `Internal` An item in a users feed.
+/// `Internal` An item in a user's activity feed. Feed items represent project updates, initiative updates, or posts that appear in a user's personalized feed based on their team memberships and feed subscriptions. Each feed item references exactly one content entity. Feed items older than 6 months are automatically archived.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct FeedItem {
@@ -3204,18 +4219,18 @@ pub struct FeedItem {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The organization that will see this feed item.
-    pub organization: Option<Box<Organization>>,
-    /// The user that will see this feed item.
-    pub user: Option<Box<User>>,
-    /// The team that will see this feed item.
-    pub team: Option<Box<Team>>,
-    /// The project update that is in the feed.
-    pub project_update: Option<Box<ProjectUpdate>>,
-    /// The initiative update that is in the feed.
-    pub initiative_update: Option<Box<InitiativeUpdate>>,
-    /// The post that is in the feed.
-    pub post: Option<Box<Post>>,
+    /// The organization this feed item belongs to.
+    pub organization: Option<Organization>,
+    /// The specific user this feed item is targeted to. Null if the feed item is targeted to a team or organization rather than an individual user.
+    pub user: Option<User>,
+    /// The team this feed item is associated with. Null if the feed item is not team-scoped.
+    pub team: Option<Team>,
+    /// The project update referenced by this feed item. Null if the feed item references a different content type.
+    pub project_update: Option<ProjectUpdate>,
+    /// The initiative update referenced by this feed item. Null if the feed item references a different content type.
+    pub initiative_update: Option<InitiativeUpdate>,
+    /// The post referenced by this feed item. Null if the feed item references a different content type.
+    pub post: Option<Post>,
 }
 impl GraphQLFields for FeedItem {
     type FullType = Self;
@@ -3226,9 +4241,9 @@ impl GraphQLFields for FeedItem {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct FeedItemConnection {
-    pub edges: Option<Box<Vec<FeedItemEdge>>>,
-    pub nodes: Option<Box<Vec<FeedItem>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<FeedItemEdge>>,
+    pub nodes: Option<Vec<FeedItem>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for FeedItemConnection {
     type FullType = Self;
@@ -3239,7 +4254,7 @@ impl GraphQLFields for FeedItemConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct FeedItemEdge {
-    pub node: Option<Box<FeedItem>>,
+    pub node: Option<FeedItem>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -3249,14 +4264,15 @@ impl GraphQLFields for FeedItemEdge {
         "cursor".into()
     }
 }
+/// The result of a data fetch query using natural language.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct FetchDataPayload {
-    /// The fetched data based on the natural language query.
+    /// The fetched data as a JSON object. The shape depends on the natural language query and the resolved GraphQL query. Null if the query returned no results.
     pub data: Option<serde_json::Value>,
-    /// The GraphQL query used to fetch the data.
+    /// The GraphQL query that was generated from the natural language input and executed to produce the data. Useful for debugging or reusing the query directly.
     pub query: Option<String>,
-    /// The filters used to fetch the data.
+    /// The filter variables that were generated and applied to the GraphQL query. Null if no filters were needed.
     pub filters: Option<serde_json::Value>,
     /// Whether the fetch operation was successful.
     pub success: Option<bool>,
@@ -3279,13 +4295,14 @@ impl GraphQLFields for FileUploadDeletePayload {
         "success".into()
     }
 }
+/// The result of a Front attachment mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct FrontAttachmentPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The issue attachment that was created.
-    pub attachment: Option<Box<Attachment>>,
+    pub attachment: Option<Attachment>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -3295,7 +4312,7 @@ impl GraphQLFields for FrontAttachmentPayload {
         "lastSyncId success".into()
     }
 }
-/// A trigger that updates the issue status according to Git automations.
+/// A Git automation rule that automatically transitions issues to a specified workflow state when a Git event occurs (e.g., when a PR is opened, move the linked issue to 'In Review'). Each rule is scoped to a team and optionally to a specific target branch. When no target branch is specified, the rule acts as the default for all branches. Target-branch-specific rules override the defaults.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct GitAutomationState {
@@ -3308,13 +4325,13 @@ pub struct GitAutomationState {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The associated workflow state.
-    pub state: Option<Box<WorkflowState>>,
-    /// The team to which this automation state belongs.
-    pub team: Option<Box<Team>>,
-    /// The target branch associated to this automation state.
-    pub target_branch: Option<Box<GitAutomationTargetBranch>>,
-    /// The event that triggers the automation.
+    /// The workflow state that linked issues will be transitioned to when the Git event fires. Null if this rule is configured to take no action, overriding any default rule for the same event.
+    pub state: Option<WorkflowState>,
+    /// The team that this automation rule belongs to. Issues must belong to this team for the automation to apply.
+    pub team: Option<Team>,
+    /// The target branch that this automation rule applies to. When set, this rule only fires for pull requests targeting the specified branch pattern, overriding any default rule for the same event. Null if this is a default rule that applies to all branches.
+    pub target_branch: Option<GitAutomationTargetBranch>,
+    /// The Git event that triggers this automation rule (e.g., branch created, PR opened for review, or PR merged).
     pub event: Option<GitAutomationStates>,
     /// `DEPRECATED` The target branch, if null, the automation will be triggered on any branch.
     pub branch_pattern: Option<String>,
@@ -3328,9 +4345,9 @@ impl GraphQLFields for GitAutomationState {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct GitAutomationStateConnection {
-    pub edges: Option<Box<Vec<GitAutomationStateEdge>>>,
-    pub nodes: Option<Box<Vec<GitAutomationState>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<GitAutomationStateEdge>>,
+    pub nodes: Option<Vec<GitAutomationState>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for GitAutomationStateConnection {
     type FullType = Self;
@@ -3341,7 +4358,7 @@ impl GraphQLFields for GitAutomationStateConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct GitAutomationStateEdge {
-    pub node: Option<Box<GitAutomationState>>,
+    pub node: Option<GitAutomationState>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -3351,13 +4368,14 @@ impl GraphQLFields for GitAutomationStateEdge {
         "cursor".into()
     }
 }
+/// The result of a git automation state mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct GitAutomationStatePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The automation state that was created or updated.
-    pub git_automation_state: Option<Box<GitAutomationState>>,
+    pub git_automation_state: Option<GitAutomationState>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -3367,7 +4385,7 @@ impl GraphQLFields for GitAutomationStatePayload {
         "lastSyncId success".into()
     }
 }
-/// A Git target branch for which there are automations (GitAutomationState).
+/// A target branch definition used by Git automation rules to scope automations to specific branches. The branch can be specified as an exact name (e.g., 'main') or as a regular expression pattern (e.g., 'release/.*'). Each target branch belongs to a team and can have multiple automation rules associated with it, which override the team's default automation rules when a PR targets a matching branch.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct GitAutomationTargetBranch {
@@ -3380,14 +4398,14 @@ pub struct GitAutomationTargetBranch {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The team to which this Git target branch automation belongs.
-    pub team: Option<Box<Team>>,
-    /// The target branch pattern.
+    /// The team that this target branch definition belongs to. The branch pattern is unique within a team.
+    pub team: Option<Team>,
+    /// The branch name or pattern to match against pull request target branches. Interpreted as a literal branch name unless isRegex is true, in which case it is treated as a regular expression.
     pub branch_pattern: Option<String>,
-    /// Whether the branch pattern is a regular expression.
+    /// Whether the branch pattern should be interpreted as a regular expression. When false, the pattern is matched as an exact branch name.
     pub is_regex: Option<bool>,
-    /// Automation states associated with the target branch.
-    pub automation_states: Option<Box<GitAutomationStateConnection>>,
+    /// Git automation rules associated with this target branch. These rules override the team's default automation rules when a pull request targets a branch matching this pattern.
+    pub automation_states: Option<GitAutomationStateConnection>,
 }
 impl GraphQLFields for GitAutomationTargetBranch {
     type FullType = Self;
@@ -3395,13 +4413,14 @@ impl GraphQLFields for GitAutomationTargetBranch {
         "id createdAt updatedAt archivedAt branchPattern isRegex".into()
     }
 }
+/// The result of a git automation target branch mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct GitAutomationTargetBranchPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The Git target branch automation that was created or updated.
-    pub target_branch: Option<Box<GitAutomationTargetBranch>>,
+    pub target_branch: Option<GitAutomationTargetBranch>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -3417,7 +4436,7 @@ pub struct GitHubCommitIntegrationPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The integration that was created or updated.
-    pub integration: Option<Box<Integration>>,
+    pub integration: Option<Integration>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The webhook secret to provide to GitHub.
@@ -3447,7 +4466,7 @@ pub struct GitHubEnterpriseServerPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The integration that was created or updated.
-    pub integration: Option<Box<Integration>>,
+    pub integration: Option<Integration>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The setup address.
@@ -3469,7 +4488,7 @@ pub struct GitLabIntegrationCreatePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The integration that was created or updated.
-    pub integration: Option<Box<Integration>>,
+    pub integration: Option<Integration>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The webhook secret to provide to GitLab.
@@ -3493,7 +4512,7 @@ pub struct GitLabTestConnectionPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The integration that was created or updated.
-    pub integration: Option<Box<Integration>>,
+    pub integration: Option<Integration>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// Error message if the connection test failed.
@@ -3509,7 +4528,7 @@ impl GraphQLFields for GitLabTestConnectionPayload {
         "lastSyncId success error errorResponseBody errorResponseHeaders".into()
     }
 }
-/// An identity provider.
+/// A SAML/SSO or web forms identity provider configuration for a workspace. Identity providers enable single sign-on authentication via SAML 2.0 and can optionally support SCIM for automated user provisioning and group-based role mapping. Each workspace can have a default general-purpose identity provider and additional web forms identity providers for Asks web authentication.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IdentityProvider {
@@ -3526,7 +4545,7 @@ pub struct IdentityProvider {
     pub default_migrated: Option<bool>,
     /// The type of identity provider.
     pub r#type: Option<IdentityProviderType>,
-    /// Whether SAML authentication is enabled for organization.
+    /// Whether SAML authentication is enabled for the workspace.
     pub saml_enabled: Option<bool>,
     /// Sign in endpoint URL for the identity provider.
     pub sso_endpoint: Option<String>,
@@ -3542,7 +4561,7 @@ pub struct IdentityProvider {
     pub sp_entity_id: Option<String>,
     /// The SAML priority used to pick default workspace in SAML SP initiated flow, when same domain is claimed for SAML by multiple workspaces. Lower priority value means higher preference.
     pub priority: Option<f64>,
-    /// Whether SCIM provisioning is enabled for organization.
+    /// Whether SCIM provisioning is enabled for the workspace.
     pub scim_enabled: Option<bool>,
     /// `INTERNAL` SCIM owners group push settings.
     pub owners_group_push: Option<serde_json::Value>,
@@ -3576,7 +4595,7 @@ impl GraphQLFields for ImageUploadFromUrlPayload {
         "lastSyncId url success".into()
     }
 }
-/// An initiative to group projects.
+/// An initiative is a high-level strategic grouping of projects toward a business goal. Initiatives can contain multiple projects, have their own status updates and health tracking, and can be organized hierarchically with parent-child relationships.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Initiative {
@@ -3603,64 +4622,64 @@ pub struct Initiative {
     pub name: Option<String>,
     /// The description of the initiative.
     pub description: Option<String>,
-    /// The organization of the initiative.
+    /// The workspace of the initiative.
     pub organization: Option<Box<Organization>>,
     /// The user who created the initiative.
     pub creator: Option<Box<User>>,
-    /// The user who owns the initiative.
+    /// The user who owns the initiative. The owner is typically responsible for posting status updates and driving the initiative to completion. Null if no owner is assigned.
     pub owner: Option<Box<User>>,
-    /// The initiative's unique URL slug.
+    /// The initiative's unique URL slug, used to construct human-readable URLs.
     pub slug_id: Option<String>,
-    /// The sort order of the initiative within the organization.
+    /// The sort order of the initiative within the workspace.
     pub sort_order: Option<f64>,
     /// The initiative's color.
     pub color: Option<String>,
-    /// The icon of the initiative.
+    /// The icon of the initiative. Can be an emoji or a decorative icon type.
     pub icon: Option<String>,
     /// A flag that indicates whether the initiative is in the trash bin.
     pub trashed: Option<bool>,
-    /// `Internal` Facets associated with the initiative.
-    pub facets: Option<Box<Vec<Facet>>>,
-    /// The estimated completion date of the initiative.
+    /// `Internal` Facets associated with the initiative, used for filtering and categorization.
+    pub facets: Option<Vec<Facet>>,
+    /// The estimated completion date of the initiative. Null if no target date is set.
     pub target_date: Option<chrono::NaiveDate>,
-    /// The resolution of the initiative's estimated completion date.
+    /// The resolution of the initiative's estimated completion date, indicating whether it refers to a specific day, week, month, quarter, or year.
     pub target_date_resolution: Option<DateResolutionType>,
-    /// The status of the initiative. One of Planned, Active, Completed
+    /// The lifecycle status of the initiative. One of Planned, Active, Completed.
     pub status: Option<InitiativeStatus>,
-    /// The last initiative update posted for this initiative.
+    /// The most recent status update posted for this initiative. Null if no updates have been posted.
     pub last_update: Option<Box<InitiativeUpdate>>,
-    /// The health of the initiative.
+    /// The overall health of the initiative, derived from the most recent initiative update. Possible values are onTrack, atRisk, or offTrack. Null if no health has been reported.
     pub health: Option<InitiativeUpdateHealthType>,
-    /// The time at which the initiative health was updated.
+    /// The time at which the initiative health was last updated, typically when a new initiative update is posted. Null if health has never been set.
     pub health_updated_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the initiative was moved into active status.
+    /// The time at which the initiative was moved into Active status. Null if the initiative has not been activated.
     pub started_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the initiative was moved into completed status.
+    /// The time at which the initiative was moved into Completed status. Null if the initiative has not been completed.
     pub completed_at: Option<chrono::DateTime<chrono::Utc>>,
     /// Initiative URL.
     pub url: Option<String>,
     /// Projects associated with the initiative.
-    pub projects: Option<Box<ProjectConnection>>,
+    pub projects: Option<ProjectConnection>,
     /// Links associated with the initiative.
-    pub links: Option<Box<EntityExternalLinkConnection>>,
+    pub links: Option<EntityExternalLinkConnection>,
     /// Settings for all integrations associated with that initiative.
     pub integrations_settings: Option<Box<IntegrationsSettings>>,
     /// History entries associated with the initiative.
-    pub history: Option<Box<InitiativeHistoryConnection>>,
+    pub history: Option<InitiativeHistoryConnection>,
     /// Initiative updates associated with the initiative.
-    pub initiative_updates: Option<Box<InitiativeUpdateConnection>>,
+    pub initiative_updates: Option<InitiativeUpdateConnection>,
     /// Sub-initiatives associated with the initiative.
-    pub sub_initiatives: Option<Box<InitiativeConnection>>,
+    pub sub_initiatives: Option<InitiativeConnection>,
     /// Parent initiative associated with the initiative.
     pub parent_initiative: Option<Box<Initiative>>,
     /// `Internal` Parent initiatives associated with the initiative.
-    pub parent_initiatives: Option<Box<InitiativeConnection>>,
+    pub parent_initiatives: Option<InitiativeConnection>,
     /// The initiative's content in markdown format.
     pub content: Option<String>,
     /// The content of the initiative description.
     pub document_content: Option<Box<DocumentContent>>,
     /// Documents associated with the initiative.
-    pub documents: Option<Box<DocumentConnection>>,
+    pub documents: Option<DocumentConnection>,
 }
 impl GraphQLFields for Initiative {
     type FullType = Self;
@@ -3678,7 +4697,7 @@ pub struct InitiativeArchivePayload {
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The archived/unarchived entity. Null if entity was deleted.
-    pub entity: Option<Box<Initiative>>,
+    pub entity: Option<Initiative>,
 }
 impl GraphQLFields for InitiativeArchivePayload {
     type FullType = Self;
@@ -3689,9 +4708,9 @@ impl GraphQLFields for InitiativeArchivePayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeConnection {
-    pub edges: Option<Box<Vec<InitiativeEdge>>>,
-    pub nodes: Option<Box<Vec<Initiative>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<InitiativeEdge>>,
+    pub nodes: Option<Vec<Initiative>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for InitiativeConnection {
     type FullType = Self;
@@ -3702,7 +4721,7 @@ impl GraphQLFields for InitiativeConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeEdge {
-    pub node: Option<Box<Initiative>>,
+    pub node: Option<Initiative>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -3712,7 +4731,7 @@ impl GraphQLFields for InitiativeEdge {
         "cursor".into()
     }
 }
-/// A initiative history containing relevant change events.
+/// A history record associated with an initiative. Tracks changes to initiative properties such as name, status, owner, target date, icon, color, and parent-child relationships over time.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeHistory {
@@ -3727,8 +4746,8 @@ pub struct InitiativeHistory {
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The events that happened while recording that history.
     pub entries: Option<serde_json::Value>,
-    /// The initiative that the history is associated with.
-    pub initiative: Option<Box<Initiative>>,
+    /// The initiative that this history record belongs to.
+    pub initiative: Option<Initiative>,
 }
 impl GraphQLFields for InitiativeHistory {
     type FullType = Self;
@@ -3739,9 +4758,9 @@ impl GraphQLFields for InitiativeHistory {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeHistoryConnection {
-    pub edges: Option<Box<Vec<InitiativeHistoryEdge>>>,
-    pub nodes: Option<Box<Vec<InitiativeHistory>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<InitiativeHistoryEdge>>,
+    pub nodes: Option<Vec<InitiativeHistory>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for InitiativeHistoryConnection {
     type FullType = Self;
@@ -3752,7 +4771,7 @@ impl GraphQLFields for InitiativeHistoryConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeHistoryEdge {
-    pub node: Option<Box<InitiativeHistory>>,
+    pub node: Option<InitiativeHistory>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -3762,7 +4781,7 @@ impl GraphQLFields for InitiativeHistoryEdge {
         "cursor".into()
     }
 }
-/// An initiative related notification.
+/// A notification related to an initiative, such as being added as owner, initiative updates, comments, or mentions.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeNotification {
@@ -3781,22 +4800,21 @@ pub struct InitiativeNotification {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Notification type.
+    /// Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated.
     pub r#type: Option<String>,
-    /// The user that caused the notification.
-    pub actor: Option<Box<User>>,
-    /// The external user that caused the notification.
-    pub external_user_actor: Option<Box<ExternalUser>>,
-    /// The user that received the notification.
-    pub user: Option<Box<User>>,
-    /// The time at when the user marked the notification as read. Null, if the the user hasn't read the notification
+    /// The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event.
+    pub actor: Option<User>,
+    /// The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member.
+    pub external_user_actor: Option<ExternalUser>,
+    /// The recipient user of this notification.
+    pub user: Option<User>,
+    /// The time at which the user marked the notification as read. Null if the notification is unread.
     pub read_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at when an email reminder for this notification was sent to the user. Null, if no email
-    /// reminder has been sent.
+    /// The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent.
     pub emailed_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time until a notification will be snoozed. After that it will appear in the inbox again.
+    /// The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed.
     pub snoozed_until_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which a notification was unsnoozed..
+    /// The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed.
     pub unsnoozed_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The category of the notification.
     pub category: Option<NotificationCategory>,
@@ -3827,21 +4845,21 @@ pub struct InitiativeNotification {
     /// `Internal` Priority of the notification with the same grouping key. Higher number means higher priority. If priority is the same, notifications should be sorted by `createdAt`.
     pub grouping_priority: Option<f64>,
     /// The bot that caused the notification.
-    pub bot_actor: Option<Box<ActorBot>>,
+    pub bot_actor: Option<ActorBot>,
     /// Related initiative ID.
     pub initiative_id: Option<String>,
     /// Related initiative update ID.
     pub initiative_update_id: Option<String>,
     /// The initiative related to the notification.
-    pub initiative: Option<Box<Initiative>>,
+    pub initiative: Option<Initiative>,
     /// The document related to the notification.
-    pub document: Option<Box<Document>>,
+    pub document: Option<Document>,
     /// The initiative update related to the notification.
-    pub initiative_update: Option<Box<InitiativeUpdate>>,
+    pub initiative_update: Option<InitiativeUpdate>,
     /// The comment related to the notification.
-    pub comment: Option<Box<Comment>>,
+    pub comment: Option<Comment>,
     /// The parent comment related to the notification, if a notification is a reply comment notification.
-    pub parent_comment: Option<Box<Comment>>,
+    pub parent_comment: Option<Comment>,
 }
 impl GraphQLFields for InitiativeNotification {
     type FullType = Self;
@@ -3850,7 +4868,7 @@ impl GraphQLFields for InitiativeNotification {
             .into()
     }
 }
-/// An initiative notification subscription.
+/// A notification subscription scoped to a specific initiative. The subscriber receives notifications for events related to this initiative, such as updates, comments, and ownership changes.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeNotificationSubscription {
@@ -3863,31 +4881,31 @@ pub struct InitiativeNotificationSubscription {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The user that subscribed to receive notifications.
-    pub subscriber: Option<Box<User>>,
-    /// The customer associated with the notification subscription.
-    pub customer: Option<Box<Customer>>,
-    /// The contextual custom view associated with the notification subscription.
-    pub custom_view: Option<Box<CustomView>>,
-    /// The contextual cycle view associated with the notification subscription.
-    pub cycle: Option<Box<Cycle>>,
-    /// The contextual label view associated with the notification subscription.
-    pub label: Option<Box<IssueLabel>>,
-    /// The contextual project view associated with the notification subscription.
-    pub project: Option<Box<Project>>,
+    /// The user who will receive notifications from this subscription.
+    pub subscriber: Option<User>,
+    /// The customer that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub customer: Option<Customer>,
+    /// The custom view that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub custom_view: Option<CustomView>,
+    /// The cycle that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub cycle: Option<Cycle>,
+    /// The issue label that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub label: Option<IssueLabel>,
+    /// The project that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub project: Option<Project>,
     /// The initiative subscribed to.
-    pub initiative: Option<Box<Initiative>>,
-    /// The team associated with the notification subscription.
-    pub team: Option<Box<Team>>,
-    /// The user view associated with the notification subscription.
-    pub user: Option<Box<User>>,
-    /// The type of view to which the notification subscription context is associated with.
+    pub initiative: Option<Initiative>,
+    /// The team that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub team: Option<Team>,
+    /// The user that this notification subscription is scoped to, for user-specific view subscriptions. Null if the subscription targets a different entity type.
+    pub user: Option<User>,
+    /// The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type.
     pub context_view_type: Option<ContextViewType>,
-    /// The type of user view to which the notification subscription context is associated with.
+    /// The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type.
     pub user_context_view_type: Option<UserContextViewType>,
-    /// Whether the subscription is active or not.
+    /// Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists.
     pub active: Option<bool>,
-    /// The type of subscription.
+    /// The notification event types that this subscription will deliver to the subscriber.
     pub notification_subscription_types: Option<Vec<String>>,
 }
 impl GraphQLFields for InitiativeNotificationSubscription {
@@ -3904,7 +4922,7 @@ pub struct InitiativePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The initiative that was created or updated.
-    pub initiative: Option<Box<Initiative>>,
+    pub initiative: Option<Initiative>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -3914,7 +4932,7 @@ impl GraphQLFields for InitiativePayload {
         "lastSyncId success".into()
     }
 }
-/// A relation representing the dependency between two initiatives.
+/// A parent-child relation between two initiatives, forming a hierarchy. The initiative field is the parent and relatedInitiative is the child. Cycles and excessive nesting depth are prevented.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeRelation {
@@ -3927,13 +4945,13 @@ pub struct InitiativeRelation {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The parent initiative.
-    pub initiative: Option<Box<Initiative>>,
-    /// The child initiative.
-    pub related_initiative: Option<Box<Initiative>>,
-    /// The last user who created or modified the relation.
-    pub user: Option<Box<User>>,
-    /// The sort order of the relation within the initiative.
+    /// The parent initiative in this hierarchical relation.
+    pub initiative: Option<Initiative>,
+    /// The child initiative in this hierarchical relation.
+    pub related_initiative: Option<Initiative>,
+    /// The user who last created or modified the relation. Null if the user has been deleted.
+    pub user: Option<User>,
+    /// The sort order of the child initiative within its parent initiative.
     pub sort_order: Option<f64>,
 }
 impl GraphQLFields for InitiativeRelation {
@@ -3945,9 +4963,9 @@ impl GraphQLFields for InitiativeRelation {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeRelationConnection {
-    pub edges: Option<Box<Vec<InitiativeRelationEdge>>>,
-    pub nodes: Option<Box<Vec<InitiativeRelation>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<InitiativeRelationEdge>>,
+    pub nodes: Option<Vec<InitiativeRelation>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for InitiativeRelationConnection {
     type FullType = Self;
@@ -3958,7 +4976,7 @@ impl GraphQLFields for InitiativeRelationConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeRelationEdge {
-    pub node: Option<Box<InitiativeRelation>>,
+    pub node: Option<InitiativeRelation>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -3968,13 +4986,14 @@ impl GraphQLFields for InitiativeRelationEdge {
         "cursor".into()
     }
 }
+/// The result of an initiative relation mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeRelationPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The initiative relation that was created or updated.
-    pub initiative_relation: Option<Box<InitiativeRelation>>,
+    pub initiative_relation: Option<InitiativeRelation>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -3984,7 +5003,7 @@ impl GraphQLFields for InitiativeRelationPayload {
         "lastSyncId success".into()
     }
 }
-/// Join table between projects and initiatives.
+/// The join entity linking a project to an initiative. A project can only appear once in an initiative hierarchy -- it cannot be on both an initiative and one of its ancestor or descendant initiatives.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeToProject {
@@ -3998,10 +5017,10 @@ pub struct InitiativeToProject {
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The project that the initiative is associated with.
-    pub project: Option<Box<Project>>,
+    pub project: Option<Project>,
     /// The initiative that the project is associated with.
-    pub initiative: Option<Box<Initiative>>,
-    /// The sort order of the project within the initiative.
+    pub initiative: Option<Initiative>,
+    /// The sort order of the project within its parent initiative.
     pub sort_order: Option<String>,
 }
 impl GraphQLFields for InitiativeToProject {
@@ -4013,9 +5032,9 @@ impl GraphQLFields for InitiativeToProject {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeToProjectConnection {
-    pub edges: Option<Box<Vec<InitiativeToProjectEdge>>>,
-    pub nodes: Option<Box<Vec<InitiativeToProject>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<InitiativeToProjectEdge>>,
+    pub nodes: Option<Vec<InitiativeToProject>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for InitiativeToProjectConnection {
     type FullType = Self;
@@ -4026,7 +5045,7 @@ impl GraphQLFields for InitiativeToProjectConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeToProjectEdge {
-    pub node: Option<Box<InitiativeToProject>>,
+    pub node: Option<InitiativeToProject>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -4036,14 +5055,14 @@ impl GraphQLFields for InitiativeToProjectEdge {
         "cursor".into()
     }
 }
-/// The result of a initiativeToProject mutation.
+/// The result of an initiative-to-project mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeToProjectPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    /// The initiativeToProject that was created or updated.
-    pub initiative_to_project: Option<Box<InitiativeToProject>>,
+    /// The initiative-to-project association that was created or updated.
+    pub initiative_to_project: Option<InitiativeToProject>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -4053,7 +5072,7 @@ impl GraphQLFields for InitiativeToProjectPayload {
         "lastSyncId success".into()
     }
 }
-/// An initiative update.
+/// A status update posted to an initiative. Initiative updates communicate progress, health, and blockers to stakeholders. Each update captures the initiative's health at the time of writing and includes a rich-text body with the update content.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeUpdate {
@@ -4076,15 +5095,15 @@ pub struct InitiativeUpdate {
     pub body_data: Option<String>,
     /// The update's unique URL slug.
     pub slug_id: Option<String>,
-    /// The initiative that the update is associated with.
+    /// The initiative that this status update was posted to.
     pub initiative: Option<Box<Initiative>>,
     /// The user who wrote the update.
     pub user: Option<Box<User>>,
-    /// The health at the time of the update.
+    /// The health of the initiative at the time this update was posted. Possible values are onTrack, atRisk, or offTrack.
     pub health: Option<InitiativeUpdateHealthType>,
-    /// `Internal` Serialized JSON representing current state of the initiative properties when posting the initiative update.
+    /// `Internal` A snapshot of initiative properties at the time the update was posted, including project statuses, sub-initiative health, and target dates. Used to compute diffs between consecutive updates.
     pub info_snapshot: Option<serde_json::Value>,
-    /// Whether initiative update diff should be hidden.
+    /// Whether the diff between this update and the previous one should be hidden in the UI.
     pub is_diff_hidden: Option<bool>,
     /// The URL to the initiative update.
     pub url: Option<String>,
@@ -4095,9 +5114,9 @@ pub struct InitiativeUpdate {
     /// The diff between the current update and the previous one, formatted as markdown.
     pub diff_markdown: Option<String>,
     /// Reactions associated with the initiative update.
-    pub reactions: Option<Box<Vec<Reaction>>>,
+    pub reactions: Option<Vec<Reaction>>,
     /// Comments associated with the initiative update.
-    pub comments: Option<Box<CommentConnection>>,
+    pub comments: Option<CommentConnection>,
     /// Number of comments associated with the initiative update.
     pub comment_count: Option<i64>,
 }
@@ -4117,7 +5136,7 @@ pub struct InitiativeUpdateArchivePayload {
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The archived/unarchived entity. Null if entity was deleted.
-    pub entity: Option<Box<InitiativeUpdate>>,
+    pub entity: Option<InitiativeUpdate>,
 }
 impl GraphQLFields for InitiativeUpdateArchivePayload {
     type FullType = Self;
@@ -4128,9 +5147,9 @@ impl GraphQLFields for InitiativeUpdateArchivePayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeUpdateConnection {
-    pub edges: Option<Box<Vec<InitiativeUpdateEdge>>>,
-    pub nodes: Option<Box<Vec<InitiativeUpdate>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<InitiativeUpdateEdge>>,
+    pub nodes: Option<Vec<InitiativeUpdate>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for InitiativeUpdateConnection {
     type FullType = Self;
@@ -4141,7 +5160,7 @@ impl GraphQLFields for InitiativeUpdateConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeUpdateEdge {
-    pub node: Option<Box<InitiativeUpdate>>,
+    pub node: Option<InitiativeUpdate>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -4151,13 +5170,14 @@ impl GraphQLFields for InitiativeUpdateEdge {
         "cursor".into()
     }
 }
+/// The result of an initiative update mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeUpdatePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    /// The initiative update that was created.
-    pub initiative_update: Option<Box<InitiativeUpdate>>,
+    /// The initiative update that was created or updated.
+    pub initiative_update: Option<InitiativeUpdate>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -4167,6 +5187,7 @@ impl GraphQLFields for InitiativeUpdatePayload {
         "lastSyncId success".into()
     }
 }
+/// The result of an initiative update reminder mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct InitiativeUpdateReminderPayload {
@@ -4181,7 +5202,7 @@ impl GraphQLFields for InitiativeUpdateReminderPayload {
         "lastSyncId success".into()
     }
 }
-/// An integration with an external service.
+/// An integration with an external service. Integrations connect Linear to tools like Slack, GitHub, GitLab, Jira, Figma, Sentry, Zendesk, Intercom, Front, PagerDuty, Opsgenie, Google Sheets, Microsoft Teams, Discord, Salesforce, and others. Each integration record represents a single configured connection, scoped to a workspace and optionally to a specific team, project, initiative, or custom view. Personal integrations (e.g., Slack Personal, Jira Personal, GitHub Personal) are scoped to the user who created them.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Integration {
@@ -4194,9 +5215,9 @@ pub struct Integration {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The integration's type.
+    /// The integration's type, identifying which external service this integration connects to (e.g., 'slack', 'github', 'jira', 'figma'). This determines the shape of the integration's settings and data.
     pub service: Option<String>,
-    /// The organization that the integration is associated with.
+    /// The workspace that the integration is associated with.
     pub organization: Option<Box<Organization>>,
     /// The team that the integration is associated with.
     pub team: Option<Box<Team>>,
@@ -4212,9 +5233,9 @@ impl GraphQLFields for Integration {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IntegrationConnection {
-    pub edges: Option<Box<Vec<IntegrationEdge>>>,
-    pub nodes: Option<Box<Vec<Integration>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<IntegrationEdge>>,
+    pub nodes: Option<Vec<Integration>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for IntegrationConnection {
     type FullType = Self;
@@ -4225,7 +5246,7 @@ impl GraphQLFields for IntegrationConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IntegrationEdge {
-    pub node: Option<Box<Integration>>,
+    pub node: Option<Integration>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -4255,7 +5276,7 @@ pub struct IntegrationPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The integration that was created or updated.
-    pub integration: Option<Box<Integration>>,
+    pub integration: Option<Integration>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -4265,6 +5286,7 @@ impl GraphQLFields for IntegrationPayload {
         "lastSyncId success".into()
     }
 }
+/// The result of an integration request mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IntegrationRequestPayload {
@@ -4291,7 +5313,7 @@ impl GraphQLFields for IntegrationSlackWorkspaceNamePayload {
         "name success".into()
     }
 }
-/// Join table between templates and integrations.
+/// A connection between a template and an integration. This join entity links Linear issue templates to integrations so that external systems (e.g., Slack Asks channels) can use specific templates when creating issues. Each record optionally includes a foreign entity ID to scope the template to a specific external resource, such as a particular Slack channel.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IntegrationTemplate {
@@ -4305,10 +5327,10 @@ pub struct IntegrationTemplate {
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The template that the integration is associated with.
-    pub template: Option<Box<Template>>,
+    pub template: Option<Template>,
     /// The integration that the template is associated with.
-    pub integration: Option<Box<Integration>>,
-    /// ID of the foreign entity in the external integration this template is for, e.g., Slack channel ID.
+    pub integration: Option<Integration>,
+    /// The identifier of the foreign entity in the external service that this template is scoped to. For example, a Slack channel ID indicating which channel should use this template for creating issues. When null, the template applies to the integration as a whole rather than a specific external resource.
     pub foreign_entity_id: Option<String>,
 }
 impl GraphQLFields for IntegrationTemplate {
@@ -4320,9 +5342,9 @@ impl GraphQLFields for IntegrationTemplate {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IntegrationTemplateConnection {
-    pub edges: Option<Box<Vec<IntegrationTemplateEdge>>>,
-    pub nodes: Option<Box<Vec<IntegrationTemplate>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<IntegrationTemplateEdge>>,
+    pub nodes: Option<Vec<IntegrationTemplate>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for IntegrationTemplateConnection {
     type FullType = Self;
@@ -4333,7 +5355,7 @@ impl GraphQLFields for IntegrationTemplateConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IntegrationTemplateEdge {
-    pub node: Option<Box<IntegrationTemplate>>,
+    pub node: Option<IntegrationTemplate>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -4343,13 +5365,14 @@ impl GraphQLFields for IntegrationTemplateEdge {
         "cursor".into()
     }
 }
+/// The result of an integration template mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IntegrationTemplatePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The IntegrationTemplate that was created or updated.
-    pub integration_template: Option<Box<IntegrationTemplate>>,
+    pub integration_template: Option<IntegrationTemplate>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -4359,7 +5382,7 @@ impl GraphQLFields for IntegrationTemplatePayload {
         "lastSyncId success".into()
     }
 }
-/// The configuration of all integrations for different entities.
+/// The configuration of all integrations for different entities. Controls Slack notification preferences for a specific team, project, initiative, or custom view. Exactly one of teamId, projectId, customViewId, or initiativeId must be set, determining which entity these integration settings apply to.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IntegrationsSettings {
@@ -4386,11 +5409,13 @@ pub struct IntegrationsSettings {
     pub slack_issue_status_changed_all: Option<bool>,
     /// Whether to send a Slack message when a project update is created.
     pub slack_project_update_created: Option<bool>,
+    /// Whether to send a Microsoft Teams message when a project update is created.
+    pub microsoft_teams_project_update_created: Option<bool>,
     /// Whether to send a new project update to team Slack channels.
     pub slack_project_update_created_to_team: Option<bool>,
     /// Whether to send a new project update to workspace Slack channel.
     pub slack_project_update_created_to_workspace: Option<bool>,
-    /// Whether to send a Slack message when a initiate update is created.
+    /// Whether to send a Slack message when an initiative update is created.
     pub slack_initiative_update_created: Option<bool>,
     /// Whether to send a Slack message when a new issue is added to triage.
     pub slack_issue_added_to_triage: Option<bool>,
@@ -4408,7 +5433,7 @@ pub struct IntegrationsSettings {
 impl GraphQLFields for IntegrationsSettings {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt contextViewType slackIssueCreated slackIssueNewComment slackIssueStatusChangedDone slackIssueAddedToView slackIssueStatusChangedAll slackProjectUpdateCreated slackProjectUpdateCreatedToTeam slackProjectUpdateCreatedToWorkspace slackInitiativeUpdateCreated slackIssueAddedToTriage slackIssueSlaHighRisk slackIssueSlaBreached"
+        "id createdAt updatedAt archivedAt contextViewType slackIssueCreated slackIssueNewComment slackIssueStatusChangedDone slackIssueAddedToView slackIssueStatusChangedAll slackProjectUpdateCreated microsoftTeamsProjectUpdateCreated slackProjectUpdateCreatedToTeam slackProjectUpdateCreatedToWorkspace slackInitiativeUpdateCreated slackIssueAddedToTriage slackIssueSlaHighRisk slackIssueSlaBreached"
             .into()
     }
 }
@@ -4418,7 +5443,7 @@ pub struct IntegrationsSettingsPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The settings that were created or updated.
-    pub integrations_settings: Option<Box<IntegrationsSettings>>,
+    pub integrations_settings: Option<IntegrationsSettings>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -4428,7 +5453,7 @@ impl GraphQLFields for IntegrationsSettingsPayload {
         "lastSyncId success".into()
     }
 }
-/// An issue.
+/// An issue is the core work item in Linear. Issues belong to a team, have a workflow status, can be assigned to users, carry a priority level, and can be organized into projects and cycles. Issues support sub-issues (parent-child hierarchy up to 10 levels deep), labels, due dates, estimates, and SLA tracking. They can also be linked to other issues via relations, attached to releases, and tracked through their full history of changes.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Issue {
@@ -4441,19 +5466,19 @@ pub struct Issue {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The issue's unique number.
+    /// The issue's unique number, scoped to the issue's team. Together with the team key, this forms the issue's human-readable identifier (e.g., ENG-123).
     pub number: Option<f64>,
-    /// The issue's title.
+    /// The issue's title. This is the primary human-readable summary of the work item.
     pub title: Option<String>,
-    /// The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.
+    /// The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low.
     pub priority: Option<f64>,
-    /// The estimate of the complexity of the issue..
+    /// The estimate of the complexity of the issue. The specific scale used depends on the team's estimation configuration (e.g., points, T-shirt sizes). Null if no estimate has been set.
     pub estimate: Option<f64>,
     /// The order of the item in its column on the board.
     pub board_order: Option<f64>,
-    /// The order of the item in relation to other items in the organization.
+    /// The order of the item in relation to other items in the organization. Used for manual sorting in list views.
     pub sort_order: Option<f64>,
-    /// The order of the item in relation to other items in the organization, when ordered by priority.
+    /// The order of the item in relation to other items in the workspace, when ordered by priority.
     pub priority_sort_order: Option<f64>,
     /// The time at which the issue was moved into started state.
     pub started_at: Option<chrono::DateTime<chrono::Utc>>,
@@ -4497,15 +5522,15 @@ pub struct Issue {
     pub activity_summary: Option<serde_json::Value>,
     /// `Internal` AI-generated activity summary for this issue.
     pub summary: Option<Box<Summary>>,
-    /// Id of the labels associated with this issue.
+    /// Identifiers of the labels associated with this issue. Can be used to query the labels directly.
     pub label_ids: Option<Vec<String>>,
-    /// The team that the issue is associated with.
+    /// The team that the issue belongs to. Every issue must belong to exactly one team, which determines the available workflow states, labels, and other team-specific configuration.
     pub team: Option<Box<Team>>,
-    /// The cycle that the issue is associated with.
+    /// The cycle that the issue is associated with. Null if the issue is not part of any cycle.
     pub cycle: Option<Box<Cycle>>,
-    /// The project that the issue is associated with.
+    /// The project that the issue is associated with. Null if the issue is not part of any project.
     pub project: Option<Box<Project>>,
-    /// The projectMilestone that the issue is associated with.
+    /// The project milestone that the issue is associated with. Null if the issue is not assigned to a specific milestone within its project.
     pub project_milestone: Option<Box<ProjectMilestone>>,
     /// The last template that was applied to this issue.
     pub last_applied_template: Option<Box<Template>>,
@@ -4513,32 +5538,34 @@ pub struct Issue {
     pub recurring_issue_template: Option<Box<Template>>,
     /// Previous identifiers of the issue if it has been moved between teams.
     pub previous_identifiers: Option<Vec<String>>,
-    /// The user who created the issue.
+    /// The user who created the issue. Null if the creator's account has been deleted or if the issue was created by an integration or system process.
     pub creator: Option<Box<User>>,
-    /// The external user who created the issue.
+    /// The external user who created the issue. Set when the issue was created via an integration (e.g., Slack, Intercom) on behalf of a non-Linear user. Null if the issue was created by a Linear user.
     pub external_user_creator: Option<Box<ExternalUser>>,
-    /// The user to whom the issue is assigned to.
+    /// The user to whom the issue is assigned. Null if the issue is unassigned.
     pub assignee: Option<Box<User>>,
-    /// The agent user that is delegated to work on this issue.
+    /// The agent user that is delegated to work on this issue. Set when an AI agent has been assigned to perform work on this issue. Null if no agent is working on the issue.
     pub delegate: Option<Box<User>>,
     /// The user who snoozed the issue.
     pub snoozed_by: Option<Box<User>>,
-    /// The workflow state that the issue is associated with.
+    /// The workflow state (issue status) that the issue is currently in. Workflow states represent the issue's progress through the team's workflow, such as Triage, Todo, In Progress, Done, or Canceled.
     pub state: Option<Box<WorkflowState>>,
     /// The order of the item in the sub-issue list. Only set if the issue has a parent.
     pub sub_issue_sort_order: Option<f64>,
-    /// Emoji reaction summary, grouped by emoji type.
+    /// Emoji reaction summary for the issue, grouped by emoji type. Contains the count and reacting user information for each emoji.
     pub reaction_data: Option<serde_json::Value>,
     /// Label for the priority.
     pub priority_label: Option<String>,
-    /// The comment that this issue was created from.
+    /// The comment that this issue was created from, when an issue is created from an existing comment. Null if the issue was not created from a comment.
     pub source_comment: Option<Box<Comment>>,
     /// Integration type that created this issue, if applicable.
     pub integration_source_type: Option<IntegrationService>,
+    /// Whether this issue inherits shared access from its parent issue.
+    pub inherits_shared_access: Option<bool>,
     /// Documents associated with the issue.
-    pub documents: Option<Box<DocumentConnection>>,
+    pub documents: Option<DocumentConnection>,
     /// The bot that created the issue, if applicable.
-    pub bot_actor: Option<Box<ActorBot>>,
+    pub bot_actor: Option<ActorBot>,
     /// The users favorite associated with this issue.
     pub favorite: Option<Box<Favorite>>,
     /// Issue's human readable identifier (e.g. ENG-123).
@@ -4548,29 +5575,31 @@ pub struct Issue {
     /// Suggested branch name for the issue.
     pub branch_name: Option<String>,
     /// Shared access metadata for this issue.
-    pub shared_access: Option<Box<IssueSharedAccess>>,
+    pub shared_access: Option<IssueSharedAccess>,
     /// Returns the number of Attachment resources which are created by customer support ticketing systems (e.g. Zendesk).
     pub customer_ticket_count: Option<i64>,
     /// Users who are subscribed to the issue.
-    pub subscribers: Option<Box<UserConnection>>,
+    pub subscribers: Option<UserConnection>,
     /// The parent of the issue.
     pub parent: Option<Box<Issue>>,
     /// Children of the issue.
-    pub children: Option<Box<IssueConnection>>,
+    pub children: Option<IssueConnection>,
     /// Comments associated with the issue.
-    pub comments: Option<Box<CommentConnection>>,
+    pub comments: Option<CommentConnection>,
+    /// `Internal` AI prompt progresses associated with this issue.
+    pub ai_prompt_progresses: Option<AiPromptProgressConnection>,
     /// History entries associated with the issue.
-    pub history: Option<Box<IssueHistoryConnection>>,
+    pub history: Option<IssueHistoryConnection>,
     /// Labels associated with this issue.
-    pub labels: Option<Box<IssueLabelConnection>>,
+    pub labels: Option<IssueLabelConnection>,
     /// Relations associated with this issue.
-    pub relations: Option<Box<IssueRelationConnection>>,
+    pub relations: Option<IssueRelationConnection>,
     /// Inverse relations associated with this issue.
-    pub inverse_relations: Option<Box<IssueRelationConnection>>,
+    pub inverse_relations: Option<IssueRelationConnection>,
     /// Attachments associated with the issue.
-    pub attachments: Option<Box<AttachmentConnection>>,
+    pub attachments: Option<AttachmentConnection>,
     /// Attachments previously associated with the issue before being moved to another issue.
-    pub former_attachments: Option<Box<AttachmentConnection>>,
+    pub former_attachments: Option<AttachmentConnection>,
     /// The issue's description in markdown format.
     pub description: Option<String>,
     /// `Internal` The issue's description content as YJS state.
@@ -4578,28 +5607,30 @@ pub struct Issue {
     /// `ALPHA` The document content representing this issue description.
     pub document_content: Option<Box<DocumentContent>>,
     /// Reactions associated with the issue.
-    pub reactions: Option<Box<Vec<Reaction>>>,
+    pub reactions: Option<Vec<Reaction>>,
     /// Customer needs associated with the issue.
-    pub needs: Option<Box<CustomerNeedConnection>>,
+    pub needs: Option<CustomerNeedConnection>,
     /// Customer needs previously associated with the issue before being moved to another issue.
-    pub former_needs: Option<Box<CustomerNeedConnection>>,
+    pub former_needs: Option<CustomerNeedConnection>,
+    /// `ALPHA` Releases associated with the issue.
+    pub releases: Option<ReleaseConnection>,
     /// The external services the issue is synced with.
-    pub synced_with: Option<Box<Vec<ExternalEntityInfo>>>,
+    pub synced_with: Option<Vec<ExternalEntityInfo>>,
     /// `Internal` Product Intelligence suggestions for the issue.
-    pub suggestions: Option<Box<IssueSuggestionConnection>>,
+    pub suggestions: Option<IssueSuggestionConnection>,
     /// `Internal` Incoming product intelligence relation suggestions for the issue.
-    pub incoming_suggestions: Option<Box<IssueSuggestionConnection>>,
+    pub incoming_suggestions: Option<IssueSuggestionConnection>,
     /// The internal user who requested creation of the Asks issue on behalf of the creator.
     pub asks_requester: Option<Box<User>>,
     /// The external user who requested creation of the Asks issue on behalf of the creator.
     pub asks_external_user_requester: Option<Box<ExternalUser>>,
     /// The issue's workflow states over time.
-    pub state_history: Option<Box<IssueStateSpanConnection>>,
+    pub state_history: Option<IssueStateSpanConnection>,
 }
 impl GraphQLFields for Issue {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt number title priority estimate boardOrder sortOrder prioritySortOrder startedAt completedAt startedTriageAt triagedAt canceledAt autoClosedAt autoArchivedAt dueDate slaStartedAt slaMediumRiskAt slaHighRiskAt slaBreachesAt slaType addedToProjectAt addedToCycleAt addedToTeamAt trashed snoozedUntilAt suggestionsGeneratedAt activitySummary labelIds previousIdentifiers subIssueSortOrder reactionData priorityLabel integrationSourceType identifier url branchName customerTicketCount description"
+        "id createdAt updatedAt archivedAt number title priority estimate boardOrder sortOrder prioritySortOrder startedAt completedAt startedTriageAt triagedAt canceledAt autoClosedAt autoArchivedAt dueDate slaStartedAt slaMediumRiskAt slaHighRiskAt slaBreachesAt slaType addedToProjectAt addedToCycleAt addedToTeamAt trashed snoozedUntilAt suggestionsGeneratedAt activitySummary labelIds previousIdentifiers subIssueSortOrder reactionData priorityLabel integrationSourceType inheritsSharedAccess identifier url branchName customerTicketCount description"
             .into()
     }
 }
@@ -4612,7 +5643,7 @@ pub struct IssueArchivePayload {
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The archived/unarchived entity. Null if entity was deleted.
-    pub entity: Option<Box<Issue>>,
+    pub entity: Option<Issue>,
 }
 impl GraphQLFields for IssueArchivePayload {
     type FullType = Self;
@@ -4620,13 +5651,14 @@ impl GraphQLFields for IssueArchivePayload {
         "lastSyncId success".into()
     }
 }
+/// The result of a batch issue mutation, containing the updated issues and a success indicator.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueBatchPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The issues that were updated.
-    pub issues: Option<Box<Vec<Issue>>>,
+    pub issues: Option<Vec<Issue>>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -4639,9 +5671,9 @@ impl GraphQLFields for IssueBatchPayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueConnection {
-    pub edges: Option<Box<Vec<IssueEdge>>>,
-    pub nodes: Option<Box<Vec<Issue>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<IssueEdge>>,
+    pub nodes: Option<Vec<Issue>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for IssueConnection {
     type FullType = Self;
@@ -4649,7 +5681,7 @@ impl GraphQLFields for IssueConnection {
         "".into()
     }
 }
-/// `Internal` A draft issue.
+/// `Internal` A draft issue that has not yet been created as a full issue. Drafts allow users to prepare issue details (title, description, labels, assignee, etc.) before committing them. Drafts belong to a team and a creator, and support a parent-child hierarchy similar to issues. A draft can have either a parent draft or a parent issue, but not both.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueDraft {
@@ -4662,42 +5694,42 @@ pub struct IssueDraft {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The draft's title.
+    /// The draft's title. This will become the issue's title when the draft is published.
     pub title: Option<String>,
     /// The draft's description in markdown format.
     pub description: Option<String>,
-    /// The priority of the draft.
+    /// The priority of the draft. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.
     pub priority: Option<f64>,
-    /// The estimate of the complexity of the draft.
+    /// The estimate of the complexity of the draft. Null if no estimate has been set.
     pub estimate: Option<f64>,
     /// The date at which the issue would be due.
     pub due_date: Option<chrono::NaiveDate>,
-    /// The IDs of labels added to the draft.
+    /// Identifiers of the labels added to the draft. These labels will be applied to the issue when the draft is published.
     pub label_ids: Option<Vec<String>>,
-    /// The team associated with the draft.
+    /// Identifier of the team associated with the draft. Can be used to query the team directly.
     pub team_id: Option<String>,
-    /// The cycle associated with the draft.
+    /// Identifier of the cycle associated with the draft. Can be used to query the cycle directly. Null if no cycle is assigned.
     pub cycle_id: Option<String>,
-    /// The project associated with the draft.
+    /// Identifier of the project associated with the draft. Can be used to query the project directly. Null if no project is assigned.
     pub project_id: Option<String>,
-    /// The project milestone associated with the draft.
+    /// Identifier of the project milestone associated with the draft. Can be used to query the project milestone directly. Null if no milestone is assigned.
     pub project_milestone_id: Option<String>,
     /// The user who created the draft.
-    pub creator: Option<Box<User>>,
-    /// The user assigned to the draft.
+    pub creator: Option<User>,
+    /// Identifier of the user assigned to the draft. Can be used to query the user directly. Null if the draft is unassigned.
     pub assignee_id: Option<String>,
     /// The agent user delegated to work on the issue being drafted.
     pub delegate_id: Option<String>,
-    /// The workflow state associated with the draft.
+    /// Identifier of the workflow state associated with the draft. Can be used to query the workflow state directly. Determines the initial status the issue will have when the draft is published.
     pub state_id: Option<String>,
-    /// The parent draft of the draft.
+    /// The parent draft of the draft. Set when this draft represents a sub-issue of another draft. Null if this is a top-level draft or has a parent issue instead.
     pub parent: Option<Box<IssueDraft>>,
     /// The ID of the parent issue draft, if any.
     pub parent_id: Option<String>,
-    /// The ID of the comment that the draft was created from.
+    /// Identifier of the comment that the draft was created from. Set when a draft is created from an existing comment. Null if the draft was not created from a comment.
     pub source_comment_id: Option<String>,
-    /// The parent issue of the draft.
-    pub parent_issue: Option<Box<Issue>>,
+    /// The parent issue of the draft. Set when this draft represents a sub-issue that will be created under an existing issue. Null if this is a top-level draft or has a parent draft instead.
+    pub parent_issue: Option<Issue>,
     /// The ID of the parent issue, if any.
     pub parent_issue_id: Option<String>,
     /// The order of items in the sub-draft list. Only set if the draft has `parent` set.
@@ -4710,23 +5742,24 @@ pub struct IssueDraft {
     pub attachments: Option<serde_json::Value>,
     /// Serialized array of JSONs representing customer needs.
     pub needs: Option<serde_json::Value>,
+    /// Identifiers of the releases associated with the draft. These releases will be linked to the issue when the draft is published.
+    pub release_ids: Option<Vec<String>>,
     /// Serialized array of JSONs representing the recurring issue's schedule.
     pub schedule: Option<serde_json::Value>,
-    pub labels: Option<Box<IssueLabelConnection>>,
 }
 impl GraphQLFields for IssueDraft {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt title description priority estimate dueDate labelIds teamId cycleId projectId projectMilestoneId assigneeId delegateId stateId parentId sourceCommentId parentIssueId subIssueSortOrder priorityLabel descriptionData attachments needs schedule"
+        "id createdAt updatedAt archivedAt title description priority estimate dueDate labelIds teamId cycleId projectId projectMilestoneId assigneeId delegateId stateId parentId sourceCommentId parentIssueId subIssueSortOrder priorityLabel descriptionData attachments needs releaseIds schedule"
             .into()
     }
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueDraftConnection {
-    pub edges: Option<Box<Vec<IssueDraftEdge>>>,
-    pub nodes: Option<Box<Vec<IssueDraft>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<IssueDraftEdge>>,
+    pub nodes: Option<Vec<IssueDraft>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for IssueDraftConnection {
     type FullType = Self;
@@ -4737,7 +5770,7 @@ impl GraphQLFields for IssueDraftConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueDraftEdge {
-    pub node: Option<Box<IssueDraft>>,
+    pub node: Option<IssueDraft>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -4750,7 +5783,7 @@ impl GraphQLFields for IssueDraftEdge {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueEdge {
-    pub node: Option<Box<Issue>>,
+    pub node: Option<Issue>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -4760,6 +5793,7 @@ impl GraphQLFields for IssueEdge {
         "cursor".into()
     }
 }
+/// The result of an AI-generated issue filter suggestion based on a text prompt.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueFilterSuggestionPayload {
@@ -4774,7 +5808,7 @@ impl GraphQLFields for IssueFilterSuggestionPayload {
         "filter logId".into()
     }
 }
-/// A record of changes to an issue.
+/// A record of changes to an issue. Each history entry captures one or more property changes made to an issue within a short grouping window by the same actor. History entries track changes to fields such as title, assignee, status, priority, project, cycle, labels, due date, estimate, parent issue, and more. They also record metadata about what triggered the change (e.g., a user action, workflow automation, triage rule, or integration).
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueHistory {
@@ -4788,8 +5822,8 @@ pub struct IssueHistory {
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The issue that was changed.
-    pub issue: Option<Box<Issue>>,
-    /// The id of user who made these changes. If null, possibly means that the change made by an integration.
+    pub issue: Option<Issue>,
+    /// Identifier of the user who made these changes. Can be used to query the user directly. Null if the change was made by an integration, automation, or system process.
     pub actor_id: Option<String>,
     /// Whether the issue's description was updated.
     pub updated_description: Option<bool>,
@@ -4797,45 +5831,45 @@ pub struct IssueHistory {
     pub from_title: Option<String>,
     /// What the title was changed to.
     pub to_title: Option<String>,
-    /// The id of user from whom the issue was re-assigned from.
+    /// Identifier of the user from whom the issue was re-assigned. Can be used to query the user directly. Null if the assignee was not changed or the issue was previously unassigned.
     pub from_assignee_id: Option<String>,
-    /// The id of user to whom the issue was assigned to.
+    /// Identifier of the user to whom the issue was assigned. Can be used to query the user directly. Null if the assignee was not changed or the issue was unassigned.
     pub to_assignee_id: Option<String>,
     /// What the priority was changed from.
     pub from_priority: Option<f64>,
     /// What the priority was changed to.
     pub to_priority: Option<f64>,
-    /// The id of team from which the issue was moved from.
+    /// Identifier of the team from which the issue was moved. Can be used to query the team directly. Null if the team was not changed.
     pub from_team_id: Option<String>,
-    /// The id of team to which the issue was moved to.
+    /// Identifier of the team to which the issue was moved. Can be used to query the team directly. Null if the team was not changed.
     pub to_team_id: Option<String>,
-    /// The id of previous parent of the issue.
+    /// Identifier of the previous parent issue. Can be used to query the issue directly. Null if the parent was not changed or the issue previously had no parent.
     pub from_parent_id: Option<String>,
-    /// The id of new parent of the issue.
+    /// Identifier of the new parent issue. Can be used to query the issue directly. Null if the parent was not changed or the issue was removed from its parent.
     pub to_parent_id: Option<String>,
-    /// The id of previous workflow state of the issue.
+    /// Identifier of the previous workflow state (issue status) of the issue. Can be used to query the workflow state directly. Null if the status was not changed.
     pub from_state_id: Option<String>,
-    /// The id of new workflow state of the issue.
+    /// Identifier of the new workflow state (issue status) of the issue. Can be used to query the workflow state directly. Null if the status was not changed.
     pub to_state_id: Option<String>,
-    /// The id of previous cycle of the issue.
+    /// Identifier of the previous cycle of the issue. Can be used to query the cycle directly. Null if the cycle was not changed or the issue was not in a cycle.
     pub from_cycle_id: Option<String>,
-    /// The id of new cycle of the issue.
+    /// Identifier of the new cycle of the issue. Can be used to query the cycle directly. Null if the cycle was not changed or the issue was removed from a cycle.
     pub to_cycle_id: Option<String>,
-    /// The id of new project created from the issue.
+    /// Identifier of the new project that was created by converting this issue to a project. Can be used to query the project directly. Null if the issue was not converted to a project.
     pub to_converted_project_id: Option<String>,
-    /// The id of previous project of the issue.
+    /// Identifier of the previous project of the issue. Can be used to query the project directly. Null if the project was not changed or the issue was not in a project.
     pub from_project_id: Option<String>,
-    /// The id of new project of the issue.
+    /// Identifier of the new project of the issue. Can be used to query the project directly. Null if the project was not changed or the issue was removed from a project.
     pub to_project_id: Option<String>,
     /// What the estimate was changed from.
     pub from_estimate: Option<f64>,
     /// What the estimate was changed to.
     pub to_estimate: Option<f64>,
-    /// Whether the issue is archived at the time of this history entry.
+    /// Whether the issue was archived (true) or unarchived (false) in this change. Null if the archive status was not changed.
     pub archived: Option<bool>,
     /// Whether the issue was trashed or un-trashed.
     pub trashed: Option<bool>,
-    /// The id of linked attachment.
+    /// Identifier of the attachment that was linked to or unlinked from the issue. Can be used to query the attachment directly. Null if no attachment change occurred.
     pub attachment_id: Option<String>,
     /// ID's of labels that were added.
     pub added_label_ids: Option<Vec<String>>,
@@ -4846,7 +5880,7 @@ pub struct IssueHistory {
     /// `ALPHA` ID's of releases that the issue was removed from.
     pub removed_from_release_ids: Option<Vec<String>>,
     /// Changed issue relationships.
-    pub relation_changes: Option<Box<Vec<IssueRelationHistoryPayload>>>,
+    pub relation_changes: Option<Vec<IssueRelationHistoryPayload>>,
     /// Whether the issue was auto-closed.
     pub auto_closed: Option<bool>,
     /// Whether the issue was auto-archived.
@@ -4855,60 +5889,60 @@ pub struct IssueHistory {
     pub from_due_date: Option<chrono::NaiveDate>,
     /// What the due date was changed to.
     pub to_due_date: Option<chrono::NaiveDate>,
-    /// The id of linked customer need.
+    /// `Deprecated` Identifier of the customer need that was linked to the issue. Use customer need related arrays in changes instead.
     pub customer_need_id: Option<String>,
     /// `Internal` Serialized JSON representing changes for certain non-relational properties.
     pub changes: Option<serde_json::Value>,
     /// The actor that performed the actions. This field may be empty in the case of integrations or automations.
-    pub actor: Option<Box<User>>,
+    pub actor: Option<User>,
     /// The actors that performed the actions. This field may be empty in the case of integrations or automations.
-    pub actors: Option<Box<Vec<User>>>,
+    pub actors: Option<Vec<User>>,
     /// The actors that edited the description of the issue, if any.
-    pub description_updated_by: Option<Box<Vec<User>>>,
+    pub description_updated_by: Option<Vec<User>>,
     /// The user that was unassigned from the issue.
-    pub from_assignee: Option<Box<User>>,
+    pub from_assignee: Option<User>,
     /// The user that was assigned to the issue.
-    pub to_assignee: Option<Box<User>>,
+    pub to_assignee: Option<User>,
     /// The cycle that the issue was moved from.
-    pub from_cycle: Option<Box<Cycle>>,
+    pub from_cycle: Option<Cycle>,
     /// The cycle that the issue was moved to.
-    pub to_cycle: Option<Box<Cycle>>,
+    pub to_cycle: Option<Cycle>,
     /// The new project created from the issue.
-    pub to_converted_project: Option<Box<Project>>,
+    pub to_converted_project: Option<Project>,
     /// The app user from whom the issue delegation was transferred.
-    pub from_delegate: Option<Box<User>>,
+    pub from_delegate: Option<User>,
     /// The app user to whom the issue delegation was transferred.
-    pub to_delegate: Option<Box<User>>,
+    pub to_delegate: Option<User>,
     /// The project that the issue was moved from.
-    pub from_project: Option<Box<Project>>,
+    pub from_project: Option<Project>,
     /// The project that the issue was moved to.
-    pub to_project: Option<Box<Project>>,
+    pub to_project: Option<Project>,
     /// The state that the issue was moved from.
-    pub from_state: Option<Box<WorkflowState>>,
+    pub from_state: Option<WorkflowState>,
     /// The state that the issue was moved to.
-    pub to_state: Option<Box<WorkflowState>>,
+    pub to_state: Option<WorkflowState>,
     /// The team that the issue was moved from.
-    pub from_team: Option<Box<Team>>,
+    pub from_team: Option<Team>,
     /// The team that the issue was moved to.
-    pub to_team: Option<Box<Team>>,
+    pub to_team: Option<Team>,
     /// The parent issue that the issue was moved from.
-    pub from_parent: Option<Box<Issue>>,
+    pub from_parent: Option<Issue>,
     /// The parent issue that the issue was moved to.
-    pub to_parent: Option<Box<Issue>>,
+    pub to_parent: Option<Issue>,
     /// The linked attachment.
-    pub attachment: Option<Box<Attachment>>,
+    pub attachment: Option<Attachment>,
     /// The import record.
-    pub issue_import: Option<Box<IssueImport>>,
+    pub issue_import: Option<IssueImport>,
     /// The users that were notified of the issue.
-    pub triage_responsibility_notified_users: Option<Box<Vec<User>>>,
+    pub triage_responsibility_notified_users: Option<Vec<User>>,
     /// Boolean indicating if the issue was auto-assigned using the triage responsibility feature.
     pub triage_responsibility_auto_assigned: Option<bool>,
     /// The team that triggered the triage responsibility action.
-    pub triage_responsibility_team: Option<Box<Team>>,
+    pub triage_responsibility_team: Option<Team>,
     /// The project milestone that the issue was moved from.
-    pub from_project_milestone: Option<Box<ProjectMilestone>>,
+    pub from_project_milestone: Option<ProjectMilestone>,
     /// The project milestone that the issue was moved to.
-    pub to_project_milestone: Option<Box<ProjectMilestone>>,
+    pub to_project_milestone: Option<ProjectMilestone>,
     /// The time at which the issue's SLA was previously started.
     pub from_sla_started_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the issue's SLA is now started.
@@ -4926,17 +5960,19 @@ pub struct IssueHistory {
     /// The type of SLA that is now set on the issue.
     pub to_sla_type: Option<String>,
     /// The bot that performed the action.
-    pub bot_actor: Option<Box<ActorBot>>,
+    pub bot_actor: Option<ActorBot>,
     /// The labels that were added to the issue.
-    pub added_labels: Option<Box<Vec<IssueLabel>>>,
+    pub added_labels: Option<Vec<IssueLabel>>,
     /// The labels that were removed from the issue.
-    pub removed_labels: Option<Box<Vec<IssueLabel>>>,
+    pub removed_labels: Option<Vec<IssueLabel>>,
     /// The releases that the issue was added to.
-    pub added_to_releases: Option<Box<Vec<Release>>>,
+    pub added_to_releases: Option<Vec<Release>>,
     /// The releases that the issue was removed from.
-    pub removed_from_releases: Option<Box<Vec<Release>>>,
+    pub removed_from_releases: Option<Vec<Release>>,
     /// `INTERNAL` Metadata about the triage rule that made changes to the issue.
-    pub triage_rule_metadata: Option<Box<IssueHistoryTriageRuleMetadata>>,
+    pub triage_rule_metadata: Option<IssueHistoryTriageRuleMetadata>,
+    /// `INTERNAL` Metadata about the workflow that made changes to the issue.
+    pub workflow_metadata: Option<IssueHistoryWorkflowMetadata>,
 }
 impl GraphQLFields for IssueHistory {
     type FullType = Self;
@@ -4948,9 +5984,9 @@ impl GraphQLFields for IssueHistory {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueHistoryConnection {
-    pub edges: Option<Box<Vec<IssueHistoryEdge>>>,
-    pub nodes: Option<Box<Vec<IssueHistory>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<IssueHistoryEdge>>,
+    pub nodes: Option<Vec<IssueHistory>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for IssueHistoryConnection {
     type FullType = Self;
@@ -4961,7 +5997,7 @@ impl GraphQLFields for IssueHistoryConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueHistoryEdge {
-    pub node: Option<Box<IssueHistory>>,
+    pub node: Option<IssueHistory>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -4971,7 +6007,7 @@ impl GraphQLFields for IssueHistoryEdge {
         "cursor".into()
     }
 }
-/// An error that occurred during triage rule execution.
+/// An error that occurred during triage rule execution, such as a conflicting label assignment or an invalid property value. Contains the error type and optionally the property that caused the failure.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueHistoryTriageRuleError {
@@ -4982,11 +6018,11 @@ pub struct IssueHistoryTriageRuleError {
     /// Whether the conflict was for the same child label.
     pub conflict_for_same_child_label: Option<bool>,
     /// The team the issue was being moved from.
-    pub from_team: Option<Box<Team>>,
+    pub from_team: Option<Team>,
     /// The team the issue was being moved to.
-    pub to_team: Option<Box<Team>>,
+    pub to_team: Option<Team>,
     /// The conflicting labels.
-    pub conflicting_labels: Option<Box<Vec<IssueLabel>>>,
+    pub conflicting_labels: Option<Vec<IssueLabel>>,
 }
 impl GraphQLFields for IssueHistoryTriageRuleError {
     type FullType = Self;
@@ -4994,14 +6030,14 @@ impl GraphQLFields for IssueHistoryTriageRuleError {
         "type property conflictForSameChildLabel".into()
     }
 }
-/// Metadata about a triage rule that made changes to an issue.
+/// Metadata about a triage responsibility rule that made changes to an issue, such as auto-assigning an issue when it enters triage. Includes information about any errors that occurred during rule execution.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueHistoryTriageRuleMetadata {
     /// The error that occurred, if any.
-    pub triage_rule_error: Option<Box<IssueHistoryTriageRuleError>>,
+    pub triage_rule_error: Option<IssueHistoryTriageRuleError>,
     /// The triage rule that triggered the issue update.
-    pub updated_by_triage_rule: Option<Box<WorkflowDefinition>>,
+    pub updated_by_triage_rule: Option<WorkflowDefinition>,
 }
 impl GraphQLFields for IssueHistoryTriageRuleMetadata {
     type FullType = Self;
@@ -5009,7 +6045,22 @@ impl GraphQLFields for IssueHistoryTriageRuleMetadata {
         "".into()
     }
 }
-/// An import job for data from an external service.
+/// Metadata about a workflow automation that made changes to an issue. Links the issue history entry back to the workflow definition that triggered the change, and optionally to any AI conversation involved in the automation.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct IssueHistoryWorkflowMetadata {
+    /// The workflow definition that triggered the issue update.
+    pub workflow_definition: Option<WorkflowDefinition>,
+    /// The AI conversation associated with the workflow.
+    pub ai_conversation: Option<AiConversation>,
+}
+impl GraphQLFields for IssueHistoryWorkflowMetadata {
+    type FullType = Self;
+    fn selection() -> String {
+        "".into()
+    }
+}
+/// An import job for data from an external service such as Jira, Asana, GitHub, Shortcut, or other project management tools. Import jobs track the full lifecycle of importing issues, labels, workflow states, and other data into a Linear workspace, including progress, status, error states, and data mapping configuration.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueImport {
@@ -5022,19 +6073,19 @@ pub struct IssueImport {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// New team's name in cases when teamId not set.
+    /// The name of the new team to be created for the import, when the import is configured to create a new team rather than importing into an existing one. Null if importing into an existing team.
     pub team_name: Option<String>,
-    /// The id for the user that started the job.
+    /// Identifier of the user who started the import job. Can be used to query the user directly. Null if the user has been deleted.
     pub creator_id: Option<String>,
-    /// The service from which data will be imported.
+    /// The external service from which data is being imported (e.g., jira, asana, github, shortcut, linear).
     pub service: Option<String>,
-    /// The status for the import job.
+    /// The current status of the import job, indicating its position in the import lifecycle (e.g., not started, in progress, complete, error).
     pub status: Option<String>,
     /// The data mapping configuration for the import job.
     pub mapping: Option<serde_json::Value>,
     /// User readable error message, if one has occurred during the import.
     pub error: Option<String>,
-    /// Current step progress in % (0-100).
+    /// Current step progress as a percentage (0-100). Null if the import has not yet started or progress tracking is not available.
     pub progress: Option<f64>,
     /// File URL for the uploaded CSV for the import, if there is one.
     pub csv_file_url: Option<String>,
@@ -5052,6 +6103,7 @@ impl GraphQLFields for IssueImport {
             .into()
     }
 }
+/// The result of checking whether an import from an external service can proceed.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueImportCheckPayload {
@@ -5064,13 +6116,14 @@ impl GraphQLFields for IssueImportCheckPayload {
         "success".into()
     }
 }
+/// The result of deleting an issue import, containing the deleted import job and a success indicator.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueImportDeletePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The import job that was deleted.
-    pub issue_import: Option<Box<IssueImport>>,
+    pub issue_import: Option<IssueImport>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -5080,13 +6133,13 @@ impl GraphQLFields for IssueImportDeletePayload {
         "lastSyncId success".into()
     }
 }
-/// Whether a custom JQL query is valid or not
+/// The result of validating a custom JQL query for a Jira import.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueImportJqlCheckPayload {
     /// Returns true if the JQL query has been validated successfully, false otherwise
     pub success: Option<bool>,
-    /// Returns an approximate number of issues matching the JQL query, if available
+    /// An approximate number of issues matching the JQL query. Null when the query is invalid or the count is unavailable.
     pub count: Option<f64>,
     /// An error message returned by Jira when validating the JQL query.
     pub error: Option<String>,
@@ -5097,13 +6150,14 @@ impl GraphQLFields for IssueImportJqlCheckPayload {
         "success count error".into()
     }
 }
+/// The result of an issue import mutation, containing the import job and a success indicator.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueImportPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The import job that was created or updated.
-    pub issue_import: Option<Box<IssueImport>>,
+    pub issue_import: Option<IssueImport>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -5113,13 +6167,13 @@ impl GraphQLFields for IssueImportPayload {
         "lastSyncId success".into()
     }
 }
-/// Whether an issue import can be synced at the end of an import or not
+/// The result of checking whether an issue import can be synced with its source service after import completes.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueImportSyncCheckPayload {
     /// Returns true if the import can be synced, false otherwise
     pub can_sync: Option<bool>,
-    /// An error message with a root cause of why the import cannot be synced
+    /// An error message explaining why the import cannot be synced. Null when canSync is true.
     pub error: Option<String>,
 }
 impl GraphQLFields for IssueImportSyncCheckPayload {
@@ -5128,7 +6182,7 @@ impl GraphQLFields for IssueImportSyncCheckPayload {
         "canSync error".into()
     }
 }
-/// Labels that can be associated with issues.
+/// Labels that can be associated with issues. Labels help categorize and filter issues across a workspace. They can be workspace-level (shared across all teams) or team-scoped. Labels have a color for visual identification and can be organized hierarchically into groups, where a parent label acts as a group containing child labels. Labels may also be inherited from parent teams to sub-teams.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueLabel {
@@ -5145,16 +6199,16 @@ pub struct IssueLabel {
     pub name: Option<String>,
     /// The label's description.
     pub description: Option<String>,
-    /// The label's color as a HEX string.
+    /// The label's color as a HEX string (e.g., '#EB5757'). Used for visual identification of the label in the UI.
     pub color: Option<String>,
-    /// Whether the label is a group.
+    /// Whether the label is a group. When true, this label acts as a container for child labels and cannot be directly applied to issues or projects. When false, the label can be directly applied.
     pub is_group: Option<bool>,
-    /// The date when the label was last applied to an issue or project.
+    /// The date when the label was last applied to an issue or project. Null if the label has never been applied.
     pub last_applied_at: Option<chrono::DateTime<chrono::Utc>>,
     /// `Internal` When the label was retired.
     pub retired_at: Option<chrono::DateTime<chrono::Utc>>,
     pub organization: Option<Box<Organization>>,
-    /// The team that the label is associated with. If null, the label is associated with the global workspace.
+    /// The team that the label is scoped to. If null, the label is a workspace-level label available to all teams in the workspace.
     pub team: Option<Box<Team>>,
     /// The user who created the label.
     pub creator: Option<Box<User>>,
@@ -5162,12 +6216,12 @@ pub struct IssueLabel {
     pub retired_by: Option<Box<User>>,
     /// The parent label.
     pub parent: Option<Box<IssueLabel>>,
-    /// The original label inherited from.
+    /// The original workspace or parent-team label that this label was inherited from. Null if the label is not inherited.
     pub inherited_from: Option<Box<IssueLabel>>,
     /// Issues associated with the label.
-    pub issues: Option<Box<IssueConnection>>,
-    /// Children of the label.
-    pub children: Option<Box<IssueLabelConnection>>,
+    pub issues: Option<IssueConnection>,
+    /// Child labels within this label group. Only populated when the label is a group (isGroup is true).
+    pub children: Option<IssueLabelConnection>,
 }
 impl GraphQLFields for IssueLabel {
     type FullType = Self;
@@ -5179,9 +6233,9 @@ impl GraphQLFields for IssueLabel {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueLabelConnection {
-    pub edges: Option<Box<Vec<IssueLabelEdge>>>,
-    pub nodes: Option<Box<Vec<IssueLabel>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<IssueLabelEdge>>,
+    pub nodes: Option<Vec<IssueLabel>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for IssueLabelConnection {
     type FullType = Self;
@@ -5192,7 +6246,7 @@ impl GraphQLFields for IssueLabelConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueLabelEdge {
-    pub node: Option<Box<IssueLabel>>,
+    pub node: Option<IssueLabel>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -5202,13 +6256,14 @@ impl GraphQLFields for IssueLabelEdge {
         "cursor".into()
     }
 }
+/// The result of a label mutation, containing the created or updated label and a success indicator.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueLabelPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The label that was created or updated.
-    pub issue_label: Option<Box<IssueLabel>>,
+    pub issue_label: Option<IssueLabel>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -5218,7 +6273,7 @@ impl GraphQLFields for IssueLabelPayload {
         "lastSyncId success".into()
     }
 }
-/// An issue related notification.
+/// A notification related to an issue, such as assignment, comment, mention, status change, or priority change.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueNotification {
@@ -5237,22 +6292,21 @@ pub struct IssueNotification {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Notification type.
+    /// Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated.
     pub r#type: Option<String>,
-    /// The user that caused the notification.
-    pub actor: Option<Box<User>>,
-    /// The external user that caused the notification.
-    pub external_user_actor: Option<Box<ExternalUser>>,
-    /// The user that received the notification.
-    pub user: Option<Box<User>>,
-    /// The time at when the user marked the notification as read. Null, if the the user hasn't read the notification
+    /// The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event.
+    pub actor: Option<User>,
+    /// The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member.
+    pub external_user_actor: Option<ExternalUser>,
+    /// The recipient user of this notification.
+    pub user: Option<User>,
+    /// The time at which the user marked the notification as read. Null if the notification is unread.
     pub read_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at when an email reminder for this notification was sent to the user. Null, if no email
-    /// reminder has been sent.
+    /// The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent.
     pub emailed_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time until a notification will be snoozed. After that it will appear in the inbox again.
+    /// The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed.
     pub snoozed_until_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which a notification was unsnoozed..
+    /// The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed.
     pub unsnoozed_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The category of the notification.
     pub category: Option<NotificationCategory>,
@@ -5283,17 +6337,17 @@ pub struct IssueNotification {
     /// `Internal` Priority of the notification with the same grouping key. Higher number means higher priority. If priority is the same, notifications should be sorted by `createdAt`.
     pub grouping_priority: Option<f64>,
     /// The bot that caused the notification.
-    pub bot_actor: Option<Box<ActorBot>>,
+    pub bot_actor: Option<ActorBot>,
     /// Related issue ID.
     pub issue_id: Option<String>,
     /// The issue related to the notification.
-    pub issue: Option<Box<Issue>>,
+    pub issue: Option<Issue>,
     /// The comment related to the notification.
-    pub comment: Option<Box<Comment>>,
+    pub comment: Option<Comment>,
     /// The parent comment related to the notification, if a notification is a reply comment notification.
-    pub parent_comment: Option<Box<Comment>>,
+    pub parent_comment: Option<Comment>,
     /// The team related to the issue notification.
-    pub team: Option<Box<Team>>,
+    pub team: Option<Team>,
 }
 impl GraphQLFields for IssueNotification {
     type FullType = Self;
@@ -5302,13 +6356,14 @@ impl GraphQLFields for IssueNotification {
             .into()
     }
 }
+/// The result of an issue mutation, containing the created or updated issue and a success indicator.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssuePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The issue that was created or updated.
-    pub issue: Option<Box<Issue>>,
+    pub issue: Option<Issue>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -5318,6 +6373,7 @@ impl GraphQLFields for IssuePayload {
         "lastSyncId success".into()
     }
 }
+/// A mapping of an issue priority value to its human-readable label.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssuePriorityValue {
@@ -5332,7 +6388,7 @@ impl GraphQLFields for IssuePriorityValue {
         "priority label".into()
     }
 }
-/// A relation between two issues.
+/// A relation between two issues. Issue relations represent directional relationships such as blocking, being blocked by, relating to, or duplicating another issue. Each relation connects a source issue to a related issue with a specific type describing the nature of the relationship.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueRelation {
@@ -5345,12 +6401,12 @@ pub struct IssueRelation {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The relationship of the issue with the related issue.
+    /// The type of relationship between the source issue and the related issue. Possible values include blocks, duplicate, and related.
     pub r#type: Option<String>,
-    /// The issue whose relationship is being described.
-    pub issue: Option<Box<Issue>>,
-    /// The related issue.
-    pub related_issue: Option<Box<Issue>>,
+    /// The source issue whose relationship is being described. This is the issue from which the relation originates.
+    pub issue: Option<Issue>,
+    /// The target issue that the source issue is related to. The relation type describes how the source issue relates to this issue.
+    pub related_issue: Option<Issue>,
 }
 impl GraphQLFields for IssueRelation {
     type FullType = Self;
@@ -5361,9 +6417,9 @@ impl GraphQLFields for IssueRelation {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueRelationConnection {
-    pub edges: Option<Box<Vec<IssueRelationEdge>>>,
-    pub nodes: Option<Box<Vec<IssueRelation>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<IssueRelationEdge>>,
+    pub nodes: Option<Vec<IssueRelation>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for IssueRelationConnection {
     type FullType = Self;
@@ -5374,7 +6430,7 @@ impl GraphQLFields for IssueRelationConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueRelationEdge {
-    pub node: Option<Box<IssueRelation>>,
+    pub node: Option<IssueRelation>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -5384,13 +6440,13 @@ impl GraphQLFields for IssueRelationEdge {
         "cursor".into()
     }
 }
-/// Issue relation history's payload.
+/// Payload describing a change to an issue relation, including which issue was involved and the type of change that occurred.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueRelationHistoryPayload {
-    /// The identifier of the related issue.
+    /// The human-readable identifier of the related issue (e.g., ENG-123).
     pub identifier: Option<String>,
-    /// The type of the change.
+    /// The type of relation change that occurred (e.g., relation added or removed).
     pub r#type: Option<String>,
 }
 impl GraphQLFields for IssueRelationHistoryPayload {
@@ -5399,13 +6455,14 @@ impl GraphQLFields for IssueRelationHistoryPayload {
         "identifier type".into()
     }
 }
+/// The result of an issue relation mutation, containing the created or updated issue relation and a success indicator.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueRelationPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The issue relation that was created or updated.
-    pub issue_relation: Option<Box<IssueRelation>>,
+    pub issue_relation: Option<IssueRelation>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -5418,12 +6475,12 @@ impl GraphQLFields for IssueRelationPayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueSearchPayload {
-    pub edges: Option<Box<Vec<IssueSearchResultEdge>>>,
-    pub nodes: Option<Box<Vec<IssueSearchResult>>>,
-    pub page_info: Option<Box<PageInfo>>,
-    /// Archived entities matching the search term along with all their dependencies.
-    pub archive_payload: Option<Box<ArchiveResponse>>,
-    /// Total number of results for query without filters applied.
+    pub edges: Option<Vec<IssueSearchResultEdge>>,
+    pub nodes: Option<Vec<IssueSearchResult>>,
+    pub page_info: Option<PageInfo>,
+    /// Archived entities matching the search term along with all their dependencies, serialized for the client sync engine.
+    pub archive_payload: Option<ArchiveResponse>,
+    /// Total number of matching results before pagination is applied.
     pub total_count: Option<f64>,
 }
 impl GraphQLFields for IssueSearchPayload {
@@ -5444,19 +6501,19 @@ pub struct IssueSearchResult {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The issue's unique number.
+    /// The issue's unique number, scoped to the issue's team. Together with the team key, this forms the issue's human-readable identifier (e.g., ENG-123).
     pub number: Option<f64>,
-    /// The issue's title.
+    /// The issue's title. This is the primary human-readable summary of the work item.
     pub title: Option<String>,
-    /// The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.
+    /// The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low.
     pub priority: Option<f64>,
-    /// The estimate of the complexity of the issue..
+    /// The estimate of the complexity of the issue. The specific scale used depends on the team's estimation configuration (e.g., points, T-shirt sizes). Null if no estimate has been set.
     pub estimate: Option<f64>,
     /// The order of the item in its column on the board.
     pub board_order: Option<f64>,
-    /// The order of the item in relation to other items in the organization.
+    /// The order of the item in relation to other items in the organization. Used for manual sorting in list views.
     pub sort_order: Option<f64>,
-    /// The order of the item in relation to other items in the organization, when ordered by priority.
+    /// The order of the item in relation to other items in the workspace, when ordered by priority.
     pub priority_sort_order: Option<f64>,
     /// The time at which the issue was moved into started state.
     pub started_at: Option<chrono::DateTime<chrono::Utc>>,
@@ -5499,51 +6556,53 @@ pub struct IssueSearchResult {
     /// `Internal` The activity summary information for this issue.
     pub activity_summary: Option<serde_json::Value>,
     /// `Internal` AI-generated activity summary for this issue.
-    pub summary: Option<Box<Summary>>,
-    /// Id of the labels associated with this issue.
+    pub summary: Option<Summary>,
+    /// Identifiers of the labels associated with this issue. Can be used to query the labels directly.
     pub label_ids: Option<Vec<String>>,
-    /// The team that the issue is associated with.
-    pub team: Option<Box<Team>>,
-    /// The cycle that the issue is associated with.
-    pub cycle: Option<Box<Cycle>>,
-    /// The project that the issue is associated with.
-    pub project: Option<Box<Project>>,
-    /// The projectMilestone that the issue is associated with.
-    pub project_milestone: Option<Box<ProjectMilestone>>,
+    /// The team that the issue belongs to. Every issue must belong to exactly one team, which determines the available workflow states, labels, and other team-specific configuration.
+    pub team: Option<Team>,
+    /// The cycle that the issue is associated with. Null if the issue is not part of any cycle.
+    pub cycle: Option<Cycle>,
+    /// The project that the issue is associated with. Null if the issue is not part of any project.
+    pub project: Option<Project>,
+    /// The project milestone that the issue is associated with. Null if the issue is not assigned to a specific milestone within its project.
+    pub project_milestone: Option<ProjectMilestone>,
     /// The last template that was applied to this issue.
-    pub last_applied_template: Option<Box<Template>>,
+    pub last_applied_template: Option<Template>,
     /// The recurring issue template that created this issue.
-    pub recurring_issue_template: Option<Box<Template>>,
+    pub recurring_issue_template: Option<Template>,
     /// Previous identifiers of the issue if it has been moved between teams.
     pub previous_identifiers: Option<Vec<String>>,
-    /// The user who created the issue.
-    pub creator: Option<Box<User>>,
-    /// The external user who created the issue.
-    pub external_user_creator: Option<Box<ExternalUser>>,
-    /// The user to whom the issue is assigned to.
-    pub assignee: Option<Box<User>>,
-    /// The agent user that is delegated to work on this issue.
-    pub delegate: Option<Box<User>>,
+    /// The user who created the issue. Null if the creator's account has been deleted or if the issue was created by an integration or system process.
+    pub creator: Option<User>,
+    /// The external user who created the issue. Set when the issue was created via an integration (e.g., Slack, Intercom) on behalf of a non-Linear user. Null if the issue was created by a Linear user.
+    pub external_user_creator: Option<ExternalUser>,
+    /// The user to whom the issue is assigned. Null if the issue is unassigned.
+    pub assignee: Option<User>,
+    /// The agent user that is delegated to work on this issue. Set when an AI agent has been assigned to perform work on this issue. Null if no agent is working on the issue.
+    pub delegate: Option<User>,
     /// The user who snoozed the issue.
-    pub snoozed_by: Option<Box<User>>,
-    /// The workflow state that the issue is associated with.
-    pub state: Option<Box<WorkflowState>>,
+    pub snoozed_by: Option<User>,
+    /// The workflow state (issue status) that the issue is currently in. Workflow states represent the issue's progress through the team's workflow, such as Triage, Todo, In Progress, Done, or Canceled.
+    pub state: Option<WorkflowState>,
     /// The order of the item in the sub-issue list. Only set if the issue has a parent.
     pub sub_issue_sort_order: Option<f64>,
-    /// Emoji reaction summary, grouped by emoji type.
+    /// Emoji reaction summary for the issue, grouped by emoji type. Contains the count and reacting user information for each emoji.
     pub reaction_data: Option<serde_json::Value>,
     /// Label for the priority.
     pub priority_label: Option<String>,
-    /// The comment that this issue was created from.
-    pub source_comment: Option<Box<Comment>>,
+    /// The comment that this issue was created from, when an issue is created from an existing comment. Null if the issue was not created from a comment.
+    pub source_comment: Option<Comment>,
     /// Integration type that created this issue, if applicable.
     pub integration_source_type: Option<IntegrationService>,
+    /// Whether this issue inherits shared access from its parent issue.
+    pub inherits_shared_access: Option<bool>,
     /// Documents associated with the issue.
-    pub documents: Option<Box<DocumentConnection>>,
+    pub documents: Option<DocumentConnection>,
     /// The bot that created the issue, if applicable.
-    pub bot_actor: Option<Box<ActorBot>>,
+    pub bot_actor: Option<ActorBot>,
     /// The users favorite associated with this issue.
-    pub favorite: Option<Box<Favorite>>,
+    pub favorite: Option<Favorite>,
     /// Issue's human readable identifier (e.g. ENG-123).
     pub identifier: Option<String>,
     /// Issue URL.
@@ -5551,67 +6610,71 @@ pub struct IssueSearchResult {
     /// Suggested branch name for the issue.
     pub branch_name: Option<String>,
     /// Shared access metadata for this issue.
-    pub shared_access: Option<Box<IssueSharedAccess>>,
+    pub shared_access: Option<IssueSharedAccess>,
     /// Returns the number of Attachment resources which are created by customer support ticketing systems (e.g. Zendesk).
     pub customer_ticket_count: Option<i64>,
     /// Users who are subscribed to the issue.
-    pub subscribers: Option<Box<UserConnection>>,
+    pub subscribers: Option<UserConnection>,
     /// The parent of the issue.
-    pub parent: Option<Box<Issue>>,
+    pub parent: Option<Issue>,
     /// Children of the issue.
-    pub children: Option<Box<IssueConnection>>,
+    pub children: Option<IssueConnection>,
     /// Comments associated with the issue.
-    pub comments: Option<Box<CommentConnection>>,
+    pub comments: Option<CommentConnection>,
+    /// `Internal` AI prompt progresses associated with this issue.
+    pub ai_prompt_progresses: Option<AiPromptProgressConnection>,
     /// History entries associated with the issue.
-    pub history: Option<Box<IssueHistoryConnection>>,
+    pub history: Option<IssueHistoryConnection>,
     /// Labels associated with this issue.
-    pub labels: Option<Box<IssueLabelConnection>>,
+    pub labels: Option<IssueLabelConnection>,
     /// Relations associated with this issue.
-    pub relations: Option<Box<IssueRelationConnection>>,
+    pub relations: Option<IssueRelationConnection>,
     /// Inverse relations associated with this issue.
-    pub inverse_relations: Option<Box<IssueRelationConnection>>,
+    pub inverse_relations: Option<IssueRelationConnection>,
     /// Attachments associated with the issue.
-    pub attachments: Option<Box<AttachmentConnection>>,
+    pub attachments: Option<AttachmentConnection>,
     /// Attachments previously associated with the issue before being moved to another issue.
-    pub former_attachments: Option<Box<AttachmentConnection>>,
+    pub former_attachments: Option<AttachmentConnection>,
     /// The issue's description in markdown format.
     pub description: Option<String>,
     /// `Internal` The issue's description content as YJS state.
     pub description_state: Option<String>,
     /// `ALPHA` The document content representing this issue description.
-    pub document_content: Option<Box<DocumentContent>>,
+    pub document_content: Option<DocumentContent>,
     /// Reactions associated with the issue.
-    pub reactions: Option<Box<Vec<Reaction>>>,
+    pub reactions: Option<Vec<Reaction>>,
     /// Customer needs associated with the issue.
-    pub needs: Option<Box<CustomerNeedConnection>>,
+    pub needs: Option<CustomerNeedConnection>,
     /// Customer needs previously associated with the issue before being moved to another issue.
-    pub former_needs: Option<Box<CustomerNeedConnection>>,
+    pub former_needs: Option<CustomerNeedConnection>,
+    /// `ALPHA` Releases associated with the issue.
+    pub releases: Option<ReleaseConnection>,
     /// The external services the issue is synced with.
-    pub synced_with: Option<Box<Vec<ExternalEntityInfo>>>,
+    pub synced_with: Option<Vec<ExternalEntityInfo>>,
     /// `Internal` Product Intelligence suggestions for the issue.
-    pub suggestions: Option<Box<IssueSuggestionConnection>>,
+    pub suggestions: Option<IssueSuggestionConnection>,
     /// `Internal` Incoming product intelligence relation suggestions for the issue.
-    pub incoming_suggestions: Option<Box<IssueSuggestionConnection>>,
+    pub incoming_suggestions: Option<IssueSuggestionConnection>,
     /// The internal user who requested creation of the Asks issue on behalf of the creator.
-    pub asks_requester: Option<Box<User>>,
+    pub asks_requester: Option<User>,
     /// The external user who requested creation of the Asks issue on behalf of the creator.
-    pub asks_external_user_requester: Option<Box<ExternalUser>>,
+    pub asks_external_user_requester: Option<ExternalUser>,
     /// The issue's workflow states over time.
-    pub state_history: Option<Box<IssueStateSpanConnection>>,
+    pub state_history: Option<IssueStateSpanConnection>,
     /// Metadata related to search result.
     pub metadata: Option<serde_json::Value>,
 }
 impl GraphQLFields for IssueSearchResult {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt number title priority estimate boardOrder sortOrder prioritySortOrder startedAt completedAt startedTriageAt triagedAt canceledAt autoClosedAt autoArchivedAt dueDate slaStartedAt slaMediumRiskAt slaHighRiskAt slaBreachesAt slaType addedToProjectAt addedToCycleAt addedToTeamAt trashed snoozedUntilAt suggestionsGeneratedAt activitySummary labelIds previousIdentifiers subIssueSortOrder reactionData priorityLabel integrationSourceType identifier url branchName customerTicketCount description metadata"
+        "id createdAt updatedAt archivedAt number title priority estimate boardOrder sortOrder prioritySortOrder startedAt completedAt startedTriageAt triagedAt canceledAt autoClosedAt autoArchivedAt dueDate slaStartedAt slaMediumRiskAt slaHighRiskAt slaBreachesAt slaType addedToProjectAt addedToCycleAt addedToTeamAt trashed snoozedUntilAt suggestionsGeneratedAt activitySummary labelIds previousIdentifiers subIssueSortOrder reactionData priorityLabel integrationSourceType inheritsSharedAccess identifier url branchName customerTicketCount description metadata"
             .into()
     }
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueSearchResultEdge {
-    pub node: Option<Box<IssueSearchResult>>,
+    pub node: Option<IssueSearchResult>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -5621,6 +6684,7 @@ impl GraphQLFields for IssueSearchResultEdge {
         "cursor".into()
     }
 }
+/// Metadata about an issue's shared access state, including which users the issue is shared with and any field restrictions for shared-only viewers.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueSharedAccess {
@@ -5631,12 +6695,14 @@ pub struct IssueSharedAccess {
     /// The number of users this issue is shared with.
     pub shared_with_count: Option<i64>,
     /// Users this issue is shared with.
-    pub shared_with_users: Option<Box<Vec<User>>>,
+    pub shared_with_users: Option<Vec<User>>,
+    /// Issue update fields the viewer cannot modify due to shared-only access.
+    pub disallowed_issue_fields: Option<Vec<IssueSharedAccessDisallowedField>>,
 }
 impl GraphQLFields for IssueSharedAccess {
     type FullType = Self;
     fn selection() -> String {
-        "isShared viewerHasOnlySharedAccess sharedWithCount".into()
+        "isShared viewerHasOnlySharedAccess sharedWithCount disallowedIssueFields".into()
     }
 }
 /// A continuous period of time during which an issue remained in a specific workflow state.
@@ -5652,7 +6718,7 @@ pub struct IssueStateSpan {
     /// The timestamp when the issue left this state. Null if the issue is currently in this state.
     pub ended_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The workflow state for this span.
-    pub state: Option<Box<WorkflowState>>,
+    pub state: Option<WorkflowState>,
 }
 impl GraphQLFields for IssueStateSpan {
     type FullType = Self;
@@ -5663,9 +6729,9 @@ impl GraphQLFields for IssueStateSpan {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueStateSpanConnection {
-    pub edges: Option<Box<Vec<IssueStateSpanEdge>>>,
-    pub nodes: Option<Box<Vec<IssueStateSpan>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<IssueStateSpanEdge>>,
+    pub nodes: Option<Vec<IssueStateSpan>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for IssueStateSpanConnection {
     type FullType = Self;
@@ -5676,7 +6742,7 @@ impl GraphQLFields for IssueStateSpanConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueStateSpanEdge {
-    pub node: Option<Box<IssueStateSpan>>,
+    pub node: Option<IssueStateSpan>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -5686,6 +6752,7 @@ impl GraphQLFields for IssueStateSpanEdge {
         "cursor".into()
     }
 }
+/// `Internal` An AI-generated suggestion for an issue. Suggestions can recommend related or similar issues, assignees, labels, teams, or projects. Each suggestion has a type, state (active, accepted, dismissed), and optionally associated metadata with scoring information.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueSuggestion {
@@ -5698,39 +6765,50 @@ pub struct IssueSuggestion {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    pub issue: Option<Box<Issue>>,
+    /// `Internal` The issue that this suggestion applies to.
+    pub issue: Option<Issue>,
+    /// `Internal` Identifier of the issue that this suggestion applies to. Can be used to query the issue directly.
     pub issue_id: Option<String>,
+    /// `Internal` The type of suggestion, indicating what kind of entity is being suggested (e.g., similarIssue, relatedIssue, assignee, label, team, project).
     pub r#type: Option<IssueSuggestionType>,
+    /// `Internal` The current state of the suggestion: active, accepted, or dismissed.
     pub state: Option<IssueSuggestionState>,
+    /// `Internal` The date when the suggestion's state was last changed (e.g., from active to accepted or dismissed).
     pub state_changed_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// `Internal` The reason the suggestion was dismissed by the user. Null if the suggestion has not been dismissed.
     pub dismissal_reason: Option<String>,
-    pub metadata: Option<Box<IssueSuggestionMetadata>>,
-    pub suggested_issue: Option<Box<Issue>>,
+    /// `Internal` Metadata associated with the suggestion, including confidence scores and classification. Null if no metadata is available.
+    pub metadata: Option<IssueSuggestionMetadata>,
+    /// `Internal` The suggested issue, when the suggestion type is similarIssue or relatedIssue. Null for other suggestion types.
+    pub suggested_issue: Option<Issue>,
+    /// `Internal` Identifier of the suggested issue. Set when the suggestion type is similarIssue or relatedIssue. Can be used to query the issue directly.
     pub suggested_issue_id: Option<String>,
-    pub suggested_team: Option<Box<Team>>,
-    pub suggested_project: Option<Box<Project>>,
-    pub suggested_user: Option<Box<User>>,
+    /// `Internal` The suggested team, when the suggestion type is team. Null for other suggestion types.
+    pub suggested_team: Option<Team>,
+    /// `Internal` The suggested project, when the suggestion type is project. Null for other suggestion types.
+    pub suggested_project: Option<Project>,
+    /// `Internal` The suggested user, when the suggestion type is assignee. Null for other suggestion types.
+    pub suggested_user: Option<User>,
+    /// `Internal` Identifier of the suggested user. Set when the suggestion type is assignee. Can be used to query the user directly.
     pub suggested_user_id: Option<String>,
-    pub suggested_label: Option<Box<IssueLabel>>,
+    /// `Internal` The suggested label, when the suggestion type is label. Null for other suggestion types.
+    pub suggested_label: Option<IssueLabel>,
+    /// `Internal` Identifier of the suggested label. Set when the suggestion type is label. Can be used to query the label directly.
     pub suggested_label_id: Option<String>,
-    /// The reasons for the suggestion.
-    pub reasons: Option<Vec<String>>,
-    /// Whether the suggestion should be visible.
-    pub is_visible: Option<bool>,
 }
 impl GraphQLFields for IssueSuggestion {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt issueId type state stateChangedAt dismissalReason suggestedIssueId suggestedUserId suggestedLabelId reasons isVisible"
+        "id createdAt updatedAt archivedAt issueId type state stateChangedAt dismissalReason suggestedIssueId suggestedUserId suggestedLabelId"
             .into()
     }
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueSuggestionConnection {
-    pub edges: Option<Box<Vec<IssueSuggestionEdge>>>,
-    pub nodes: Option<Box<Vec<IssueSuggestion>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<IssueSuggestionEdge>>,
+    pub nodes: Option<Vec<IssueSuggestion>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for IssueSuggestionConnection {
     type FullType = Self;
@@ -5741,7 +6819,7 @@ impl GraphQLFields for IssueSuggestionConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueSuggestionEdge {
-    pub node: Option<Box<IssueSuggestion>>,
+    pub node: Option<IssueSuggestion>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -5751,15 +6829,23 @@ impl GraphQLFields for IssueSuggestionEdge {
         "cursor".into()
     }
 }
+/// `Internal` Metadata associated with an issue suggestion, including scoring and classification information.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueSuggestionMetadata {
+    /// `Internal` The confidence score of the suggestion. Higher values indicate greater confidence. Null if no score was computed.
     pub score: Option<f64>,
+    /// `Internal` The classification category of the suggestion. Null if no classification was assigned.
     pub classification: Option<String>,
+    /// `Internal` The reasons explaining why this suggestion was made. Null if no reasons are available.
     pub reasons: Option<Vec<String>>,
+    /// `Internal` Identifier of the evaluation log entry associated with this suggestion. Null if no log entry exists.
     pub eval_log_id: Option<String>,
+    /// `Internal` The rank of this suggestion relative to other suggestions of the same type. Lower values indicate higher priority. Null if not ranked.
     pub rank: Option<f64>,
+    /// `Internal` The AI prompt variant that generated this suggestion. Null if not applicable.
     pub variant: Option<String>,
+    /// `Internal` Identifier of the automation rule that was applied from this suggestion. Null if no rule was applied.
     pub applied_automation_rule_id: Option<String>,
 }
 impl GraphQLFields for IssueSuggestionMetadata {
@@ -5768,14 +6854,15 @@ impl GraphQLFields for IssueSuggestionMetadata {
         "score classification reasons evalLogId rank variant appliedAutomationRuleId".into()
     }
 }
+/// Return type for AI-generated issue title suggestions based on customer request content.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueTitleSuggestionFromCustomerRequestPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    /// The suggested issue title.
+    /// The AI-suggested issue title based on the customer request content.
     pub title: Option<String>,
-    /// `Internal` The log id of the ai response.
+    /// `Internal` The evaluation log ID of the AI response, for tracing and debugging.
     pub log_id: Option<String>,
 }
 impl GraphQLFields for IssueTitleSuggestionFromCustomerRequestPayload {
@@ -5784,7 +6871,7 @@ impl GraphQLFields for IssueTitleSuggestionFromCustomerRequestPayload {
         "lastSyncId title logId".into()
     }
 }
-/// `Internal` Join table between issues and releases.
+/// `Internal` A join entity linking an issue to a release for release tracking. Each record represents an association between a single issue and a single release, along with metadata about the source of the link (e.g., which pull requests connected the issue to the release). Creating or deleting these associations automatically records the change in issue history.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueToRelease {
@@ -5797,12 +6884,10 @@ pub struct IssueToRelease {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The issue associated with the release.
-    pub issue: Option<Box<Issue>>,
-    /// The release associated with the issue.
-    pub release: Option<Box<Release>>,
-    /// The pull request that linked this issue to the release.
-    pub pull_request: Option<Box<PullRequest>>,
+    /// The issue that is linked to the release.
+    pub issue: Option<Issue>,
+    /// The release that the issue is linked to.
+    pub release: Option<Release>,
 }
 impl GraphQLFields for IssueToRelease {
     type FullType = Self;
@@ -5813,9 +6898,9 @@ impl GraphQLFields for IssueToRelease {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueToReleaseConnection {
-    pub edges: Option<Box<Vec<IssueToReleaseEdge>>>,
-    pub nodes: Option<Box<Vec<IssueToRelease>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<IssueToReleaseEdge>>,
+    pub nodes: Option<Vec<IssueToRelease>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for IssueToReleaseConnection {
     type FullType = Self;
@@ -5826,7 +6911,7 @@ impl GraphQLFields for IssueToReleaseConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueToReleaseEdge {
-    pub node: Option<Box<IssueToRelease>>,
+    pub node: Option<IssueToRelease>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -5836,14 +6921,14 @@ impl GraphQLFields for IssueToReleaseEdge {
         "cursor".into()
     }
 }
-/// `ALPHA` The result of an issueToRelease mutation.
+/// `ALPHA` The result of an issue-to-release mutation, containing the created or updated association and a success indicator.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct IssueToReleasePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The issueToRelease that was created or updated.
-    pub issue_to_release: Option<Box<IssueToRelease>>,
+    pub issue_to_release: Option<IssueToRelease>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -5853,7 +6938,27 @@ impl GraphQLFields for IssueToReleasePayload {
         "lastSyncId success".into()
     }
 }
-/// A label notification subscription.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct JiraFetchProjectStatusesPayload {
+    /// The identifier of the last sync operation.
+    pub last_sync_id: Option<f64>,
+    /// The integration that was created or updated.
+    pub integration: Option<Integration>,
+    /// Whether the operation was successful.
+    pub success: Option<bool>,
+    /// The fetched Jira issue statuses (non-Epic).
+    pub issue_statuses: Option<Vec<String>>,
+    /// The fetched Jira project statuses (Epic).
+    pub project_statuses: Option<Vec<String>>,
+}
+impl GraphQLFields for JiraFetchProjectStatusesPayload {
+    type FullType = Self;
+    fn selection() -> String {
+        "lastSyncId success issueStatuses projectStatuses".into()
+    }
+}
+/// A notification subscription scoped to a specific issue label. The subscriber receives notifications for events related to issues with this label.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct LabelNotificationSubscription {
@@ -5866,52 +6971,98 @@ pub struct LabelNotificationSubscription {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The user that subscribed to receive notifications.
-    pub subscriber: Option<Box<User>>,
-    /// The customer associated with the notification subscription.
-    pub customer: Option<Box<Customer>>,
-    /// The contextual custom view associated with the notification subscription.
-    pub custom_view: Option<Box<CustomView>>,
-    /// The contextual cycle view associated with the notification subscription.
-    pub cycle: Option<Box<Cycle>>,
+    /// The user who will receive notifications from this subscription.
+    pub subscriber: Option<User>,
+    /// The customer that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub customer: Option<Customer>,
+    /// The custom view that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub custom_view: Option<CustomView>,
+    /// The cycle that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub cycle: Option<Cycle>,
     /// The label subscribed to.
-    pub label: Option<Box<IssueLabel>>,
-    /// The contextual project view associated with the notification subscription.
-    pub project: Option<Box<Project>>,
-    /// The contextual initiative view associated with the notification subscription.
-    pub initiative: Option<Box<Initiative>>,
-    /// The team associated with the notification subscription.
-    pub team: Option<Box<Team>>,
-    /// The user view associated with the notification subscription.
-    pub user: Option<Box<User>>,
-    /// The type of view to which the notification subscription context is associated with.
+    pub label: Option<IssueLabel>,
+    /// The project that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub project: Option<Project>,
+    /// The initiative that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub initiative: Option<Initiative>,
+    /// The team that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub team: Option<Team>,
+    /// The user that this notification subscription is scoped to, for user-specific view subscriptions. Null if the subscription targets a different entity type.
+    pub user: Option<User>,
+    /// The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type.
     pub context_view_type: Option<ContextViewType>,
-    /// The type of user view to which the notification subscription context is associated with.
+    /// The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type.
     pub user_context_view_type: Option<UserContextViewType>,
-    /// Whether the subscription is active or not.
+    /// Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists.
     pub active: Option<bool>,
-    /// The type of subscription.
+    /// The notification event types that this subscription will deliver to the subscriber.
     pub notification_subscription_types: Option<Vec<String>>,
 }
-impl GraphQLFields for LabelNotificationSubscription {
+impl GraphQLFields for LabelNotificationSubscription {
+    type FullType = Self;
+    fn selection() -> String {
+        "id createdAt updatedAt archivedAt contextViewType userContextViewType active notificationSubscriptionTypes"
+            .into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct LogoutResponse {
+    /// Whether the operation was successful.
+    pub success: Option<bool>,
+}
+impl GraphQLFields for LogoutResponse {
+    type FullType = Self;
+    fn selection() -> String {
+        "success".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct MicrosoftTeamsChannel {
+    /// The Microsoft Teams channel id (e.g. `19:abc@thread.tacv2`).
+    pub id: Option<String>,
+    /// The display name of the channel.
+    pub display_name: Option<String>,
+    /// The membership type of the channel: standard, private, or shared.
+    pub membership_type: Option<String>,
+}
+impl GraphQLFields for MicrosoftTeamsChannel {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt contextViewType userContextViewType active notificationSubscriptionTypes"
-            .into()
+        "id displayName membershipType".into()
     }
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
-pub struct LogoutResponse {
+pub struct MicrosoftTeamsChannelsPayload {
+    /// The teams the user belongs to with their channels.
+    pub teams: Option<Vec<MicrosoftTeamsTeam>>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
-impl GraphQLFields for LogoutResponse {
+impl GraphQLFields for MicrosoftTeamsChannelsPayload {
     type FullType = Self;
     fn selection() -> String {
         "success".into()
     }
 }
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct MicrosoftTeamsTeam {
+    /// The AAD group id of the team.
+    pub id: Option<String>,
+    /// The display name of the team.
+    pub display_name: Option<String>,
+    /// The channels in the team the user can access.
+    pub channels: Option<Vec<MicrosoftTeamsChannel>>,
+}
+impl GraphQLFields for MicrosoftTeamsTeam {
+    type FullType = Self;
+    fn selection() -> String {
+        "id displayName".into()
+    }
+}
 /// A generic payload return from entity archive mutations.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
@@ -5927,6 +7078,7 @@ impl GraphQLFields for NotificationArchivePayload {
         "lastSyncId success".into()
     }
 }
+/// Return type for batch notification mutations that operate on multiple notifications at once.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct NotificationBatchActionPayload {
@@ -5941,40 +7093,40 @@ impl GraphQLFields for NotificationBatchActionPayload {
         "lastSyncId success".into()
     }
 }
-/// A user's notification category preferences.
+/// A user's fully resolved notification category preferences. Each category maps to channel preferences indicating whether mobile, desktop, email, and Slack delivery are enabled.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct NotificationCategoryPreferences {
     /// The preferences for notifications about assignments.
-    pub assignments: Option<Box<NotificationChannelPreferences>>,
+    pub assignments: Option<NotificationChannelPreferences>,
     /// The preferences for notifications about status changes.
-    pub status_changes: Option<Box<NotificationChannelPreferences>>,
+    pub status_changes: Option<NotificationChannelPreferences>,
     /// The preferences for notifications about comments and replies.
-    pub comments_and_replies: Option<Box<NotificationChannelPreferences>>,
+    pub comments_and_replies: Option<NotificationChannelPreferences>,
     /// The preferences for notifications about mentions.
-    pub mentions: Option<Box<NotificationChannelPreferences>>,
+    pub mentions: Option<NotificationChannelPreferences>,
     /// The preferences for notifications about reactions.
-    pub reactions: Option<Box<NotificationChannelPreferences>>,
+    pub reactions: Option<NotificationChannelPreferences>,
     /// The preferences for notifications about subscriptions.
-    pub subscriptions: Option<Box<NotificationChannelPreferences>>,
+    pub subscriptions: Option<NotificationChannelPreferences>,
     /// The preferences for notifications about document changes.
-    pub document_changes: Option<Box<NotificationChannelPreferences>>,
+    pub document_changes: Option<NotificationChannelPreferences>,
     /// The preferences for notifications about posts and updates.
-    pub posts_and_updates: Option<Box<NotificationChannelPreferences>>,
+    pub posts_and_updates: Option<NotificationChannelPreferences>,
     /// The preferences for notifications about reminders.
-    pub reminders: Option<Box<NotificationChannelPreferences>>,
+    pub reminders: Option<NotificationChannelPreferences>,
     /// The preferences for notifications about reviews.
-    pub reviews: Option<Box<NotificationChannelPreferences>>,
+    pub reviews: Option<NotificationChannelPreferences>,
     /// The preferences for notifications about apps and integrations.
-    pub apps_and_integrations: Option<Box<NotificationChannelPreferences>>,
+    pub apps_and_integrations: Option<NotificationChannelPreferences>,
     /// The preferences for system notifications.
-    pub system: Option<Box<NotificationChannelPreferences>>,
+    pub system: Option<NotificationChannelPreferences>,
     /// The preferences for triage notifications.
-    pub triage: Option<Box<NotificationChannelPreferences>>,
+    pub triage: Option<NotificationChannelPreferences>,
     /// The preferences for customer notifications.
-    pub customers: Option<Box<NotificationChannelPreferences>>,
+    pub customers: Option<NotificationChannelPreferences>,
     /// The preferences for feed summary notifications.
-    pub feed: Option<Box<NotificationChannelPreferences>>,
+    pub feed: Option<NotificationChannelPreferences>,
 }
 impl GraphQLFields for NotificationCategoryPreferences {
     type FullType = Self;
@@ -5982,7 +7134,7 @@ impl GraphQLFields for NotificationCategoryPreferences {
         "".into()
     }
 }
-/// A user's notification channel preferences, indicating if a channel is enabled or not
+/// A user's resolved notification channel preferences, indicating whether each delivery channel (mobile, desktop, email, Slack) is enabled or disabled.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct NotificationChannelPreferences {
@@ -6004,8 +7156,8 @@ impl GraphQLFields for NotificationChannelPreferences {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct NotificationConnection {
-    pub edges: Option<Box<Vec<NotificationEdge>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<NotificationEdge>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for NotificationConnection {
     type FullType = Self;
@@ -6013,12 +7165,12 @@ impl GraphQLFields for NotificationConnection {
         "".into()
     }
 }
-/// A user's notification delivery preferences.
+/// A user's notification delivery preferences across channels. Currently only supports mobile channel delivery scheduling.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct NotificationDeliveryPreferences {
     /// The delivery preferences for the mobile channel.
-    pub mobile: Option<Box<NotificationDeliveryPreferencesChannel>>,
+    pub mobile: Option<NotificationDeliveryPreferencesChannel>,
 }
 impl GraphQLFields for NotificationDeliveryPreferences {
     type FullType = Self;
@@ -6026,14 +7178,14 @@ impl GraphQLFields for NotificationDeliveryPreferences {
         "".into()
     }
 }
-/// A user's notification delivery preferences.
+/// Delivery preferences for a specific notification channel, including an optional delivery schedule that restricts when notifications are sent.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct NotificationDeliveryPreferencesChannel {
     /// `DEPRECATED` Whether notifications are enabled for this channel. Use notificationChannelPreferences instead.
     pub notifications_disabled: Option<bool>,
     /// The schedule for notifications on this channel.
-    pub schedule: Option<Box<NotificationDeliveryPreferencesSchedule>>,
+    pub schedule: Option<NotificationDeliveryPreferencesSchedule>,
 }
 impl GraphQLFields for NotificationDeliveryPreferencesChannel {
     type FullType = Self;
@@ -6041,13 +7193,13 @@ impl GraphQLFields for NotificationDeliveryPreferencesChannel {
         "notificationsDisabled".into()
     }
 }
-/// A user's notification delivery schedule for a particular day.
+/// A user's notification delivery window for a specific day of the week. Defines the time range during which notifications will be delivered.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct NotificationDeliveryPreferencesDay {
-    /// The time notifications start.
+    /// The start time of the notification delivery window in HH:MM military time format (e.g., '09:00'). Must be earlier than 'end'.
     pub start: Option<String>,
-    /// The time notifications end.
+    /// The end time of the notification delivery window in HH:MM military time format (e.g., '18:00'). Must be later than 'start'.
     pub end: Option<String>,
 }
 impl GraphQLFields for NotificationDeliveryPreferencesDay {
@@ -6056,26 +7208,26 @@ impl GraphQLFields for NotificationDeliveryPreferencesDay {
         "start end".into()
     }
 }
-/// A user's notification delivery schedule for a particular day.
+/// A user's weekly notification delivery schedule, defining delivery windows for each day of the week. Notifications outside these windows are held and delivered when the window opens.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct NotificationDeliveryPreferencesSchedule {
-    /// Whether the schedule is disabled.
+    /// Whether the entire delivery schedule is disabled. When true, notifications are delivered at any time regardless of the per-day settings.
     pub disabled: Option<bool>,
     /// Delivery preferences for Sunday.
-    pub sunday: Option<Box<NotificationDeliveryPreferencesDay>>,
+    pub sunday: Option<NotificationDeliveryPreferencesDay>,
     /// Delivery preferences for Monday.
-    pub monday: Option<Box<NotificationDeliveryPreferencesDay>>,
+    pub monday: Option<NotificationDeliveryPreferencesDay>,
     /// Delivery preferences for Tuesday.
-    pub tuesday: Option<Box<NotificationDeliveryPreferencesDay>>,
+    pub tuesday: Option<NotificationDeliveryPreferencesDay>,
     /// Delivery preferences for Wednesday.
-    pub wednesday: Option<Box<NotificationDeliveryPreferencesDay>>,
+    pub wednesday: Option<NotificationDeliveryPreferencesDay>,
     /// Delivery preferences for Thursday.
-    pub thursday: Option<Box<NotificationDeliveryPreferencesDay>>,
+    pub thursday: Option<NotificationDeliveryPreferencesDay>,
     /// Delivery preferences for Friday.
-    pub friday: Option<Box<NotificationDeliveryPreferencesDay>>,
+    pub friday: Option<NotificationDeliveryPreferencesDay>,
     /// Delivery preferences for Saturday.
-    pub saturday: Option<Box<NotificationDeliveryPreferencesDay>>,
+    pub saturday: Option<NotificationDeliveryPreferencesDay>,
 }
 impl GraphQLFields for NotificationDeliveryPreferencesSchedule {
     type FullType = Self;
@@ -6095,6 +7247,7 @@ impl GraphQLFields for NotificationEdge {
         "cursor".into()
     }
 }
+/// Return type for notification mutations.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct NotificationPayload {
@@ -6112,8 +7265,8 @@ impl GraphQLFields for NotificationPayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct NotificationSubscriptionConnection {
-    pub edges: Option<Box<Vec<NotificationSubscriptionEdge>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<NotificationSubscriptionEdge>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for NotificationSubscriptionConnection {
     type FullType = Self;
@@ -6133,6 +7286,7 @@ impl GraphQLFields for NotificationSubscriptionEdge {
         "cursor".into()
     }
 }
+/// The result of a notification subscription mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct NotificationSubscriptionPayload {
@@ -6147,7 +7301,7 @@ impl GraphQLFields for NotificationSubscriptionPayload {
         "lastSyncId success".into()
     }
 }
-/// Request to install OAuth clients on organizations and the response to the request.
+/// A request to install an OAuth client application on a workspace, along with the admin's approval or denial response. When a user attempts to install an OAuth application that requires admin approval, an approval record is created. A workspace admin can then approve or deny the request, optionally providing a reason. The record also tracks any newly requested scopes that were added after the initial approval.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct OauthClientApproval {
@@ -6160,21 +7314,21 @@ pub struct OauthClientApproval {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The uuid of the OAuth client being requested for installation.
+    /// The identifier of the OAuth client application being requested for installation in this workspace.
     pub oauth_client_id: Option<String>,
-    /// The person who requested installing the OAuth client.
+    /// The identifier of the user who initiated the request to install the OAuth client application.
     pub requester_id: Option<String>,
-    /// The person who responded to the request to install the OAuth client.
+    /// The identifier of the workspace admin who approved or denied the installation request. Null if the request has not yet been responded to.
     pub responder_id: Option<String>,
-    /// The status for the OAuth client approval request.
+    /// The current status of the approval request: requested (pending admin review), approved, or denied.
     pub status: Option<OAuthClientApprovalStatus>,
-    /// The scopes the app has been approved for.
+    /// The OAuth scopes that the application has been approved to use within this workspace (e.g., 'read', 'write', 'issues:create').
     pub scopes: Option<Vec<String>>,
-    /// The reason the person wants to install this OAuth client.
+    /// An optional message from the requester explaining why they want to install the OAuth application.
     pub request_reason: Option<String>,
-    /// The reason the request for the OAuth client approval was denied.
+    /// An optional explanation from the admin for why the installation request was denied.
     pub deny_reason: Option<String>,
-    /// New scopes that were requested for approval after the initial request.
+    /// Additional OAuth scopes requested after the initial approval. These scopes are not yet approved and require a separate admin decision. Null if no additional scopes have been requested. These scopes will never overlap with the already-approved scopes.
     pub newly_requested_scopes: Option<Vec<String>>,
 }
 impl GraphQLFields for OauthClientApproval {
@@ -6184,7 +7338,7 @@ impl GraphQLFields for OauthClientApproval {
             .into()
     }
 }
-/// An oauth client approval related notification.
+/// A notification related to an OAuth client approval request, sent to workspace admins when an application requests access.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct OauthClientApprovalNotification {
@@ -6197,22 +7351,21 @@ pub struct OauthClientApprovalNotification {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Notification type.
+    /// Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated.
     pub r#type: Option<String>,
-    /// The user that caused the notification.
-    pub actor: Option<Box<User>>,
-    /// The external user that caused the notification.
-    pub external_user_actor: Option<Box<ExternalUser>>,
-    /// The user that received the notification.
-    pub user: Option<Box<User>>,
-    /// The time at when the user marked the notification as read. Null, if the the user hasn't read the notification
+    /// The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event.
+    pub actor: Option<User>,
+    /// The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member.
+    pub external_user_actor: Option<ExternalUser>,
+    /// The recipient user of this notification.
+    pub user: Option<User>,
+    /// The time at which the user marked the notification as read. Null if the notification is unread.
     pub read_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at when an email reminder for this notification was sent to the user. Null, if no email
-    /// reminder has been sent.
+    /// The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent.
     pub emailed_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time until a notification will be snoozed. After that it will appear in the inbox again.
+    /// The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed.
     pub snoozed_until_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which a notification was unsnoozed..
+    /// The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed.
     pub unsnoozed_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The category of the notification.
     pub category: Option<NotificationCategory>,
@@ -6243,11 +7396,11 @@ pub struct OauthClientApprovalNotification {
     /// `Internal` Priority of the notification with the same grouping key. Higher number means higher priority. If priority is the same, notifications should be sorted by `createdAt`.
     pub grouping_priority: Option<f64>,
     /// The bot that caused the notification.
-    pub bot_actor: Option<Box<ActorBot>>,
+    pub bot_actor: Option<ActorBot>,
     /// Related OAuth client approval request ID.
     pub oauth_client_approval_id: Option<String>,
     /// The OAuth client approval request related to the notification.
-    pub oauth_client_approval: Option<Box<OauthClientApproval>>,
+    pub oauth_client_approval: Option<OauthClientApproval>,
 }
 impl GraphQLFields for OauthClientApprovalNotification {
     type FullType = Self;
@@ -6256,7 +7409,7 @@ impl GraphQLFields for OauthClientApprovalNotification {
             .into()
     }
 }
-/// An organization. Organizations are root-level objects that contain user accounts and teams.
+/// A workspace (referred to as Organization in the API). Workspaces are the root-level container for all teams, users, projects, issues, and settings. Every user belongs to at least one workspace, and all data is scoped within a workspace boundary.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Organization {
@@ -6269,130 +7422,146 @@ pub struct Organization {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The organization's name.
+    /// The workspace's name.
     pub name: Option<String>,
-    /// The organization's unique URL key.
+    /// The workspace's unique URL key, used in URLs to identify the workspace.
     pub url_key: Option<String>,
-    /// The organization's logo URL.
+    /// The URL of the workspace's logo image. Null if no logo has been uploaded.
     pub logo_url: Option<String>,
-    /// Rolling 30-day total upload volume for the organization, in megabytes.
+    /// Rolling 30-day total file upload volume for the workspace, measured in megabytes. Used for enforcing upload quotas.
     pub period_upload_volume: Option<f64>,
-    /// `Internal` Facets associated with the organization.
-    pub facets: Option<Box<Vec<Facet>>>,
-    /// How git branches are formatted. If null, default formatting will be used.
+    /// `Internal` Facets associated with the workspace, used for configuring custom views and filters.
+    pub facets: Option<Vec<Facet>>,
+    /// The template format for Git branch names created from issues. Supports template variables like {issueIdentifier} and {issueTitle}. If null, the default formatting will be used.
     pub git_branch_format: Option<String>,
-    /// Whether the Git integration linkback messages should be sent to private repositories.
+    /// Whether the Git integration linkback messages should be posted as comments on pull requests in private repositories.
     pub git_linkback_messages_enabled: Option<bool>,
-    /// Whether the Git integration linkback messages should be sent to public repositories.
+    /// Whether the Git integration linkback messages should be posted as comments on pull requests in public repositories.
     pub git_public_linkback_messages_enabled: Option<bool>,
-    /// Whether issue descriptions should be included in Git integration linkback messages.
+    /// Whether issue descriptions should be included in the Git integration linkback messages posted to pull requests.
     pub git_linkback_descriptions_enabled: Option<bool>,
-    /// Whether the organization is using a roadmap.
+    /// Whether the roadmap feature is enabled for the workspace.
     pub roadmap_enabled: Option<bool>,
-    /// The n-weekly frequency at which to prompt for project updates. When not set, reminders are off.
+    /// The frequency in weeks at which to prompt for project updates. When null, project update reminders are disabled. Valid values range from 0 to 8.
     pub project_update_reminder_frequency_in_weeks: Option<f64>,
-    /// The day at which to prompt for project updates.
+    /// The day of the week on which project update reminders are sent.
     pub project_update_reminders_day: Option<Day>,
-    /// The hour at which to prompt for project updates.
+    /// The hour of the day (0-23) at which project update reminders are sent.
     pub project_update_reminders_hour: Option<f64>,
-    /// The n-weekly frequency at which to prompt for initiative updates. When not set, reminders are off.
+    /// The frequency in weeks at which to prompt for initiative updates. When null, initiative update reminders are disabled. Valid values range from 0 to 8.
     pub initiative_update_reminder_frequency_in_weeks: Option<f64>,
-    /// The day at which to prompt for initiative updates.
+    /// The day of the week on which initiative update reminders are sent.
     pub initiative_update_reminders_day: Option<Day>,
-    /// The hour at which to prompt for initiative updates.
+    /// The hour of the day (0-23) at which initiative update reminders are sent.
     pub initiative_update_reminders_hour: Option<f64>,
-    /// The month at which the fiscal year starts. Defaults to January (0).
+    /// The zero-indexed month at which the fiscal year starts (0 = January, 11 = December). Defaults to 0 (January).
     pub fiscal_year_start_month: Option<f64>,
     /// `Internal` The list of working days. Sunday is 0, Monday is 1, etc.
     pub working_days: Option<Vec<f64>>,
-    /// Whether SAML authentication is enabled for organization.
+    /// Whether SAML-based single sign-on authentication is enabled for the workspace.
     pub saml_enabled: Option<bool>,
     /// `INTERNAL` SAML settings.
     pub saml_settings: Option<serde_json::Value>,
-    /// Whether SCIM provisioning is enabled for organization.
+    /// Whether SCIM provisioning is enabled for the workspace, allowing automated user and team management from an identity provider.
     pub scim_enabled: Option<bool>,
     /// `INTERNAL` SCIM settings.
     pub scim_settings: Option<serde_json::Value>,
-    /// Security settings for the organization.
+    /// Security settings for the workspace, including role-based restrictions for invitations, team creation, label management, and other sensitive operations.
     pub security_settings: Option<serde_json::Value>,
+    /// Authentication settings for the workspace, including allowed auth providers, bypass rules, and organization visibility during signup.
+    pub auth_settings: Option<serde_json::Value>,
     /// Allowed authentication providers, empty array means all are allowed.
     pub allowed_auth_services: Option<Vec<String>>,
     /// Allowed file upload content types
     pub allowed_file_upload_content_types: Option<Vec<String>>,
     /// IP restriction configurations.
-    pub ip_restrictions: Option<Box<Vec<OrganizationIpRestriction>>>,
-    /// The time at which deletion of the organization was requested.
+    pub ip_restrictions: Option<Vec<OrganizationIpRestriction>>,
+    /// The time at which deletion of the workspace was requested. Null if no deletion has been requested.
     pub deletion_requested_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the trial will end.
+    /// The time at which the current plan trial will end. Null if the workspace is not in a trial period.
     pub trial_ends_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the trial started.
+    /// The time at which the current plan trial started. Null if the workspace is not in a trial period.
     pub trial_starts_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Previously used URL keys for the organization (last 3 are kept and redirected).
+    /// Previously used URL keys for the workspace. The last 3 are kept and automatically redirected to the current URL key.
     pub previous_url_keys: Option<Vec<String>>,
-    /// Whether HIPAA compliance is enabled for organization.
+    /// `Internal` Whether agent invocation is restricted to full workspace members.
+    pub restrict_agent_invocation_to_members: Option<bool>,
+    /// Whether HIPAA compliance is enabled for the workspace. When enabled, certain data processing features are restricted to meet compliance requirements.
     pub hipaa_compliance_enabled: Option<bool>,
-    /// `ALPHA` Theme settings for the organization.
+    /// `ALPHA` Theme settings for the workspace.
     pub theme_settings: Option<serde_json::Value>,
-    /// The feature release channel the organization belongs to.
+    /// The feature release channel the workspace belongs to, which controls access to pre-release features.
     pub release_channel: Option<ReleaseChannel>,
-    /// Configuration settings for the Customers feature.
+    /// Configuration settings for the Customers feature, including revenue currency and other customer tracking preferences.
     pub customers_configuration: Option<serde_json::Value>,
-    /// `INTERNAL` Whether code intelligence is enabled for the organization.
+    /// `INTERNAL` Whether code intelligence is enabled for the workspace.
     pub code_intelligence_enabled: Option<bool>,
     /// `INTERNAL` GitHub repository in owner/repo format for code intelligence.
     pub code_intelligence_repository: Option<String>,
     /// Default schedule for how often feed summaries are generated.
     pub default_feed_summary_schedule: Option<FeedSummarySchedule>,
-    /// Whether the organization has enabled the feed feature.
+    /// Whether the activity feed feature is enabled for the workspace.
     pub feed_enabled: Option<bool>,
     /// Whether to hide other organizations for new users signing up with email domains claimed by this organization.
     pub hide_non_primary_organizations: Option<bool>,
-    /// `INTERNAL` Whether the organization has enabled the AI add-on (which at this point only includes triage suggestions).
+    /// `INTERNAL` Whether the workspace has enabled the AI add-on (which at this point only includes triage suggestions).
     pub ai_addon_enabled: Option<bool>,
-    /// `INTERNAL` Whether the organization has enabled generated updates.
+    /// `INTERNAL` Whether the workspace has enabled agent automation.
+    pub agent_automation_enabled: Option<bool>,
+    /// `INTERNAL` Whether the workspace has enabled generated updates.
     pub generated_updates_enabled: Option<bool>,
-    /// Whether the organization has enabled resolved thread AI summaries.
+    /// Whether the workspace has enabled resolved thread AI summaries.
     pub ai_thread_summaries_enabled: Option<bool>,
-    /// Whether the organization has enabled AI discussion summaries for issues.
+    /// Whether the workspace has enabled AI discussion summaries for issues.
     pub ai_discussion_summaries_enabled: Option<bool>,
     /// `INTERNAL` Configure per-modality AI host providers and model families.
     pub ai_provider_configuration: Option<serde_json::Value>,
-    /// `Internal` Whether the organization has enabled Linear Agent.
+    /// `Internal` Whether the workspace has enabled Linear Agent.
     pub linear_agent_enabled: Option<bool>,
+    /// `Internal` Settings for Linear Agent features.
+    pub linear_agent_settings: Option<serde_json::Value>,
+    /// `INTERNAL` Whether the workspace has enabled the Coding Agent.
+    pub coding_agent_enabled: Option<bool>,
     /// `DEPRECATED` Which day count to use for SLA calculations.
     pub sla_day_count: Option<SLADayCountType>,
     /// `DEPRECATED` The frequency at which to prompt for project updates.
     pub project_updates_reminder_frequency: Option<ProjectUpdateReminderFrequency>,
     /// `INTERNAL` Permitted AI providers.
     pub allowed_ai_providers: Option<Vec<String>>,
-    /// Users associated with the organization.
-    pub users: Option<Box<UserConnection>>,
-    /// Teams associated with the organization.
-    pub teams: Option<Box<TeamConnection>>,
-    /// The organization's project statuses.
-    pub project_statuses: Option<Box<Vec<ProjectStatus>>>,
-    /// Integrations associated with the organization.
-    pub integrations: Option<Box<IntegrationConnection>>,
+    /// Users belonging to the workspace. By default only returns active users; use the includeDisabled argument to include deactivated users.
+    pub users: Option<UserConnection>,
+    /// Teams in the workspace. Returns only teams visible to the requesting user (all public teams plus private teams the user is a member of).
+    pub teams: Option<TeamConnection>,
+    /// The workspace's available project statuses, which define the lifecycle stages for projects.
+    pub project_statuses: Option<Vec<ProjectStatus>>,
+    /// Third-party integrations configured for the workspace (e.g., GitHub, Slack, Figma).
+    pub integrations: Option<IntegrationConnection>,
     /// The Slack integration used for auto-creating project channels.
     pub slack_project_channel_integration: Option<Box<Integration>>,
     /// The prefix used for auto-created Slack project channels.
     pub slack_project_channel_prefix: Option<String>,
-    /// The organization's subscription to a paid plan.
+    /// `Internal` Whether the Slack project channels feature is enabled for the workspace.
+    pub slack_project_channels_enabled: Option<bool>,
+    /// `Internal` Whether to automatically create a Slack channel when a new project is created.
+    pub slack_auto_create_project_channel: Option<bool>,
+    /// The workspace's subscription to a paid plan.
     pub subscription: Option<Box<PaidSubscription>>,
-    /// Number of active users in the organization.
+    /// The number of active (non-deactivated) users in the workspace.
     pub user_count: Option<i64>,
-    /// Aproximate number of issues in the organization, including archived ones.
+    /// Approximate total number of issues created in the workspace, including archived ones. This count is cached and may not reflect the exact real-time count.
     pub created_issue_count: Option<i64>,
-    /// Templates associated with the organization.
-    pub templates: Option<Box<TemplateConnection>>,
-    /// Labels associated with the organization.
-    pub labels: Option<Box<IssueLabelConnection>>,
-    /// Project labels associated with the organization.
-    pub project_labels: Option<Box<ProjectLabelConnection>>,
-    /// Number of customers in the organization.
+    /// Workspace-level templates (not associated with any specific team). These templates are available across all teams in the workspace.
+    pub templates: Option<TemplateConnection>,
+    /// Workspace-level issue labels (not associated with any specific team). These labels are available across all teams in the workspace.
+    pub labels: Option<IssueLabelConnection>,
+    /// Project labels available in the workspace for categorizing projects.
+    pub project_labels: Option<ProjectLabelConnection>,
+    /// The number of active (non-archived) customers tracked in the workspace.
     pub customer_count: Option<i64>,
-    /// Whether the organization is using Customers.
+    /// Whether the Customers feature is enabled and accessible for the workspace based on the current plan.
     pub customers_enabled: Option<bool>,
+    /// `Internal` Whether release management is enabled for the workspace.
+    pub releases_enabled: Option<bool>,
     /// `DEPRECATED` Whether member users are allowed to send invites.
     pub allow_members_to_invite: Option<bool>,
     /// `DEPRECATED` Whether team creation is restricted to admins.
@@ -6403,7 +7572,7 @@ pub struct Organization {
 impl GraphQLFields for Organization {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt name urlKey logoUrl periodUploadVolume gitBranchFormat gitLinkbackMessagesEnabled gitPublicLinkbackMessagesEnabled gitLinkbackDescriptionsEnabled roadmapEnabled projectUpdateReminderFrequencyInWeeks projectUpdateRemindersDay projectUpdateRemindersHour initiativeUpdateReminderFrequencyInWeeks initiativeUpdateRemindersDay initiativeUpdateRemindersHour fiscalYearStartMonth workingDays samlEnabled samlSettings scimEnabled scimSettings securitySettings allowedAuthServices allowedFileUploadContentTypes deletionRequestedAt trialEndsAt trialStartsAt previousUrlKeys hipaaComplianceEnabled themeSettings releaseChannel customersConfiguration codeIntelligenceEnabled codeIntelligenceRepository defaultFeedSummarySchedule feedEnabled hideNonPrimaryOrganizations aiAddonEnabled generatedUpdatesEnabled aiThreadSummariesEnabled aiDiscussionSummariesEnabled aiProviderConfiguration linearAgentEnabled slaDayCount projectUpdatesReminderFrequency allowedAiProviders slackProjectChannelPrefix userCount createdIssueCount customerCount customersEnabled allowMembersToInvite restrictTeamCreationToAdmins restrictLabelManagementToAdmins"
+        "id createdAt updatedAt archivedAt name urlKey logoUrl periodUploadVolume gitBranchFormat gitLinkbackMessagesEnabled gitPublicLinkbackMessagesEnabled gitLinkbackDescriptionsEnabled roadmapEnabled projectUpdateReminderFrequencyInWeeks projectUpdateRemindersDay projectUpdateRemindersHour initiativeUpdateReminderFrequencyInWeeks initiativeUpdateRemindersDay initiativeUpdateRemindersHour fiscalYearStartMonth workingDays samlEnabled samlSettings scimEnabled scimSettings securitySettings authSettings allowedAuthServices allowedFileUploadContentTypes deletionRequestedAt trialEndsAt trialStartsAt previousUrlKeys restrictAgentInvocationToMembers hipaaComplianceEnabled themeSettings releaseChannel customersConfiguration codeIntelligenceEnabled codeIntelligenceRepository defaultFeedSummarySchedule feedEnabled hideNonPrimaryOrganizations aiAddonEnabled agentAutomationEnabled generatedUpdatesEnabled aiThreadSummariesEnabled aiDiscussionSummariesEnabled aiProviderConfiguration linearAgentEnabled linearAgentSettings codingAgentEnabled slaDayCount projectUpdatesReminderFrequency allowedAiProviders slackProjectChannelPrefix slackProjectChannelsEnabled slackAutoCreateProjectChannel userCount createdIssueCount customerCount customersEnabled releasesEnabled allowMembersToInvite restrictTeamCreationToAdmins restrictLabelManagementToAdmins"
             .into()
     }
 }
@@ -6419,6 +7588,7 @@ impl GraphQLFields for OrganizationAcceptedOrExpiredInviteDetailsPayload {
         "status".into()
     }
 }
+/// Workspace deletion cancellation response.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct OrganizationCancelDeletePayload {
@@ -6431,6 +7601,7 @@ impl GraphQLFields for OrganizationCancelDeletePayload {
         "success".into()
     }
 }
+/// Workspace deletion operation response.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct OrganizationDeletePayload {
@@ -6443,7 +7614,7 @@ impl GraphQLFields for OrganizationDeletePayload {
         "success".into()
     }
 }
-/// Defines the use of a domain by an organization.
+/// A verified email domain associated with a workspace. Domains are used for automatic team joining, SSO/SAML authentication, and controlling workspace access. Each domain has an authentication type (general or SAML) and can be verified via email or DNS.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct OrganizationDomain {
@@ -6457,20 +7628,20 @@ pub struct OrganizationDomain {
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The identity provider the domain belongs to.
-    pub identity_provider: Option<Box<IdentityProvider>>,
-    /// Domain name.
+    pub identity_provider: Option<IdentityProvider>,
+    /// The domain name (e.g., 'example.com').
     pub name: Option<String>,
-    /// Is this domain verified.
+    /// Whether the domain has been verified via email verification.
     pub verified: Option<bool>,
-    /// E-mail used to verify this domain.
+    /// The email address used to verify this domain. Null if the domain was verified via DNS or has not been verified.
     pub verification_email: Option<String>,
     /// The user who added the domain.
-    pub creator: Option<Box<User>>,
-    /// What type of auth is the domain used for.
+    pub creator: Option<User>,
+    /// The authentication type this domain is used for. 'general' means standard email-based auth, 'saml' means SAML SSO authentication.
     pub auth_type: Option<OrganizationDomainAuthType>,
-    /// Whether the domains was claimed by the organization through DNS verification.
+    /// Whether the domain was claimed by the workspace through DNS TXT record verification. Claimed domains provide stronger ownership proof than email verification and enable additional features like preventing users from creating new workspaces.
     pub claimed: Option<bool>,
-    /// Prevent users with this domain to create new workspaces.
+    /// Whether users with email addresses from this domain are prevented from creating new workspaces. Can only be set on claimed domains.
     pub disable_organization_creation: Option<bool>,
 }
 impl GraphQLFields for OrganizationDomain {
@@ -6499,8 +7670,8 @@ impl GraphQLFields for OrganizationDomainClaimPayload {
 pub struct OrganizationDomainPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    /// The organization domain that was created or updated.
-    pub organization_domain: Option<Box<OrganizationDomain>>,
+    /// The workspace domain that was created or updated.
+    pub organization_domain: Option<OrganizationDomain>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -6523,6 +7694,7 @@ impl GraphQLFields for OrganizationDomainSimplePayload {
         "success".into()
     }
 }
+/// Response for checking whether a workspace exists.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct OrganizationExistsPayload {
@@ -6537,7 +7709,7 @@ impl GraphQLFields for OrganizationExistsPayload {
         "success exists".into()
     }
 }
-/// An invitation to the organization that has been sent via email.
+/// A pending invitation to join the workspace, sent via email. Invites specify the role the invitee will receive and can optionally include team assignments. Invites can expire and must be accepted by the invitee to grant workspace access.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct OrganizationInvite {
@@ -6550,24 +7722,24 @@ pub struct OrganizationInvite {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The invitees email address.
+    /// The email address of the person being invited to the workspace.
     pub email: Option<String>,
-    /// The user role that the invitee will receive upon accepting the invite.
+    /// The workspace role (admin, member, guest, or owner) that the invitee will receive upon accepting the invite.
     pub role: Option<UserRoleType>,
-    /// The invite was sent to external address.
+    /// Whether the invite was sent to an email address outside the workspace's verified domains.
     pub external: Option<bool>,
-    /// The time at which the invite was accepted. Null, if the invite hasn't been accepted.
+    /// The time at which the invite was accepted by the invitee. Null if the invite is still pending.
     pub accepted_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the invite will be expiring. Null, if the invite shouldn't expire.
+    /// The time at which the invite will expire and can no longer be accepted. Null if the invite does not have an expiration date.
     pub expires_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Extra metadata associated with the organization invite.
+    /// Extra metadata associated with the invite.
     pub metadata: Option<serde_json::Value>,
     /// The user who created the invitation.
-    pub inviter: Option<Box<User>>,
+    pub inviter: Option<User>,
     /// The user who has accepted the invite. Null, if the invite hasn't been accepted.
-    pub invitee: Option<Box<User>>,
-    /// The organization that the invite is associated with.
-    pub organization: Option<Box<Organization>>,
+    pub invitee: Option<User>,
+    /// The workspace that the invite is associated with.
+    pub organization: Option<Organization>,
 }
 impl GraphQLFields for OrganizationInvite {
     type FullType = Self;
@@ -6578,9 +7750,9 @@ impl GraphQLFields for OrganizationInvite {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct OrganizationInviteConnection {
-    pub edges: Option<Box<Vec<OrganizationInviteEdge>>>,
-    pub nodes: Option<Box<Vec<OrganizationInvite>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<OrganizationInviteEdge>>,
+    pub nodes: Option<Vec<OrganizationInvite>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for OrganizationInviteConnection {
     type FullType = Self;
@@ -6591,7 +7763,7 @@ impl GraphQLFields for OrganizationInviteConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct OrganizationInviteEdge {
-    pub node: Option<Box<OrganizationInvite>>,
+    pub node: Option<OrganizationInvite>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -6634,13 +7806,14 @@ impl GraphQLFields for OrganizationInviteFullDetailsPayload {
             .into()
     }
 }
+/// Workspace invite operation response.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct OrganizationInvitePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The organization invite that was created or updated.
-    pub organization_invite: Option<Box<OrganizationInvite>>,
+    pub organization_invite: Option<OrganizationInvite>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -6650,6 +7823,7 @@ impl GraphQLFields for OrganizationInvitePayload {
         "lastSyncId success".into()
     }
 }
+/// `INTERNAL` IP restriction rule for a workspace, defining allowed or blocked IP ranges.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct OrganizationIpRestriction {
@@ -6668,10 +7842,11 @@ impl GraphQLFields for OrganizationIpRestriction {
         "range type description enabled".into()
     }
 }
+/// `INTERNAL` Workspace metadata including region and allowed authentication providers.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct OrganizationMeta {
-    /// The region the organization is hosted in.
+    /// The region the workspace is hosted in.
     pub region: Option<String>,
     /// Allowed authentication providers, empty array means all are allowed.
     pub allowed_auth_services: Option<Vec<String>>,
@@ -6682,13 +7857,14 @@ impl GraphQLFields for OrganizationMeta {
         "region allowedAuthServices".into()
     }
 }
+/// Workspace update operation response.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct OrganizationPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    /// The organization that was created or updated.
-    pub organization: Option<Box<Organization>>,
+    /// The workspace that was created or updated.
+    pub organization: Option<Organization>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -6698,6 +7874,7 @@ impl GraphQLFields for OrganizationPayload {
         "lastSyncId success".into()
     }
 }
+/// Workspace trial start response.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct OrganizationStartTrialPayload {
@@ -6728,7 +7905,7 @@ impl GraphQLFields for PageInfo {
         "hasPreviousPage hasNextPage startCursor endCursor".into()
     }
 }
-/// The paid subscription of an organization.
+/// The billing subscription of a workspace. Represents an active paid plan (e.g., Basic, Business, Enterprise) backed by a Stripe subscription. If a workspace has no Subscription record, it is on the free plan. Only one active subscription per workspace is expected.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct PaidSubscription {
@@ -6741,27 +7918,27 @@ pub struct PaidSubscription {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The subscription type.
+    /// The subscription plan type (e.g., basic, business, enterprise). Determines the feature set and pricing tier for the workspace.
     pub r#type: Option<String>,
-    /// The number of seats in the subscription.
+    /// The number of seats (active members) in the subscription. This is the raw count before applying minimum and maximum seat limits.
     pub seats: Option<f64>,
-    /// The minimum number of seats that will be billed in the subscription.
+    /// The minimum number of seats that will be billed in the subscription. The billed seat count will never go below this value even if actual member count is lower. Null if no minimum is enforced.
     pub seats_minimum: Option<f64>,
-    /// The maximum number of seats that will be billed in the subscription.
+    /// The maximum number of seats that will be billed in the subscription. The billed seat count will never exceed this value even if actual member count is higher. Null if no maximum is enforced.
     pub seats_maximum: Option<f64>,
-    /// The creator of the subscription.
+    /// The user who initially created (purchased) the subscription. Null if the creator has been removed from the workspace.
     pub creator: Option<Box<User>>,
-    /// The organization that the subscription is associated with.
+    /// The workspace that the subscription is associated with.
     pub organization: Option<Box<Organization>>,
-    /// The collection method for this subscription, either automatically charged or invoiced.
+    /// The billing collection method for this subscription. 'automatic' means the payment method on file is charged automatically. 'send_invoice' means invoices are sent to the billing email for manual payment.
     pub collection_method: Option<String>,
-    /// The date the subscription was canceled, if any.
+    /// The date the subscription was canceled. Null if the subscription has not been canceled.
     pub canceled_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The date the subscription is scheduled to be canceled, if any.
+    /// The date the subscription is scheduled to be canceled in the future. Null if no cancellation is scheduled. The subscription remains active until this date.
     pub cancel_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The subscription type of a pending change. Null if no change pending.
+    /// The subscription plan type that the workspace is scheduled to change to at the next billing cycle. Null if no plan change is pending.
     pub pending_change_type: Option<String>,
-    /// The date the subscription will be billed next.
+    /// The date the subscription will be billed next. Null if the subscription is canceled or has no upcoming billing date.
     pub next_billing_at: Option<chrono::DateTime<chrono::Utc>>,
 }
 impl GraphQLFields for PaidSubscription {
@@ -6774,7 +7951,9 @@ impl GraphQLFields for PaidSubscription {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct PasskeyLoginStartResponse {
+    /// Whether the operation was successful.
     pub success: Option<bool>,
+    /// The passkey authentication options to pass to the WebAuthn API.
     pub options: Option<serde_json::Value>,
 }
 impl GraphQLFields for PasskeyLoginStartResponse {
@@ -6783,7 +7962,7 @@ impl GraphQLFields for PasskeyLoginStartResponse {
         "success options".into()
     }
 }
-/// `Internal` A generic post.
+/// `Internal` A post or announcement in a team or user feed. Posts can be manually authored by users or AI-generated summaries of team activity. They support rich text content (ProseMirror), emoji reactions, threaded comments, and audio summaries. Posts are associated with either a team or a user, but not both.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Post {
@@ -6796,53 +7975,45 @@ pub struct Post {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The update content in markdown format.
+    /// The post content in markdown format.
     pub body: Option<String>,
-    /// `Internal` The content of the post as a Prosemirror document.
+    /// `Internal` The content of the post as a ProseMirror document. This is the canonical rich-text representation of the post body.
     pub body_data: Option<String>,
-    /// `Internal` The written update data used to compose the written post.
+    /// `Internal` The structured data used to compose an AI-generated written summary post, including section content and source references.
     pub written_summary_data: Option<serde_json::Value>,
-    /// The update content summarized for audio consumption.
+    /// The post content summarized for audio text-to-speech consumption. Null if no audio summary has been generated.
     pub audio_summary: Option<String>,
-    /// The post's title.
+    /// The post's title. Null or empty for posts that do not have a title.
     pub title: Option<String>,
-    /// The post's unique URL slug.
+    /// The post's unique URL slug, used to construct human-readable URLs.
     pub slug_id: Option<String>,
-    /// The user who wrote the post.
+    /// The user who created the post. Null for system-generated posts.
     pub creator: Option<Box<User>>,
-    /// The time the post was edited.
+    /// The time the post was last edited. Null if the post has not been edited since creation.
     pub edited_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Emoji reaction summary, grouped by emoji type.
+    /// Emoji reaction summary for this post, grouped by emoji type. Each entry contains the emoji name, count, and the IDs of users who reacted.
     pub reaction_data: Option<serde_json::Value>,
-    /// A URL of the TTL (text-to-language) for the body.
+    /// A URL of the text-to-speech audio rendering of the post body. Null if no audio has been generated.
     pub ttl_url: Option<String>,
-    /// The user that the post is associated with.
+    /// The user that the post is scoped to, for user-level feed posts. Null for team-scoped posts.
     pub user: Option<Box<User>>,
-    /// The team that the post is associated with.
+    /// The team that the post is scoped to, for team-level feed posts. Null for user-scoped posts.
     pub team: Option<Box<Team>>,
-    /// The type of the post.
+    /// The type of the post, such as 'summary' for AI-generated feed summaries. Null for standard user-authored posts.
     pub r#type: Option<PostType>,
-    /// The log id of the ai response.
+    /// The evaluation log ID of the AI response that generated this post. Null for non-AI-generated posts.
     pub eval_log_id: Option<String>,
-    /// Schedule used to create a post summary.
+    /// The feed summary schedule cadence that was active when this post was created. Null for non-summary posts.
     pub feed_summary_schedule_at_create: Option<FeedSummarySchedule>,
-    /// Reactions associated with the post.
-    pub reactions: Option<Box<Vec<Reaction>>>,
-    /// Comments associated with the post.
-    pub comments: Option<Box<CommentConnection>>,
-    /// A URL to the generated audio for the Post.
-    pub audio_summary_url: Option<String>,
-    /// Number of comments associated with the post.
-    pub comment_count: Option<i64>,
 }
 impl GraphQLFields for Post {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt body bodyData writtenSummaryData audioSummary title slugId editedAt reactionData ttlUrl type evalLogId feedSummaryScheduleAtCreate audioSummaryUrl commentCount"
+        "id createdAt updatedAt archivedAt body bodyData writtenSummaryData audioSummary title slugId editedAt reactionData ttlUrl type evalLogId feedSummaryScheduleAtCreate"
             .into()
     }
 }
-/// A post related notification.
+/// A notification related to a post, such as new comments or reactions.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct PostNotification {
@@ -6861,22 +8032,21 @@ pub struct PostNotification {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Notification type.
+    /// Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated.
     pub r#type: Option<String>,
-    /// The user that caused the notification.
-    pub actor: Option<Box<User>>,
-    /// The external user that caused the notification.
-    pub external_user_actor: Option<Box<ExternalUser>>,
-    /// The user that received the notification.
-    pub user: Option<Box<User>>,
-    /// The time at when the user marked the notification as read. Null, if the the user hasn't read the notification
+    /// The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event.
+    pub actor: Option<User>,
+    /// The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member.
+    pub external_user_actor: Option<ExternalUser>,
+    /// The recipient user of this notification.
+    pub user: Option<User>,
+    /// The time at which the user marked the notification as read. Null if the notification is unread.
     pub read_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at when an email reminder for this notification was sent to the user. Null, if no email
-    /// reminder has been sent.
+    /// The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent.
     pub emailed_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time until a notification will be snoozed. After that it will appear in the inbox again.
+    /// The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed.
     pub snoozed_until_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which a notification was unsnoozed..
+    /// The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed.
     pub unsnoozed_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The category of the notification.
     pub category: Option<NotificationCategory>,
@@ -6907,7 +8077,7 @@ pub struct PostNotification {
     /// `Internal` Priority of the notification with the same grouping key. Higher number means higher priority. If priority is the same, notifications should be sorted by `createdAt`.
     pub grouping_priority: Option<f64>,
     /// The bot that caused the notification.
-    pub bot_actor: Option<Box<ActorBot>>,
+    pub bot_actor: Option<ActorBot>,
     /// Related post ID.
     pub post_id: Option<String>,
 }
@@ -6918,7 +8088,7 @@ impl GraphQLFields for PostNotification {
             .into()
     }
 }
-/// A project.
+/// A project is a collection of issues working toward a shared goal. Projects have start and target dates, milestones, status tracking, and progress metrics. They can span multiple teams and be grouped under initiatives.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Project {
@@ -6941,73 +8111,73 @@ pub struct Project {
     pub update_reminders_day: Option<Day>,
     /// The hour at which to prompt for updates.
     pub update_reminders_hour: Option<f64>,
-    /// The project's name.
+    /// The name of the project.
     pub name: Option<String>,
-    /// The project's description.
+    /// The short description of the project.
     pub description: Option<String>,
-    /// The project's unique URL slug.
+    /// The project's unique URL slug, used to construct human-readable URLs.
     pub slug_id: Option<String>,
-    /// The icon of the project.
+    /// The icon of the project. Can be an emoji or a decorative icon type.
     pub icon: Option<String>,
-    /// The project's color.
+    /// The project's color as a HEX string. Used in the UI to visually identify the project.
     pub color: Option<String>,
-    /// The status that the project is associated with.
-    pub status: Option<Box<ProjectStatus>>,
+    /// The current project status. Defines the project's position in its lifecycle (e.g., backlog, planned, started, paused, completed, canceled).
+    pub status: Option<ProjectStatus>,
     /// The user who created the project.
     pub creator: Option<Box<User>>,
-    /// The project lead.
+    /// The user who leads the project. The project lead is typically responsible for posting status updates and driving the project to completion. Null if no lead is assigned.
     pub lead: Option<Box<User>>,
-    /// `Internal` Facets associated with the project.
-    pub facets: Option<Box<Vec<Facet>>>,
-    /// The time until which project update reminders are paused.
+    /// `Internal` Facets associated with the project, used for filtering and categorization.
+    pub facets: Option<Vec<Facet>>,
+    /// The time until which project update reminders are paused. When set, no update reminders will be sent for this project until this date passes. Null means reminders are active.
     pub project_update_reminders_paused_until_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The estimated start date of the project.
+    /// The estimated start date of the project. Null if no start date is set.
     pub start_date: Option<chrono::NaiveDate>,
-    /// The resolution of the project's start date.
+    /// The resolution of the project's start date, indicating whether it refers to a specific month, quarter, half-year, or year.
     pub start_date_resolution: Option<DateResolutionType>,
-    /// The estimated completion date of the project.
+    /// The estimated completion date of the project. Null if no target date is set.
     pub target_date: Option<chrono::NaiveDate>,
-    /// The resolution of the project's estimated completion date.
+    /// The resolution of the project's estimated completion date, indicating whether it refers to a specific month, quarter, half-year, or year.
     pub target_date_resolution: Option<DateResolutionType>,
-    /// The time at which the project was moved into started state.
+    /// The time at which the project was moved into a started status. Null if the project has not been started.
     pub started_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the project was moved into completed state.
+    /// The time at which the project was moved into a completed status. Null if the project has not been completed.
     pub completed_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the project was moved into canceled state.
+    /// The time at which the project was moved into a canceled status. Null if the project has not been canceled.
     pub canceled_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the project was automatically archived by the auto pruning process.
+    /// The time at which the project was automatically archived by the auto-pruning process. Null if the project has not been auto-archived.
     pub auto_archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// A flag that indicates whether the project is in the trash bin.
     pub trashed: Option<bool>,
-    /// The sort order for the project within the organization.
+    /// The sort order for the project within the workspace. Used for manual ordering in list views.
     pub sort_order: Option<f64>,
-    /// The sort order for the project within the organization, when ordered by priority.
+    /// The sort order for the project within the workspace when ordered by priority.
     pub priority_sort_order: Option<f64>,
-    /// The project was created based on this issue.
+    /// The issue that was converted into this project. Null if the project was not created from an issue.
     pub converted_from_issue: Option<Box<Issue>>,
     /// The last template that was applied to this project.
     pub last_applied_template: Option<Box<Template>>,
-    /// The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.
+    /// The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low.
     pub priority: Option<i64>,
-    /// The last project update posted for this project.
+    /// The most recent status update posted for this project. Null if no updates have been posted.
     pub last_update: Option<Box<ProjectUpdate>>,
-    /// The health of the project.
+    /// The overall health of the project, derived from the most recent project update. Possible values are onTrack, atRisk, or offTrack. Null if no health has been reported.
     pub health: Option<ProjectUpdateHealthType>,
-    /// The time at which the project health was updated.
+    /// The time at which the project health was last updated, typically when a new project update is posted. Null if health has never been set.
     pub health_updated_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The total number of issues in the project after each week.
+    /// The total number of issues in the project at the end of each week since project creation. Each entry represents one week.
     pub issue_count_history: Option<Vec<f64>>,
-    /// The number of completed issues in the project after each week.
+    /// The number of completed issues in the project at the end of each week since project creation. Each entry represents one week.
     pub completed_issue_count_history: Option<Vec<f64>>,
-    /// The total number of estimation points after each week.
+    /// The total scope (estimation points) of the project at the end of each week since project creation. Each entry represents one week.
     pub scope_history: Option<Vec<f64>>,
-    /// The number of completed estimation points after each week.
+    /// The number of completed estimation points at the end of each week since project creation. Each entry represents one week.
     pub completed_scope_history: Option<Vec<f64>>,
-    /// The number of in progress estimation points after each week.
+    /// The number of in-progress estimation points at the end of each week since project creation. Each entry represents one week.
     pub in_progress_scope_history: Option<Vec<f64>>,
-    /// `INTERNAL` The progress history of the project.
+    /// `INTERNAL` The progress history of the project, tracking issue completion over time.
     pub progress_history: Option<serde_json::Value>,
-    /// `INTERNAL` The current progress of the project.
+    /// `INTERNAL` The current progress of the project, broken down by issue status category.
     pub current_progress: Option<serde_json::Value>,
     /// Whether to send new issue notifications to Slack.
     pub slack_new_issue: Option<bool>,
@@ -7015,36 +8185,36 @@ pub struct Project {
     pub slack_issue_comments: Option<bool>,
     /// Whether to send new issue status updates to Slack.
     pub slack_issue_statuses: Option<bool>,
-    /// Id of the labels associated with this project.
+    /// The IDs of the project labels associated with this project.
     pub label_ids: Option<Vec<String>>,
     /// The user's favorite associated with this project.
     pub favorite: Option<Box<Favorite>>,
     /// Project URL.
     pub url: Option<String>,
     /// Initiatives that this project belongs to.
-    pub initiatives: Option<Box<InitiativeConnection>>,
+    pub initiatives: Option<InitiativeConnection>,
     /// Associations of this project to parent initiatives.
-    pub initiative_to_projects: Option<Box<InitiativeToProjectConnection>>,
+    pub initiative_to_projects: Option<InitiativeToProjectConnection>,
     /// Teams associated with this project.
-    pub teams: Option<Box<TeamConnection>>,
+    pub teams: Option<TeamConnection>,
     /// Users that are members of the project.
-    pub members: Option<Box<UserConnection>>,
+    pub members: Option<UserConnection>,
     /// Project updates associated with the project.
-    pub project_updates: Option<Box<ProjectUpdateConnection>>,
+    pub project_updates: Option<ProjectUpdateConnection>,
     /// Documents associated with the project.
-    pub documents: Option<Box<DocumentConnection>>,
+    pub documents: Option<DocumentConnection>,
     /// Milestones associated with the project.
-    pub project_milestones: Option<Box<ProjectMilestoneConnection>>,
+    pub project_milestones: Option<ProjectMilestoneConnection>,
     /// Issues associated with the project.
-    pub issues: Option<Box<IssueConnection>>,
+    pub issues: Option<IssueConnection>,
     /// External links associated with the project.
-    pub external_links: Option<Box<EntityExternalLinkConnection>>,
+    pub external_links: Option<EntityExternalLinkConnection>,
     /// Attachments associated with the project.
-    pub attachments: Option<Box<ProjectAttachmentConnection>>,
+    pub attachments: Option<ProjectAttachmentConnection>,
     /// History entries associated with the project.
-    pub history: Option<Box<ProjectHistoryConnection>>,
+    pub history: Option<ProjectHistoryConnection>,
     /// Labels associated with this project.
-    pub labels: Option<Box<ProjectLabelConnection>>,
+    pub labels: Option<ProjectLabelConnection>,
     /// The overall progress of the project. This is the (completed estimate points + 0.25 * in progress estimate points) / total estimate points.
     pub progress: Option<f64>,
     /// The overall scope (total estimate points) of the project.
@@ -7058,17 +8228,19 @@ pub struct Project {
     /// The content of the project description.
     pub document_content: Option<Box<DocumentContent>>,
     /// Comments associated with the project overview.
-    pub comments: Option<Box<CommentConnection>>,
+    pub comments: Option<CommentConnection>,
     /// Relations associated with this project.
-    pub relations: Option<Box<ProjectRelationConnection>>,
+    pub relations: Option<ProjectRelationConnection>,
     /// Inverse relations associated with this project.
-    pub inverse_relations: Option<Box<ProjectRelationConnection>>,
+    pub inverse_relations: Option<ProjectRelationConnection>,
     /// Customer needs associated with the project.
-    pub needs: Option<Box<CustomerNeedConnection>>,
+    pub needs: Option<CustomerNeedConnection>,
     /// `DEPRECATED` The type of the state.
     pub state: Option<String>,
     /// The priority of the project as a label.
     pub priority_label: Option<String>,
+    /// The external services the project is synced with.
+    pub synced_with: Option<Vec<ExternalEntityInfo>>,
 }
 impl GraphQLFields for Project {
     type FullType = Self;
@@ -7086,7 +8258,7 @@ pub struct ProjectArchivePayload {
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The archived/unarchived entity. Null if entity was deleted.
-    pub entity: Option<Box<Project>>,
+    pub entity: Option<Project>,
 }
 impl GraphQLFields for ProjectArchivePayload {
     type FullType = Self;
@@ -7094,7 +8266,7 @@ impl GraphQLFields for ProjectArchivePayload {
         "lastSyncId success".into()
     }
 }
-/// Project attachment
+/// An attachment (link, reference, or integration data) associated with a project. Attachments are typically created by integrations and contain metadata for rendering in the client.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectAttachment {
@@ -7109,36 +8281,31 @@ pub struct ProjectAttachment {
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// Title of the attachment.
     pub title: Option<String>,
-    /// Optional subtitle of the attachment
+    /// Optional subtitle of the attachment, providing additional context below the title.
     pub subtitle: Option<String>,
     /// URL of the attachment.
     pub url: Option<String>,
     /// The creator of the attachment.
-    pub creator: Option<Box<User>>,
-    /// Custom metadata related to the attachment.
+    pub creator: Option<User>,
+    /// Custom metadata related to the attachment. Contains user-facing content such as conversation messages or rendered attributes from integrations.
     pub metadata: Option<serde_json::Value>,
-    /// Information about the external source which created the attachment.
+    /// Metadata about the external source which created the attachment, including foreign identifiers used for syncing with external services. Null if the attachment was not created by an integration.
     pub source: Option<serde_json::Value>,
-    /// An accessor helper to source.type, defines the source type of the attachment.
+    /// The source type of the attachment, derived from the source metadata. Returns the integration type that created the attachment (e.g., 'slack', 'github'), or null if not set.
     pub source_type: Option<String>,
-    /// The project this attachment belongs to.
-    pub project: Option<Box<Project>>,
-    /// The body data of the attachment, if any.
-    pub body_data: Option<String>,
 }
 impl GraphQLFields for ProjectAttachment {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt title subtitle url metadata source sourceType bodyData"
-            .into()
+        "id createdAt updatedAt archivedAt title subtitle url metadata source sourceType".into()
     }
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectAttachmentConnection {
-    pub edges: Option<Box<Vec<ProjectAttachmentEdge>>>,
-    pub nodes: Option<Box<Vec<ProjectAttachment>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<ProjectAttachmentEdge>>,
+    pub nodes: Option<Vec<ProjectAttachment>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for ProjectAttachmentConnection {
     type FullType = Self;
@@ -7149,7 +8316,7 @@ impl GraphQLFields for ProjectAttachmentConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectAttachmentEdge {
-    pub node: Option<Box<ProjectAttachment>>,
+    pub node: Option<ProjectAttachment>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -7162,9 +8329,9 @@ impl GraphQLFields for ProjectAttachmentEdge {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectConnection {
-    pub edges: Option<Box<Vec<ProjectEdge>>>,
-    pub nodes: Option<Box<Vec<Project>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<ProjectEdge>>,
+    pub nodes: Option<Vec<Project>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for ProjectConnection {
     type FullType = Self;
@@ -7175,7 +8342,7 @@ impl GraphQLFields for ProjectConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectEdge {
-    pub node: Option<Box<Project>>,
+    pub node: Option<Project>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -7185,6 +8352,7 @@ impl GraphQLFields for ProjectEdge {
         "cursor".into()
     }
 }
+/// The result of a project filter suggestion query.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectFilterSuggestionPayload {
@@ -7199,7 +8367,7 @@ impl GraphQLFields for ProjectFilterSuggestionPayload {
         "filter logId".into()
     }
 }
-/// An history associated with a project.
+/// A history record associated with a project. Tracks changes to project properties, status, members, teams, milestones, labels, and relationships over time.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectHistory {
@@ -7214,8 +8382,8 @@ pub struct ProjectHistory {
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The events that happened while recording that history.
     pub entries: Option<serde_json::Value>,
-    /// The project that the history is associated with.
-    pub project: Option<Box<Project>>,
+    /// The project that this history record belongs to.
+    pub project: Option<Project>,
 }
 impl GraphQLFields for ProjectHistory {
     type FullType = Self;
@@ -7226,9 +8394,9 @@ impl GraphQLFields for ProjectHistory {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectHistoryConnection {
-    pub edges: Option<Box<Vec<ProjectHistoryEdge>>>,
-    pub nodes: Option<Box<Vec<ProjectHistory>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<ProjectHistoryEdge>>,
+    pub nodes: Option<Vec<ProjectHistory>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for ProjectHistoryConnection {
     type FullType = Self;
@@ -7239,7 +8407,7 @@ impl GraphQLFields for ProjectHistoryConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectHistoryEdge {
-    pub node: Option<Box<ProjectHistory>>,
+    pub node: Option<ProjectHistory>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -7249,7 +8417,7 @@ impl GraphQLFields for ProjectHistoryEdge {
         "cursor".into()
     }
 }
-/// Labels that can be associated with projects.
+/// A label that can be applied to projects for categorization. Project labels are workspace-level and can be organized into groups with a parent-child hierarchy. Only child labels (not group labels) can be directly applied to projects.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectLabel {
@@ -7266,25 +8434,26 @@ pub struct ProjectLabel {
     pub name: Option<String>,
     /// The label's description.
     pub description: Option<String>,
-    /// The label's color as a HEX string.
+    /// The label's color as a HEX string (e.g., '#EB5757'). Used for visual identification of the label in the UI.
     pub color: Option<String>,
-    /// Whether the label is a group.
+    /// Whether the label is a group. When true, this label acts as a container for child labels and cannot be directly applied to issues or projects. When false, the label can be directly applied.
     pub is_group: Option<bool>,
-    /// The date when the label was last applied to an issue or project.
+    /// The date when the label was last applied to an issue or project. Null if the label has never been applied.
     pub last_applied_at: Option<chrono::DateTime<chrono::Utc>>,
     /// `Internal` When the label was retired.
     pub retired_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The workspace that the project label belongs to.
     pub organization: Option<Box<Organization>>,
     /// The user who created the label.
     pub creator: Option<Box<User>>,
-    /// The user who retired the label.
+    /// The user who retired the label. Retired labels cannot be applied to new projects but remain on existing ones. Null if the label is active.
     pub retired_by: Option<Box<User>>,
-    /// The parent label.
+    /// The parent label group. If set, this label is a child within a group. Only one child label from each group can be applied to a project at a time.
     pub parent: Option<Box<ProjectLabel>>,
     /// Projects associated with the label.
-    pub projects: Option<Box<ProjectConnection>>,
+    pub projects: Option<ProjectConnection>,
     /// Children of the label.
-    pub children: Option<Box<ProjectLabelConnection>>,
+    pub children: Option<ProjectLabelConnection>,
 }
 impl GraphQLFields for ProjectLabel {
     type FullType = Self;
@@ -7296,9 +8465,9 @@ impl GraphQLFields for ProjectLabel {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectLabelConnection {
-    pub edges: Option<Box<Vec<ProjectLabelEdge>>>,
-    pub nodes: Option<Box<Vec<ProjectLabel>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<ProjectLabelEdge>>,
+    pub nodes: Option<Vec<ProjectLabel>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for ProjectLabelConnection {
     type FullType = Self;
@@ -7309,7 +8478,7 @@ impl GraphQLFields for ProjectLabelConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectLabelEdge {
-    pub node: Option<Box<ProjectLabel>>,
+    pub node: Option<ProjectLabel>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -7319,13 +8488,14 @@ impl GraphQLFields for ProjectLabelEdge {
         "cursor".into()
     }
 }
+/// The result of a project label mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectLabelPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The label that was created or updated.
-    pub project_label: Option<Box<ProjectLabel>>,
+    pub project_label: Option<ProjectLabel>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -7335,7 +8505,7 @@ impl GraphQLFields for ProjectLabelPayload {
         "lastSyncId success".into()
     }
 }
-/// A milestone for a project.
+/// A milestone within a project. Milestones break a project into phases or target checkpoints, each with its own target date and set of issues. Issues can be assigned to a milestone to track progress toward that checkpoint.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectMilestone {
@@ -7350,15 +8520,15 @@ pub struct ProjectMilestone {
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The name of the project milestone.
     pub name: Option<String>,
-    /// The content of the project milestone description.
+    /// The rich-text content of the milestone description. Null if no description has been set.
     pub document_content: Option<Box<DocumentContent>>,
-    /// The planned completion date of the milestone.
+    /// The planned completion date of the milestone. Null if no target date is set.
     pub target_date: Option<chrono::NaiveDate>,
-    /// The project of the milestone.
+    /// The project that this milestone belongs to.
     pub project: Option<Box<Project>>,
-    /// `Internal` The progress history of the project milestone.
+    /// `Internal` The progress history of the milestone, tracking issue completion over time.
     pub progress_history: Option<serde_json::Value>,
-    /// `Internal` The current progress of the project milestone.
+    /// `Internal` The current progress of the milestone, broken down by issue status category.
     pub current_progress: Option<serde_json::Value>,
     /// The order of the milestone in relation to other milestones within a project.
     pub sort_order: Option<f64>,
@@ -7371,7 +8541,7 @@ pub struct ProjectMilestone {
     /// `Internal` The project milestone's description as YJS state.
     pub description_state: Option<String>,
     /// Issues associated with the project milestone.
-    pub issues: Option<Box<IssueConnection>>,
+    pub issues: Option<IssueConnection>,
 }
 impl GraphQLFields for ProjectMilestone {
     type FullType = Self;
@@ -7383,9 +8553,9 @@ impl GraphQLFields for ProjectMilestone {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectMilestoneConnection {
-    pub edges: Option<Box<Vec<ProjectMilestoneEdge>>>,
-    pub nodes: Option<Box<Vec<ProjectMilestone>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<ProjectMilestoneEdge>>,
+    pub nodes: Option<Vec<ProjectMilestone>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for ProjectMilestoneConnection {
     type FullType = Self;
@@ -7396,7 +8566,7 @@ impl GraphQLFields for ProjectMilestoneConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectMilestoneEdge {
-    pub node: Option<Box<ProjectMilestone>>,
+    pub node: Option<ProjectMilestone>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -7420,19 +8590,20 @@ impl GraphQLFields for ProjectMilestoneMoveIssueToTeam {
         "issueId teamId".into()
     }
 }
+/// `Internal` The result of a project milestone move mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectMilestoneMovePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The project milestone that was created or updated.
-    pub project_milestone: Option<Box<ProjectMilestone>>,
+    pub project_milestone: Option<ProjectMilestone>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// A snapshot of the issues that were moved to new teams, if the user selected to do it, containing an array of mappings between an issue and its previous team. Store on the client to use for undoing a previous milestone move.
-    pub previous_issue_team_ids: Option<Box<Vec<ProjectMilestoneMoveIssueToTeam>>>,
+    pub previous_issue_team_ids: Option<Vec<ProjectMilestoneMoveIssueToTeam>>,
     /// A snapshot of the project that had new teams added to it, if the user selected to do it, containing an array of mappings between a project and its previous teams. Store on the client to use for undoing a previous milestone move.
-    pub previous_project_team_ids: Option<Box<ProjectMilestoneMoveProjectTeams>>,
+    pub previous_project_team_ids: Option<ProjectMilestoneMoveProjectTeams>,
 }
 impl GraphQLFields for ProjectMilestoneMovePayload {
     type FullType = Self;
@@ -7454,13 +8625,14 @@ impl GraphQLFields for ProjectMilestoneMoveProjectTeams {
         "projectId teamIds".into()
     }
 }
+/// The result of a project milestone mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectMilestonePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The project milestone that was created or updated.
-    pub project_milestone: Option<Box<ProjectMilestone>>,
+    pub project_milestone: Option<ProjectMilestone>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -7470,7 +8642,7 @@ impl GraphQLFields for ProjectMilestonePayload {
         "lastSyncId success".into()
     }
 }
-/// A project related notification.
+/// A notification related to a project, such as being added as a member or lead, project updates, comments, or mentions on the project or its milestones.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectNotification {
@@ -7489,22 +8661,21 @@ pub struct ProjectNotification {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Notification type.
+    /// Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated.
     pub r#type: Option<String>,
-    /// The user that caused the notification.
-    pub actor: Option<Box<User>>,
-    /// The external user that caused the notification.
-    pub external_user_actor: Option<Box<ExternalUser>>,
-    /// The user that received the notification.
-    pub user: Option<Box<User>>,
-    /// The time at when the user marked the notification as read. Null, if the the user hasn't read the notification
+    /// The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event.
+    pub actor: Option<User>,
+    /// The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member.
+    pub external_user_actor: Option<ExternalUser>,
+    /// The recipient user of this notification.
+    pub user: Option<User>,
+    /// The time at which the user marked the notification as read. Null if the notification is unread.
     pub read_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at when an email reminder for this notification was sent to the user. Null, if no email
-    /// reminder has been sent.
+    /// The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent.
     pub emailed_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time until a notification will be snoozed. After that it will appear in the inbox again.
+    /// The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed.
     pub snoozed_until_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which a notification was unsnoozed..
+    /// The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed.
     pub unsnoozed_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The category of the notification.
     pub category: Option<NotificationCategory>,
@@ -7535,7 +8706,7 @@ pub struct ProjectNotification {
     /// `Internal` Priority of the notification with the same grouping key. Higher number means higher priority. If priority is the same, notifications should be sorted by `createdAt`.
     pub grouping_priority: Option<f64>,
     /// The bot that caused the notification.
-    pub bot_actor: Option<Box<ActorBot>>,
+    pub bot_actor: Option<ActorBot>,
     /// Related project ID.
     pub project_id: Option<String>,
     /// Related project milestone ID.
@@ -7543,15 +8714,15 @@ pub struct ProjectNotification {
     /// Related project update ID.
     pub project_update_id: Option<String>,
     /// The project related to the notification.
-    pub project: Option<Box<Project>>,
+    pub project: Option<Project>,
     /// The document related to the notification.
-    pub document: Option<Box<Document>>,
+    pub document: Option<Document>,
     /// The project update related to the notification.
-    pub project_update: Option<Box<ProjectUpdate>>,
+    pub project_update: Option<ProjectUpdate>,
     /// The comment related to the notification.
-    pub comment: Option<Box<Comment>>,
+    pub comment: Option<Comment>,
     /// The parent comment related to the notification, if a notification is a reply comment notification.
-    pub parent_comment: Option<Box<Comment>>,
+    pub parent_comment: Option<Comment>,
 }
 impl GraphQLFields for ProjectNotification {
     type FullType = Self;
@@ -7560,7 +8731,7 @@ impl GraphQLFields for ProjectNotification {
             .into()
     }
 }
-/// A project notification subscription.
+/// A notification subscription scoped to a specific project. The subscriber receives notifications for events related to this project, such as updates, comments, and membership changes.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectNotificationSubscription {
@@ -7573,31 +8744,31 @@ pub struct ProjectNotificationSubscription {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The user that subscribed to receive notifications.
-    pub subscriber: Option<Box<User>>,
-    /// The customer associated with the notification subscription.
-    pub customer: Option<Box<Customer>>,
-    /// The contextual custom view associated with the notification subscription.
-    pub custom_view: Option<Box<CustomView>>,
-    /// The contextual cycle view associated with the notification subscription.
-    pub cycle: Option<Box<Cycle>>,
-    /// The contextual label view associated with the notification subscription.
-    pub label: Option<Box<IssueLabel>>,
+    /// The user who will receive notifications from this subscription.
+    pub subscriber: Option<User>,
+    /// The customer that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub customer: Option<Customer>,
+    /// The custom view that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub custom_view: Option<CustomView>,
+    /// The cycle that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub cycle: Option<Cycle>,
+    /// The issue label that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub label: Option<IssueLabel>,
     /// The project subscribed to.
-    pub project: Option<Box<Project>>,
-    /// The contextual initiative view associated with the notification subscription.
-    pub initiative: Option<Box<Initiative>>,
-    /// The team associated with the notification subscription.
-    pub team: Option<Box<Team>>,
-    /// The user view associated with the notification subscription.
-    pub user: Option<Box<User>>,
-    /// The type of view to which the notification subscription context is associated with.
+    pub project: Option<Project>,
+    /// The initiative that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub initiative: Option<Initiative>,
+    /// The team that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub team: Option<Team>,
+    /// The user that this notification subscription is scoped to, for user-specific view subscriptions. Null if the subscription targets a different entity type.
+    pub user: Option<User>,
+    /// The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type.
     pub context_view_type: Option<ContextViewType>,
-    /// The type of user view to which the notification subscription context is associated with.
+    /// The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type.
     pub user_context_view_type: Option<UserContextViewType>,
-    /// Whether the subscription is active or not.
+    /// Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists.
     pub active: Option<bool>,
-    /// The type of subscription.
+    /// The notification event types that this subscription will deliver to the subscriber.
     pub notification_subscription_types: Option<Vec<String>>,
 }
 impl GraphQLFields for ProjectNotificationSubscription {
@@ -7607,13 +8778,14 @@ impl GraphQLFields for ProjectNotificationSubscription {
             .into()
     }
 }
+/// The result of a project mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The project that was created or updated.
-    pub project: Option<Box<Project>>,
+    pub project: Option<Project>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -7623,7 +8795,7 @@ impl GraphQLFields for ProjectPayload {
         "lastSyncId success".into()
     }
 }
-/// A relation between two projects.
+/// A dependency relation between two projects. Relations can optionally be anchored to specific milestones within each project, allowing fine-grained dependency tracking.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectRelation {
@@ -7636,22 +8808,22 @@ pub struct ProjectRelation {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The relationship of the project with the related project.
+    /// The type of dependency relationship from the project to the related project (e.g., blocks).
     pub r#type: Option<String>,
-    /// The project whose relationship is being described.
-    pub project: Option<Box<Project>>,
-    /// The milestone within the project whose relationship is being described.
-    pub project_milestone: Option<Box<ProjectMilestone>>,
-    /// The type of anchor on the project end of the relation.
+    /// The source project in the dependency relation.
+    pub project: Option<Project>,
+    /// The specific milestone within the source project that the relation is anchored to. Null if the relation applies to the project as a whole.
+    pub project_milestone: Option<ProjectMilestone>,
+    /// The type of anchor on the source project end of the relation, indicating whether it is anchored to the project itself or a specific milestone.
     pub anchor_type: Option<String>,
-    /// The related project.
-    pub related_project: Option<Box<Project>>,
-    /// The milestone within the related project whose relationship is being described.
-    pub related_project_milestone: Option<Box<ProjectMilestone>>,
-    /// The type of anchor on the relatedProject end of the relation.
+    /// The target project in the dependency relation.
+    pub related_project: Option<Project>,
+    /// The specific milestone within the target project that the relation is anchored to. Null if the relation applies to the target project as a whole.
+    pub related_project_milestone: Option<ProjectMilestone>,
+    /// The type of anchor on the target project end of the relation, indicating whether it is anchored to the project itself or a specific milestone.
     pub related_anchor_type: Option<String>,
-    /// The last user who created or modified the relation.
-    pub user: Option<Box<User>>,
+    /// The user who last created or modified the relation. Null if the user has been deleted.
+    pub user: Option<User>,
 }
 impl GraphQLFields for ProjectRelation {
     type FullType = Self;
@@ -7662,9 +8834,9 @@ impl GraphQLFields for ProjectRelation {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectRelationConnection {
-    pub edges: Option<Box<Vec<ProjectRelationEdge>>>,
-    pub nodes: Option<Box<Vec<ProjectRelation>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<ProjectRelationEdge>>,
+    pub nodes: Option<Vec<ProjectRelation>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for ProjectRelationConnection {
     type FullType = Self;
@@ -7675,7 +8847,7 @@ impl GraphQLFields for ProjectRelationConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectRelationEdge {
-    pub node: Option<Box<ProjectRelation>>,
+    pub node: Option<ProjectRelation>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -7685,13 +8857,14 @@ impl GraphQLFields for ProjectRelationEdge {
         "cursor".into()
     }
 }
+/// The result of a project relation mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectRelationPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The project relation that was created or updated.
-    pub project_relation: Option<Box<ProjectRelation>>,
+    pub project_relation: Option<ProjectRelation>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -7704,12 +8877,12 @@ impl GraphQLFields for ProjectRelationPayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectSearchPayload {
-    pub edges: Option<Box<Vec<ProjectSearchResultEdge>>>,
-    pub nodes: Option<Box<Vec<ProjectSearchResult>>>,
-    pub page_info: Option<Box<PageInfo>>,
-    /// Archived entities matching the search term along with all their dependencies.
-    pub archive_payload: Option<Box<ArchiveResponse>>,
-    /// Total number of results for query without filters applied.
+    pub edges: Option<Vec<ProjectSearchResultEdge>>,
+    pub nodes: Option<Vec<ProjectSearchResult>>,
+    pub page_info: Option<PageInfo>,
+    /// Archived entities matching the search term along with all their dependencies, serialized for the client sync engine.
+    pub archive_payload: Option<ArchiveResponse>,
+    /// Total number of matching results before pagination is applied.
     pub total_count: Option<f64>,
 }
 impl GraphQLFields for ProjectSearchPayload {
@@ -7740,73 +8913,73 @@ pub struct ProjectSearchResult {
     pub update_reminders_day: Option<Day>,
     /// The hour at which to prompt for updates.
     pub update_reminders_hour: Option<f64>,
-    /// The project's name.
+    /// The name of the project.
     pub name: Option<String>,
-    /// The project's description.
+    /// The short description of the project.
     pub description: Option<String>,
-    /// The project's unique URL slug.
+    /// The project's unique URL slug, used to construct human-readable URLs.
     pub slug_id: Option<String>,
-    /// The icon of the project.
+    /// The icon of the project. Can be an emoji or a decorative icon type.
     pub icon: Option<String>,
-    /// The project's color.
+    /// The project's color as a HEX string. Used in the UI to visually identify the project.
     pub color: Option<String>,
-    /// The status that the project is associated with.
-    pub status: Option<Box<ProjectStatus>>,
+    /// The current project status. Defines the project's position in its lifecycle (e.g., backlog, planned, started, paused, completed, canceled).
+    pub status: Option<ProjectStatus>,
     /// The user who created the project.
-    pub creator: Option<Box<User>>,
-    /// The project lead.
-    pub lead: Option<Box<User>>,
-    /// `Internal` Facets associated with the project.
-    pub facets: Option<Box<Vec<Facet>>>,
-    /// The time until which project update reminders are paused.
+    pub creator: Option<User>,
+    /// The user who leads the project. The project lead is typically responsible for posting status updates and driving the project to completion. Null if no lead is assigned.
+    pub lead: Option<User>,
+    /// `Internal` Facets associated with the project, used for filtering and categorization.
+    pub facets: Option<Vec<Facet>>,
+    /// The time until which project update reminders are paused. When set, no update reminders will be sent for this project until this date passes. Null means reminders are active.
     pub project_update_reminders_paused_until_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The estimated start date of the project.
+    /// The estimated start date of the project. Null if no start date is set.
     pub start_date: Option<chrono::NaiveDate>,
-    /// The resolution of the project's start date.
+    /// The resolution of the project's start date, indicating whether it refers to a specific month, quarter, half-year, or year.
     pub start_date_resolution: Option<DateResolutionType>,
-    /// The estimated completion date of the project.
+    /// The estimated completion date of the project. Null if no target date is set.
     pub target_date: Option<chrono::NaiveDate>,
-    /// The resolution of the project's estimated completion date.
+    /// The resolution of the project's estimated completion date, indicating whether it refers to a specific month, quarter, half-year, or year.
     pub target_date_resolution: Option<DateResolutionType>,
-    /// The time at which the project was moved into started state.
+    /// The time at which the project was moved into a started status. Null if the project has not been started.
     pub started_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the project was moved into completed state.
+    /// The time at which the project was moved into a completed status. Null if the project has not been completed.
     pub completed_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the project was moved into canceled state.
+    /// The time at which the project was moved into a canceled status. Null if the project has not been canceled.
     pub canceled_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the project was automatically archived by the auto pruning process.
+    /// The time at which the project was automatically archived by the auto-pruning process. Null if the project has not been auto-archived.
     pub auto_archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// A flag that indicates whether the project is in the trash bin.
     pub trashed: Option<bool>,
-    /// The sort order for the project within the organization.
+    /// The sort order for the project within the workspace. Used for manual ordering in list views.
     pub sort_order: Option<f64>,
-    /// The sort order for the project within the organization, when ordered by priority.
+    /// The sort order for the project within the workspace when ordered by priority.
     pub priority_sort_order: Option<f64>,
-    /// The project was created based on this issue.
-    pub converted_from_issue: Option<Box<Issue>>,
+    /// The issue that was converted into this project. Null if the project was not created from an issue.
+    pub converted_from_issue: Option<Issue>,
     /// The last template that was applied to this project.
-    pub last_applied_template: Option<Box<Template>>,
-    /// The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.
+    pub last_applied_template: Option<Template>,
+    /// The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low.
     pub priority: Option<i64>,
-    /// The last project update posted for this project.
-    pub last_update: Option<Box<ProjectUpdate>>,
-    /// The health of the project.
+    /// The most recent status update posted for this project. Null if no updates have been posted.
+    pub last_update: Option<ProjectUpdate>,
+    /// The overall health of the project, derived from the most recent project update. Possible values are onTrack, atRisk, or offTrack. Null if no health has been reported.
     pub health: Option<ProjectUpdateHealthType>,
-    /// The time at which the project health was updated.
+    /// The time at which the project health was last updated, typically when a new project update is posted. Null if health has never been set.
     pub health_updated_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The total number of issues in the project after each week.
+    /// The total number of issues in the project at the end of each week since project creation. Each entry represents one week.
     pub issue_count_history: Option<Vec<f64>>,
-    /// The number of completed issues in the project after each week.
+    /// The number of completed issues in the project at the end of each week since project creation. Each entry represents one week.
     pub completed_issue_count_history: Option<Vec<f64>>,
-    /// The total number of estimation points after each week.
+    /// The total scope (estimation points) of the project at the end of each week since project creation. Each entry represents one week.
     pub scope_history: Option<Vec<f64>>,
-    /// The number of completed estimation points after each week.
+    /// The number of completed estimation points at the end of each week since project creation. Each entry represents one week.
     pub completed_scope_history: Option<Vec<f64>>,
-    /// The number of in progress estimation points after each week.
+    /// The number of in-progress estimation points at the end of each week since project creation. Each entry represents one week.
     pub in_progress_scope_history: Option<Vec<f64>>,
-    /// `INTERNAL` The progress history of the project.
+    /// `INTERNAL` The progress history of the project, tracking issue completion over time.
     pub progress_history: Option<serde_json::Value>,
-    /// `INTERNAL` The current progress of the project.
+    /// `INTERNAL` The current progress of the project, broken down by issue status category.
     pub current_progress: Option<serde_json::Value>,
     /// Whether to send new issue notifications to Slack.
     pub slack_new_issue: Option<bool>,
@@ -7814,60 +8987,62 @@ pub struct ProjectSearchResult {
     pub slack_issue_comments: Option<bool>,
     /// Whether to send new issue status updates to Slack.
     pub slack_issue_statuses: Option<bool>,
-    /// Id of the labels associated with this project.
+    /// The IDs of the project labels associated with this project.
     pub label_ids: Option<Vec<String>>,
     /// The user's favorite associated with this project.
-    pub favorite: Option<Box<Favorite>>,
+    pub favorite: Option<Favorite>,
     /// Project URL.
     pub url: Option<String>,
     /// Initiatives that this project belongs to.
-    pub initiatives: Option<Box<InitiativeConnection>>,
+    pub initiatives: Option<InitiativeConnection>,
     /// Associations of this project to parent initiatives.
-    pub initiative_to_projects: Option<Box<InitiativeToProjectConnection>>,
+    pub initiative_to_projects: Option<InitiativeToProjectConnection>,
     /// Teams associated with this project.
-    pub teams: Option<Box<TeamConnection>>,
+    pub teams: Option<TeamConnection>,
     /// Users that are members of the project.
-    pub members: Option<Box<UserConnection>>,
+    pub members: Option<UserConnection>,
     /// Project updates associated with the project.
-    pub project_updates: Option<Box<ProjectUpdateConnection>>,
+    pub project_updates: Option<ProjectUpdateConnection>,
     /// Documents associated with the project.
-    pub documents: Option<Box<DocumentConnection>>,
+    pub documents: Option<DocumentConnection>,
     /// Milestones associated with the project.
-    pub project_milestones: Option<Box<ProjectMilestoneConnection>>,
+    pub project_milestones: Option<ProjectMilestoneConnection>,
     /// Issues associated with the project.
-    pub issues: Option<Box<IssueConnection>>,
+    pub issues: Option<IssueConnection>,
     /// External links associated with the project.
-    pub external_links: Option<Box<EntityExternalLinkConnection>>,
+    pub external_links: Option<EntityExternalLinkConnection>,
     /// Attachments associated with the project.
-    pub attachments: Option<Box<ProjectAttachmentConnection>>,
+    pub attachments: Option<ProjectAttachmentConnection>,
     /// History entries associated with the project.
-    pub history: Option<Box<ProjectHistoryConnection>>,
+    pub history: Option<ProjectHistoryConnection>,
     /// Labels associated with this project.
-    pub labels: Option<Box<ProjectLabelConnection>>,
+    pub labels: Option<ProjectLabelConnection>,
     /// The overall progress of the project. This is the (completed estimate points + 0.25 * in progress estimate points) / total estimate points.
     pub progress: Option<f64>,
     /// The overall scope (total estimate points) of the project.
     pub scope: Option<f64>,
     /// Settings for all integrations associated with that project.
-    pub integrations_settings: Option<Box<IntegrationsSettings>>,
+    pub integrations_settings: Option<IntegrationsSettings>,
     /// The project's content in markdown format.
     pub content: Option<String>,
     /// `Internal` The project's content as YJS state.
     pub content_state: Option<String>,
     /// The content of the project description.
-    pub document_content: Option<Box<DocumentContent>>,
+    pub document_content: Option<DocumentContent>,
     /// Comments associated with the project overview.
-    pub comments: Option<Box<CommentConnection>>,
+    pub comments: Option<CommentConnection>,
     /// Relations associated with this project.
-    pub relations: Option<Box<ProjectRelationConnection>>,
+    pub relations: Option<ProjectRelationConnection>,
     /// Inverse relations associated with this project.
-    pub inverse_relations: Option<Box<ProjectRelationConnection>>,
+    pub inverse_relations: Option<ProjectRelationConnection>,
     /// Customer needs associated with the project.
-    pub needs: Option<Box<CustomerNeedConnection>>,
+    pub needs: Option<CustomerNeedConnection>,
     /// `DEPRECATED` The type of the state.
     pub state: Option<String>,
     /// The priority of the project as a label.
     pub priority_label: Option<String>,
+    /// The external services the project is synced with.
+    pub synced_with: Option<Vec<ExternalEntityInfo>>,
     /// Metadata related to search result.
     pub metadata: Option<serde_json::Value>,
 }
@@ -7881,7 +9056,7 @@ impl GraphQLFields for ProjectSearchResult {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectSearchResultEdge {
-    pub node: Option<Box<ProjectSearchResult>>,
+    pub node: Option<ProjectSearchResult>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -7891,7 +9066,7 @@ impl GraphQLFields for ProjectSearchResultEdge {
         "cursor".into()
     }
 }
-/// A project status.
+/// A custom project status within a workspace. Statuses are grouped by type (backlog, planned, started, paused, completed, canceled) and define the lifecycle stages a project can move through. Each workspace can customize the names and colors of its project statuses.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectStatus {
@@ -7906,15 +9081,15 @@ pub struct ProjectStatus {
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The name of the status.
     pub name: Option<String>,
-    /// The UI color of the status as a HEX string.
+    /// The color of the status as a HEX string, used for display in the UI.
     pub color: Option<String>,
     /// Description of the status.
     pub description: Option<String>,
-    /// The position of the status in the workspace's project flow.
+    /// The position of the status within its type group in the workspace's project flow. Used for ordering statuses of the same type.
     pub position: Option<f64>,
-    /// The type of the project status.
+    /// The category type of the project status (e.g., backlog, planned, started, paused, completed, canceled). Determines the status's behavior and position in the project lifecycle.
     pub r#type: Option<ProjectStatusType>,
-    /// Whether or not a project can be in this status indefinitely.
+    /// Whether a project can remain in this status indefinitely. When false, projects in this status may trigger reminders or auto-archiving after a period of inactivity.
     pub indefinite: Option<bool>,
 }
 impl GraphQLFields for ProjectStatus {
@@ -7932,7 +9107,7 @@ pub struct ProjectStatusArchivePayload {
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The archived/unarchived entity. Null if entity was deleted.
-    pub entity: Option<Box<ProjectStatus>>,
+    pub entity: Option<ProjectStatus>,
 }
 impl GraphQLFields for ProjectStatusArchivePayload {
     type FullType = Self;
@@ -7943,9 +9118,9 @@ impl GraphQLFields for ProjectStatusArchivePayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectStatusConnection {
-    pub edges: Option<Box<Vec<ProjectStatusEdge>>>,
-    pub nodes: Option<Box<Vec<ProjectStatus>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<ProjectStatusEdge>>,
+    pub nodes: Option<Vec<ProjectStatus>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for ProjectStatusConnection {
     type FullType = Self;
@@ -7953,6 +9128,7 @@ impl GraphQLFields for ProjectStatusConnection {
         "".into()
     }
 }
+/// The count of projects using a specific project status.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectStatusCountPayload {
@@ -7972,7 +9148,7 @@ impl GraphQLFields for ProjectStatusCountPayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectStatusEdge {
-    pub node: Option<Box<ProjectStatus>>,
+    pub node: Option<ProjectStatus>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -7982,13 +9158,14 @@ impl GraphQLFields for ProjectStatusEdge {
         "cursor".into()
     }
 }
+/// The result of a project status mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectStatusPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The project status that was created or updated.
-    pub status: Option<Box<ProjectStatus>>,
+    pub status: Option<ProjectStatus>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -7998,7 +9175,7 @@ impl GraphQLFields for ProjectStatusPayload {
         "lastSyncId success".into()
     }
 }
-/// An update associated with a project.
+/// A status update posted to a project. Project updates communicate progress, health, and blockers to stakeholders. Each update captures the project's health at the time of writing and includes a rich-text body with the update content.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectUpdate {
@@ -8021,15 +9198,15 @@ pub struct ProjectUpdate {
     pub body_data: Option<String>,
     /// The update's unique URL slug.
     pub slug_id: Option<String>,
-    /// The project that the update is associated with.
+    /// The project that this status update was posted to.
     pub project: Option<Box<Project>>,
-    /// The health of the project at the time of the update.
+    /// The health of the project at the time this update was posted. Possible values are onTrack, atRisk, or offTrack.
     pub health: Option<ProjectUpdateHealthType>,
     /// The user who wrote the update.
     pub user: Option<Box<User>>,
-    /// `Internal` Serialized JSON representing current state of the project properties when posting the project update.
+    /// `Internal` A snapshot of project properties at the time the update was posted, including team, milestone, and issue statistics. Used to compute diffs between consecutive updates.
     pub info_snapshot: Option<serde_json::Value>,
-    /// Whether project update diff should be hidden.
+    /// Whether the diff between this update and the previous one should be hidden in the UI.
     pub is_diff_hidden: Option<bool>,
     /// The URL to the project update.
     pub url: Option<String>,
@@ -8040,9 +9217,9 @@ pub struct ProjectUpdate {
     /// The diff between the current update and the previous one, formatted as markdown.
     pub diff_markdown: Option<String>,
     /// Reactions associated with the project update.
-    pub reactions: Option<Box<Vec<Reaction>>>,
+    pub reactions: Option<Vec<Reaction>>,
     /// Comments associated with the project update.
-    pub comments: Option<Box<CommentConnection>>,
+    pub comments: Option<CommentConnection>,
     /// Number of comments associated with the project update.
     pub comment_count: Option<i64>,
 }
@@ -8062,7 +9239,7 @@ pub struct ProjectUpdateArchivePayload {
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The archived/unarchived entity. Null if entity was deleted.
-    pub entity: Option<Box<ProjectUpdate>>,
+    pub entity: Option<ProjectUpdate>,
 }
 impl GraphQLFields for ProjectUpdateArchivePayload {
     type FullType = Self;
@@ -8073,9 +9250,9 @@ impl GraphQLFields for ProjectUpdateArchivePayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectUpdateConnection {
-    pub edges: Option<Box<Vec<ProjectUpdateEdge>>>,
-    pub nodes: Option<Box<Vec<ProjectUpdate>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<ProjectUpdateEdge>>,
+    pub nodes: Option<Vec<ProjectUpdate>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for ProjectUpdateConnection {
     type FullType = Self;
@@ -8086,7 +9263,7 @@ impl GraphQLFields for ProjectUpdateConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectUpdateEdge {
-    pub node: Option<Box<ProjectUpdate>>,
+    pub node: Option<ProjectUpdate>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -8096,13 +9273,14 @@ impl GraphQLFields for ProjectUpdateEdge {
         "cursor".into()
     }
 }
+/// The result of a project update mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectUpdatePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The project update that was created or updated.
-    pub project_update: Option<Box<ProjectUpdate>>,
+    pub project_update: Option<ProjectUpdate>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -8112,6 +9290,7 @@ impl GraphQLFields for ProjectUpdatePayload {
         "lastSyncId success".into()
     }
 }
+/// The result of a project update reminder mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ProjectUpdateReminderPayload {
@@ -8126,7 +9305,7 @@ impl GraphQLFields for ProjectUpdateReminderPayload {
         "lastSyncId success".into()
     }
 }
-/// `Internal` A pull request in a version control system.
+/// `Internal` A pull or merge request from a connected version control system (GitHub or GitLab). Pull requests are automatically linked to Linear issues via branch names or commit messages containing issue identifiers. They track the full lifecycle including status, reviewers, checks, and merge state, and are synced bidirectionally with the hosting provider.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct PullRequest {
@@ -8139,76 +9318,70 @@ pub struct PullRequest {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The pull request's unique URL slug.
+    /// The pull request's unique URL slug, used to construct human-readable URLs within the Linear app.
     pub slug_id: Option<String>,
     /// The title of the pull request.
     pub title: Option<String>,
-    /// The number of the pull request in the version control system.
+    /// The pull request number as assigned by the hosting provider (e.g., #123 on GitHub). Unique within a repository.
     pub number: Option<f64>,
-    /// The source branch of the pull request.
+    /// The source (head) branch of the pull request that contains the proposed changes.
     pub source_branch: Option<String>,
-    /// The target branch of the pull request.
+    /// The target (base) branch that the pull request will be merged into.
     pub target_branch: Option<String>,
-    /// The URL of the pull request in the version control system.
+    /// The Git SHA of the latest commit on the source branch. Updated as new commits are pushed. Null if not yet synced.
+    pub head_sha: Option<String>,
+    /// The Git SHA of the base commit on the target branch that the pull request is compared against. Null if not yet synced.
+    pub base_sha: Option<String>,
+    /// The URL of the pull request on the hosting provider (e.g., a GitHub or GitLab URL).
     pub url: Option<String>,
-    /// The status of the pull request.
+    /// The current status of the pull request (open, closed, merged, or draft). Synced from the hosting provider.
     pub status: Option<PullRequestStatus>,
-    /// Merge settings for this pull request.
-    pub merge_settings: Option<Box<PullRequestMergeSettings>>,
-    /// The merge commit created when the PR was merged.
-    pub merge_commit: Option<Box<PullRequestCommit>>,
-    /// `Internal` The checks associated with the pull request.
-    pub checks: Option<Box<Vec<PullRequestCheck>>>,
-    /// `ALPHA` The commits associated with the pull request.
-    pub commits: Option<Box<Vec<PullRequestCommit>>>,
-    /// `Internal` The user who created the pull request.
+    /// Merge settings and allowed merge methods for this pull request's repository. Null if the settings have not been synced from the provider.
+    pub merge_settings: Option<PullRequestMergeSettings>,
+    /// The merge commit created when the pull request was merged. Null if the pull request has not been merged or if the merge commit data is not available.
+    pub merge_commit: Option<PullRequestCommit>,
+    /// `Internal` The CI/CD checks and status checks associated with the pull request, synced from the hosting provider.
+    pub checks: Option<Vec<PullRequestCheck>>,
+    /// `ALPHA` The commits included in the pull request, synced from the hosting provider. Includes metadata such as SHA, message, diff stats, and author information.
+    pub commits: Option<Vec<PullRequestCommit>>,
+    /// `Internal` The Linear user who created the pull request. Null if the creator is an external user not mapped to a Linear account, or if the creator's account has been deleted.
     pub creator: Option<Box<User>>,
-    /// Agent sessions associated with this pull request.
-    pub agent_sessions: Option<Box<AgentSessionToPullRequestConnection>>,
-    /// Pull request URL to the Linear app
-    pub app_url: Option<String>,
-    /// The pull request's description in markdown format.
-    pub description: Option<String>,
-    /// The pull request's description as a Prosemirror document.
-    pub description_data: Option<serde_json::Value>,
-    /// Integration type that created this pull request, if applicable.
-    pub integration_source_type: Option<IntegrationService>,
-    /// Diff statistics for the pull request including file count, additions, deletions, and changes.
-    pub diff_stats: Option<Box<PullRequestDiffStats>>,
 }
 impl GraphQLFields for PullRequest {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt slugId title number sourceBranch targetBranch url status appUrl description descriptionData integrationSourceType"
+        "id createdAt updatedAt archivedAt slugId title number sourceBranch targetBranch headSha baseSha url status"
             .into()
     }
 }
-/// `ALPHA` A pull request check.
+/// `ALPHA` A CI/CD check or status check associated with a pull request (e.g., a GitHub Actions workflow run or a required status check).
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct PullRequestCheck {
     /// The name of the check.
     pub name: Option<String>,
-    /// The name of the workflow that triggered the check.
+    /// The name of the CI workflow that triggered the check (e.g., 'CI' or 'Build and Test'). Null if the check is not part of a named workflow.
     pub workflow_name: Option<String>,
     /// The status of the check.
     pub status: Option<String>,
-    /// The URL of the check.
+    /// The URL to view the check details on the hosting provider. Null if no URL is available.
     pub url: Option<String>,
-    /// Whether the check is required.
+    /// Whether this check is required to pass before the pull request can be merged. Null if the required status is unknown.
     pub is_required: Option<bool>,
-    /// The date/time at which when the check was started.
+    /// How the check should be opened in the client.
+    pub presentation: Option<PullRequestCheckPresentation>,
+    /// The date and time when the check started running. Null if the check has not started yet.
     pub started_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The date/time at which when the check was completed.
+    /// The date and time when the check finished running. Null if the check has not completed yet.
     pub completed_at: Option<chrono::DateTime<chrono::Utc>>,
 }
 impl GraphQLFields for PullRequestCheck {
     type FullType = Self;
     fn selection() -> String {
-        "name workflowName status url isRequired startedAt completedAt".into()
+        "name workflowName status url isRequired presentation startedAt completedAt".into()
     }
 }
-/// `ALPHA` A pull request commit.
+/// `ALPHA` A Git commit associated with a pull request, including metadata about the commit's content and authors.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct PullRequestCommit {
@@ -8216,14 +9389,16 @@ pub struct PullRequestCommit {
     pub sha: Option<String>,
     /// The full commit message.
     pub message: Option<String>,
-    /// The timestamp when the commit was committed (ISO 8601 string).
+    /// The timestamp when the commit was committed, as an ISO 8601 string.
     pub committed_at: Option<String>,
     /// Number of additions in this commit.
     pub additions: Option<f64>,
     /// Number of deletions in this commit.
     pub deletions: Option<f64>,
-    /// The number of changed files if available.
+    /// The number of files changed in this commit. Null if the hosting provider did not include this information.
     pub changed_files: Option<f64>,
+    /// Whether this commit is a merge commit (has multiple parents). Merge commits are typically filtered out when counting diff stats.
+    pub is_merge_commit: Option<bool>,
     /// Linear user IDs for commit authors (includes co-authors).
     pub author_user_ids: Option<Vec<String>>,
     /// External user IDs for commit authors (includes co-authors).
@@ -8232,34 +9407,15 @@ pub struct PullRequestCommit {
 impl GraphQLFields for PullRequestCommit {
     type FullType = Self;
     fn selection() -> String {
-        "sha message committedAt additions deletions changedFiles authorUserIds authorExternalUserIds"
+        "sha message committedAt additions deletions changedFiles isMergeCommit authorUserIds authorExternalUserIds"
             .into()
     }
 }
-/// Diff statistics for a pull request.
-#[derive(Debug, Clone, Default, Serialize, Deserialize)]
-#[serde(rename_all = "camelCase", default)]
-pub struct PullRequestDiffStats {
-    /// The number of files changed in the pull request.
-    pub file_count: Option<f64>,
-    /// The number of lines added in the pull request.
-    pub additions: Option<f64>,
-    /// The number of lines changed in the pull request.
-    pub changes: Option<f64>,
-    /// The number of lines deleted in the pull request.
-    pub deletions: Option<f64>,
-}
-impl GraphQLFields for PullRequestDiffStats {
-    type FullType = Self;
-    fn selection() -> String {
-        "fileCount additions changes deletions".into()
-    }
-}
-/// `Internal` Merge settings for a pull request
+/// `Internal` Merge settings and capabilities for a pull request's repository, including which merge methods are allowed and whether features like merge queues and auto-merge are enabled.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct PullRequestMergeSettings {
-    /// Whether merge queue is enabled for this repository.
+    /// Whether a merge queue is enabled for pull requests in this repository. When enabled, merges go through an ordered queue rather than being merged directly.
     pub is_merge_queue_enabled: Option<bool>,
     /// Whether squash merge is allowed for this pull request's repository.
     pub squash_merge_allowed: Option<bool>,
@@ -8271,7 +9427,7 @@ pub struct PullRequestMergeSettings {
     pub merge_commit_allowed: Option<bool>,
     /// Whether the branch will be deleted when the pull request is merged.
     pub delete_branch_on_merge: Option<bool>,
-    /// The method used to merge a pull request.
+    /// The merge method used by the merge queue, if applicable. Null when merge queue is not enabled or the method is not specified.
     pub merge_queue_merge_method: Option<PullRequestMergeMethod>,
 }
 impl GraphQLFields for PullRequestMergeSettings {
@@ -8281,7 +9437,7 @@ impl GraphQLFields for PullRequestMergeSettings {
             .into()
     }
 }
-/// A pull request related notification.
+/// A notification related to a pull request, such as review requests, approvals, comments, check failures, or merge queue events.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct PullRequestNotification {
@@ -8294,22 +9450,21 @@ pub struct PullRequestNotification {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Notification type.
+    /// Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated.
     pub r#type: Option<String>,
-    /// The user that caused the notification.
-    pub actor: Option<Box<User>>,
-    /// The external user that caused the notification.
-    pub external_user_actor: Option<Box<ExternalUser>>,
-    /// The user that received the notification.
-    pub user: Option<Box<User>>,
-    /// The time at when the user marked the notification as read. Null, if the the user hasn't read the notification
+    /// The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event.
+    pub actor: Option<User>,
+    /// The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member.
+    pub external_user_actor: Option<ExternalUser>,
+    /// The recipient user of this notification.
+    pub user: Option<User>,
+    /// The time at which the user marked the notification as read. Null if the notification is unread.
     pub read_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at when an email reminder for this notification was sent to the user. Null, if no email
-    /// reminder has been sent.
+    /// The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent.
     pub emailed_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time until a notification will be snoozed. After that it will appear in the inbox again.
+    /// The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed.
     pub snoozed_until_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which a notification was unsnoozed..
+    /// The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed.
     pub unsnoozed_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The category of the notification.
     pub category: Option<NotificationCategory>,
@@ -8340,13 +9495,13 @@ pub struct PullRequestNotification {
     /// `Internal` Priority of the notification with the same grouping key. Higher number means higher priority. If priority is the same, notifications should be sorted by `createdAt`.
     pub grouping_priority: Option<f64>,
     /// The bot that caused the notification.
-    pub bot_actor: Option<Box<ActorBot>>,
+    pub bot_actor: Option<ActorBot>,
     /// Related pull request.
     pub pull_request_id: Option<String>,
     /// Related pull request comment ID. Null if the notification is not related to a pull request comment.
     pub pull_request_comment_id: Option<String>,
     /// The pull request related to the notification.
-    pub pull_request: Option<Box<PullRequest>>,
+    pub pull_request: Option<PullRequest>,
 }
 impl GraphQLFields for PullRequestNotification {
     type FullType = Self;
@@ -8355,7 +9510,7 @@ impl GraphQLFields for PullRequestNotification {
             .into()
     }
 }
-/// A user's web or mobile push notification subscription.
+/// A device registration for receiving push notifications. Each PushSubscription represents a specific browser or mobile device endpoint where a user has opted in to receive real-time push notifications. A user may have multiple push subscriptions across different devices and browsers.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct PushSubscription {
@@ -8375,13 +9530,14 @@ impl GraphQLFields for PushSubscription {
         "id createdAt updatedAt archivedAt".into()
     }
 }
+/// Return type for push subscription mutations.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct PushSubscriptionPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    /// The push subscription that was created or updated.
-    pub entity: Option<Box<PushSubscription>>,
+    /// The push subscription that was created or deleted.
+    pub entity: Option<PushSubscription>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -8391,6 +9547,7 @@ impl GraphQLFields for PushSubscriptionPayload {
         "lastSyncId success".into()
     }
 }
+/// Return type for the push subscription test query.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct PushSubscriptionTestPayload {
@@ -8403,15 +9560,16 @@ impl GraphQLFields for PushSubscriptionTestPayload {
         "success".into()
     }
 }
+/// The current rate limit status for the authenticated entity.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct RateLimitPayload {
-    /// The identifier we rate limit on.
+    /// The identifier being rate limited, typically the API key or user ID.
     pub identifier: Option<String>,
-    /// The kind of rate limit selected for this request.
+    /// The category of rate limit applied to this request, such as API complexity or request count.
     pub kind: Option<String>,
-    /// The state of the rate limit.
-    pub limits: Option<Box<Vec<RateLimitResultPayload>>>,
+    /// The current state of each rate limit type, including remaining quota and reset timing.
+    pub limits: Option<Vec<RateLimitResultPayload>>,
 }
 impl GraphQLFields for RateLimitPayload {
     type FullType = Self;
@@ -8419,20 +9577,21 @@ impl GraphQLFields for RateLimitPayload {
         "identifier kind".into()
     }
 }
+/// The state of a specific rate limit type, including remaining quota and reset timing.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct RateLimitResultPayload {
-    /// What is being rate limited.
+    /// The specific type of rate limit being tracked, such as query complexity or mutation count.
     pub r#type: Option<String>,
     /// The requested quantity for this type of limit.
     pub requested_amount: Option<f64>,
     /// The total allowed quantity for this type of limit.
     pub allowed_amount: Option<f64>,
-    /// The period in which the rate limit is fully replenished in ms.
+    /// The duration in milliseconds of the rate limit window. After this period elapses, the limit is fully replenished.
     pub period: Option<f64>,
     /// The remaining quantity for this type of limit after this request.
     pub remaining_amount: Option<f64>,
-    /// The timestamp after the rate limit is fully replenished as a UNIX timestamp.
+    /// The UNIX timestamp (in milliseconds) at which the rate limit will be fully replenished.
     pub reset: Option<f64>,
 }
 impl GraphQLFields for RateLimitResultPayload {
@@ -8441,7 +9600,7 @@ impl GraphQLFields for RateLimitResultPayload {
         "type requestedAmount allowedAmount period remainingAmount reset".into()
     }
 }
-/// A reaction associated with a comment or a project update.
+/// An emoji reaction on a comment, issue, project update, initiative update, post, pull request, or pull request comment. Each reaction is associated with exactly one parent entity and is created by either a workspace user or an external user. Reactions are persisted individually but surfaced on their parent entities as aggregated reactionData.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Reaction {
@@ -8454,22 +9613,22 @@ pub struct Reaction {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Name of the reaction's emoji.
+    /// The name of the emoji used for this reaction. For custom workspace emojis, this is the custom emoji name; for standard emojis, this is the normalized emoji name.
     pub emoji: Option<String>,
-    /// The issue that the reaction is associated with.
-    pub issue: Option<Box<Issue>>,
-    /// The comment that the reaction is associated with.
-    pub comment: Option<Box<Comment>>,
-    /// The project update that the reaction is associated with.
-    pub project_update: Option<Box<ProjectUpdate>>,
-    /// The initiative update that the reaction is associated with.
-    pub initiative_update: Option<Box<InitiativeUpdate>>,
-    /// The post that the reaction is associated with.
-    pub post: Option<Box<Post>>,
-    /// The user that created the reaction.
-    pub user: Option<Box<User>>,
-    /// The external user that created the reaction.
-    pub external_user: Option<Box<ExternalUser>>,
+    /// The issue that the reaction is associated with. Null if the reaction belongs to a different parent entity type.
+    pub issue: Option<Issue>,
+    /// The comment that the reaction is associated with. Null if the reaction belongs to a different parent entity type.
+    pub comment: Option<Comment>,
+    /// The project update that the reaction is associated with. Null if the reaction belongs to a different parent entity type.
+    pub project_update: Option<ProjectUpdate>,
+    /// The initiative update that the reaction is associated with. Null if the reaction belongs to a different parent entity type.
+    pub initiative_update: Option<InitiativeUpdate>,
+    /// The post that the reaction is associated with. Null if the reaction belongs to a different parent entity type.
+    pub post: Option<Post>,
+    /// The workspace user that created the reaction. Null if the reaction was created by an external user through an integration.
+    pub user: Option<User>,
+    /// The external user that created the reaction through an integration. Null if the reaction was created by a workspace user.
+    pub external_user: Option<ExternalUser>,
 }
 impl GraphQLFields for Reaction {
     type FullType = Self;
@@ -8477,12 +9636,15 @@ impl GraphQLFields for Reaction {
         "id createdAt updatedAt archivedAt emoji".into()
     }
 }
+/// The result of a reaction mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ReactionPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    pub reaction: Option<Box<Reaction>>,
+    /// The reaction that was created.
+    pub reaction: Option<Reaction>,
+    /// Whether the operation was successful.
     pub success: Option<bool>,
 }
 impl GraphQLFields for ReactionPayload {
@@ -8491,7 +9653,7 @@ impl GraphQLFields for ReactionPayload {
         "lastSyncId success".into()
     }
 }
-/// `Internal` A release.
+/// `Internal` A release that bundles issues together for a software deployment or version. Releases belong to a release pipeline and progress through stages (e.g., planned, started, completed, canceled). Issues are associated with releases via the IssueToRelease join entity, and the release tracks lifecycle timestamps such as when it was started, completed, or canceled.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Release {
@@ -8506,39 +9668,55 @@ pub struct Release {
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The name of the release.
     pub name: Option<String>,
-    /// The release's description.
+    /// The description of the release in plain text or markdown. Null if no description has been set.
     pub description: Option<String>,
-    /// The version of the release.
+    /// The version identifier for this release (e.g., 'v1.2.3' or a short commit hash). Must be unique within the pipeline. Null if no version has been assigned.
     pub version: Option<String>,
-    /// The commit SHA associated with this release.
+    /// The Git commit SHA associated with this release. Used for SHA-based idempotency when completing releases and for linking releases to specific points in the repository history. Null if the release was created without a commit reference.
     pub commit_sha: Option<String>,
-    /// The pipeline this release belongs to.
-    pub pipeline: Option<Box<ReleasePipeline>>,
-    /// The current stage of the release.
-    pub stage: Option<Box<ReleaseStage>>,
-    /// The release's unique URL slug.
+    /// The release pipeline that this release belongs to. A release always belongs to exactly one pipeline.
+    pub pipeline: Option<ReleasePipeline>,
+    /// The current stage of the release within its pipeline (e.g., Planned, In Progress, Completed, Canceled). Changing the stage triggers lifecycle timestamp updates and may move non-closed issues to a new release when completing a scheduled pipeline release.
+    pub stage: Option<ReleaseStage>,
+    /// The user who created the release. Null if the release was created by a non-user context such as an access key or automation.
+    pub creator: Option<Box<User>>,
+    /// The release's unique URL slug, used to construct human-readable URLs for the release.
     pub slug_id: Option<String>,
-    /// The estimated start date of the release.
+    /// The estimated start date of the release. This is a date-only value without a time component. Automatically set to today when the release moves to a started stage if not already set. Null if no start date has been specified.
     pub start_date: Option<chrono::NaiveDate>,
-    /// The estimated completion date of the release.
+    /// The estimated completion date of the release. This is a date-only value without a time component. Null if no target date has been specified.
     pub target_date: Option<chrono::NaiveDate>,
-    /// The time at which the release was started.
+    /// The time at which the release first entered a started stage. Null if the release has not yet been started.
     pub started_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the release was completed.
+    /// The time at which the release was completed. Set automatically when the release moves to a completed stage. Reset to null if the release moves back to a non-completed stage.
     pub completed_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which the release was canceled.
+    /// The time at which the release was canceled. Set automatically when the release moves to a canceled stage. Reset to null if the release moves back to a non-canceled stage.
     pub canceled_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Release URL.
+    /// A flag that indicates whether the release is in the trash bin. Trashed releases are archived and will be permanently deleted after a retention period. Null when the release is not trashed.
+    pub trashed: Option<bool>,
+    /// `Internal` The historical progress snapshots for the release, tracking how issue completion has evolved over time.
+    pub progress_history: Option<serde_json::Value>,
+    /// `Internal` The current progress summary for the release, including counts of issues by workflow state type (e.g., completed, in progress, unstarted).
+    pub current_progress: Option<serde_json::Value>,
+    /// `Internal` History entries associated with the release.
+    pub history: Option<ReleaseHistoryConnection>,
+    /// The URL to the release page in the Linear app.
     pub url: Option<String>,
     /// `Internal` Documents associated with the release.
-    pub documents: Option<Box<DocumentConnection>>,
+    pub documents: Option<DocumentConnection>,
+    /// `ALPHA` Issues associated with the release.
+    pub issues: Option<IssueConnection>,
+    /// `ALPHA` Number of issues associated with the release.
+    pub issue_count: Option<i64>,
     /// `Internal` Links associated with the release.
-    pub links: Option<Box<EntityExternalLinkConnection>>,
+    pub links: Option<EntityExternalLinkConnection>,
+    /// `ALPHA` Release notes for the release.
+    pub release_notes: Option<Vec<ReleaseNote>>,
 }
 impl GraphQLFields for Release {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt name description version commitSha slugId startDate targetDate startedAt completedAt canceledAt url"
+        "id createdAt updatedAt archivedAt name description version commitSha slugId startDate targetDate startedAt completedAt canceledAt trashed progressHistory currentProgress url issueCount"
             .into()
     }
 }
@@ -8551,7 +9729,7 @@ pub struct ReleaseArchivePayload {
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The archived/unarchived entity. Null if entity was deleted.
-    pub entity: Option<Box<Release>>,
+    pub entity: Option<Release>,
 }
 impl GraphQLFields for ReleaseArchivePayload {
     type FullType = Self;
@@ -8562,9 +9740,9 @@ impl GraphQLFields for ReleaseArchivePayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ReleaseConnection {
-    pub edges: Option<Box<Vec<ReleaseEdge>>>,
-    pub nodes: Option<Box<Vec<Release>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<ReleaseEdge>>,
+    pub nodes: Option<Vec<Release>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for ReleaseConnection {
     type FullType = Self;
@@ -8575,7 +9753,7 @@ impl GraphQLFields for ReleaseConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ReleaseEdge {
-    pub node: Option<Box<Release>>,
+    pub node: Option<Release>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -8585,13 +9763,131 @@ impl GraphQLFields for ReleaseEdge {
         "cursor".into()
     }
 }
+/// `Internal` A release history record containing a batch of chronologically ordered change events for a release. Each record holds up to 30 entries, and new records are created once the current record is full and a time window has elapsed. Tracks changes to name, description, version, stage, dates, pipeline, and archive status.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct ReleaseHistory {
+    /// The unique identifier of the entity.
+    pub id: Option<String>,
+    /// The time at which the entity was created.
+    pub created_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
+    /// been updated after creation.
+    pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The time at which the entity was archived. Null if the entity has not been archived.
+    pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The events that happened while recording that history.
+    pub entries: Option<serde_json::Value>,
+    /// The release that this history record tracks changes for.
+    pub release: Option<Release>,
+}
+impl GraphQLFields for ReleaseHistory {
+    type FullType = Self;
+    fn selection() -> String {
+        "id createdAt updatedAt archivedAt entries".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct ReleaseHistoryConnection {
+    pub edges: Option<Vec<ReleaseHistoryEdge>>,
+    pub nodes: Option<Vec<ReleaseHistory>>,
+    pub page_info: Option<PageInfo>,
+}
+impl GraphQLFields for ReleaseHistoryConnection {
+    type FullType = Self;
+    fn selection() -> String {
+        "".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct ReleaseHistoryEdge {
+    pub node: Option<ReleaseHistory>,
+    /// Used in `before` and `after` args
+    pub cursor: Option<String>,
+}
+impl GraphQLFields for ReleaseHistoryEdge {
+    type FullType = Self;
+    fn selection() -> String {
+        "cursor".into()
+    }
+}
+/// `Internal` A release note. The note body is stored in related document content, and the releases it covers are tracked in releaseIds.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct ReleaseNote {
+    /// The unique identifier of the entity.
+    pub id: Option<String>,
+    /// The time at which the entity was created.
+    pub created_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
+    /// been updated after creation.
+    pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// The time at which the entity was archived. Null if the entity has not been archived.
+    pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
+    /// `ALPHA` Releases included in the note.
+    pub releases: Option<Vec<Release>>,
+    /// `Internal` Document content backing the release note body.
+    pub document_content: Option<DocumentContent>,
+}
+impl GraphQLFields for ReleaseNote {
+    type FullType = Self;
+    fn selection() -> String {
+        "id createdAt updatedAt archivedAt".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct ReleaseNoteConnection {
+    pub edges: Option<Vec<ReleaseNoteEdge>>,
+    pub nodes: Option<Vec<ReleaseNote>>,
+    pub page_info: Option<PageInfo>,
+}
+impl GraphQLFields for ReleaseNoteConnection {
+    type FullType = Self;
+    fn selection() -> String {
+        "".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct ReleaseNoteEdge {
+    pub node: Option<ReleaseNote>,
+    /// Used in `before` and `after` args
+    pub cursor: Option<String>,
+}
+impl GraphQLFields for ReleaseNoteEdge {
+    type FullType = Self;
+    fn selection() -> String {
+        "cursor".into()
+    }
+}
+/// `ALPHA` The result of a release note mutation.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct ReleaseNotePayload {
+    /// The identifier of the last sync operation.
+    pub last_sync_id: Option<f64>,
+    /// The release note that was created or updated.
+    pub release_note: Option<ReleaseNote>,
+    /// Whether the operation was successful.
+    pub success: Option<bool>,
+}
+impl GraphQLFields for ReleaseNotePayload {
+    type FullType = Self;
+    fn selection() -> String {
+        "lastSyncId success".into()
+    }
+}
+/// The result of a release mutation, containing the release that was created or updated and a success indicator.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ReleasePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The release that was created or updated.
-    pub release: Option<Box<Release>>,
+    pub release: Option<Release>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -8601,7 +9897,7 @@ impl GraphQLFields for ReleasePayload {
         "lastSyncId success".into()
     }
 }
-/// `Internal` A release pipeline.
+/// `Internal` A release pipeline that defines a release workflow with ordered stages. Pipelines can be continuous (each sync creates a completed release) or scheduled (issues accumulate in a started release that is explicitly completed). Pipelines are associated with teams and can filter commits by file path patterns.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ReleasePipeline {
@@ -8616,23 +9912,30 @@ pub struct ReleasePipeline {
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The name of the pipeline.
     pub name: Option<String>,
-    /// The pipeline's unique slug identifier.
+    /// The pipeline's unique slug identifier, used in URLs and for lookup by human-readable identifier instead of UUID.
     pub slug_id: Option<String>,
-    /// The type of the pipeline.
+    /// The type of the pipeline, which determines how releases are created and managed. Continuous pipelines create a completed release per sync, while scheduled pipelines accumulate issues in a started release.
     pub r#type: Option<ReleasePipelineType>,
-    /// Glob patterns to include commits affecting matching file paths.
+    /// `ALPHA` Whether this pipeline targets a production environment. Defaults to true. Used to distinguish production pipelines from staging or development pipelines.
+    pub is_production: Option<bool>,
+    /// Glob patterns to filter commits by file path. When non-empty, only commits that modify files matching at least one pattern will be included in release syncs. An empty array means all commits are included regardless of file paths.
     pub include_path_patterns: Option<Vec<String>>,
-    /// `ALPHA` The active access key for this pipeline.
-    pub access_key: Option<Box<AccessKey>>,
+    /// `ALPHA` The approximate number of non-archived releases in this pipeline. This is a denormalized count that is updated when releases are created or archived, and may not reflect the exact count at all times.
+    pub approximate_release_count: Option<i64>,
+    /// `Internal` The URL to the release pipeline's releases list in the Linear app.
+    pub url: Option<String>,
+    /// `ALPHA` Teams associated with this pipeline.
+    pub teams: Option<TeamConnection>,
     /// `ALPHA` Stages associated with this pipeline.
-    pub stages: Option<Box<ReleaseStageConnection>>,
+    pub stages: Option<ReleaseStageConnection>,
     /// `ALPHA` Releases associated with this pipeline.
-    pub releases: Option<Box<ReleaseConnection>>,
+    pub releases: Option<ReleaseConnection>,
 }
 impl GraphQLFields for ReleasePipeline {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt name slugId type includePathPatterns".into()
+        "id createdAt updatedAt archivedAt name slugId type isProduction includePathPatterns approximateReleaseCount url"
+            .into()
     }
 }
 /// A generic payload return from entity archive mutations.
@@ -8644,7 +9947,7 @@ pub struct ReleasePipelineArchivePayload {
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The archived/unarchived entity. Null if entity was deleted.
-    pub entity: Option<Box<ReleasePipeline>>,
+    pub entity: Option<ReleasePipeline>,
 }
 impl GraphQLFields for ReleasePipelineArchivePayload {
     type FullType = Self;
@@ -8655,9 +9958,9 @@ impl GraphQLFields for ReleasePipelineArchivePayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ReleasePipelineConnection {
-    pub edges: Option<Box<Vec<ReleasePipelineEdge>>>,
-    pub nodes: Option<Box<Vec<ReleasePipeline>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<ReleasePipelineEdge>>,
+    pub nodes: Option<Vec<ReleasePipeline>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for ReleasePipelineConnection {
     type FullType = Self;
@@ -8668,7 +9971,7 @@ impl GraphQLFields for ReleasePipelineConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ReleasePipelineEdge {
-    pub node: Option<Box<ReleasePipeline>>,
+    pub node: Option<ReleasePipeline>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -8678,13 +9981,14 @@ impl GraphQLFields for ReleasePipelineEdge {
         "cursor".into()
     }
 }
+/// The result of a release pipeline mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ReleasePipelinePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The release pipeline that was created or updated.
-    pub release_pipeline: Option<Box<ReleasePipeline>>,
+    pub release_pipeline: Option<ReleasePipeline>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -8694,7 +9998,7 @@ impl GraphQLFields for ReleasePipelinePayload {
         "lastSyncId success".into()
     }
 }
-/// `Internal` A release stage.
+/// `Internal` A stage within a release pipeline that represents a phase in the release lifecycle (e.g., Planned, In Progress, Completed, Canceled). Releases progress through stages as they move toward production. Started-type stages can be frozen to prevent new issues from being automatically synced into releases at that stage.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ReleaseStage {
@@ -8709,18 +10013,18 @@ pub struct ReleaseStage {
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The name of the stage.
     pub name: Option<String>,
-    /// The UI color of the stage as a HEX string.
+    /// The display color of the stage as a HEX string (e.g., '#0f783c'), used for visual representation in the UI.
     pub color: Option<String>,
-    /// The type of the stage.
+    /// The lifecycle type of the stage (planned, started, completed, or canceled). The type determines what lifecycle timestamps are set on a release when it enters this stage.
     pub r#type: Option<ReleaseStageType>,
-    /// The position of the stage.
+    /// The position of the stage within its pipeline, used for ordering stages in the UI. Lower values appear first.
     pub position: Option<f64>,
-    /// Whether this stage is frozen. Only applicable to started type stages.
+    /// Whether this stage is frozen. Only applicable to started-type stages. When a stage is frozen, automated release syncs will not target releases in this stage, and new issues will not be automatically added. At least one started stage in the pipeline must remain non-frozen.
     pub frozen: Option<bool>,
-    /// The pipeline this stage belongs to.
-    pub pipeline: Option<Box<ReleasePipeline>>,
+    /// The release pipeline that this stage belongs to. A stage always belongs to exactly one pipeline.
+    pub pipeline: Option<ReleasePipeline>,
     /// `ALPHA` Releases associated with this stage.
-    pub releases: Option<Box<ReleaseConnection>>,
+    pub releases: Option<ReleaseConnection>,
 }
 impl GraphQLFields for ReleaseStage {
     type FullType = Self;
@@ -8737,7 +10041,7 @@ pub struct ReleaseStageArchivePayload {
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The archived/unarchived entity. Null if entity was deleted.
-    pub entity: Option<Box<ReleaseStage>>,
+    pub entity: Option<ReleaseStage>,
 }
 impl GraphQLFields for ReleaseStageArchivePayload {
     type FullType = Self;
@@ -8748,9 +10052,9 @@ impl GraphQLFields for ReleaseStageArchivePayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ReleaseStageConnection {
-    pub edges: Option<Box<Vec<ReleaseStageEdge>>>,
-    pub nodes: Option<Box<Vec<ReleaseStage>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<ReleaseStageEdge>>,
+    pub nodes: Option<Vec<ReleaseStage>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for ReleaseStageConnection {
     type FullType = Self;
@@ -8761,7 +10065,7 @@ impl GraphQLFields for ReleaseStageConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ReleaseStageEdge {
-    pub node: Option<Box<ReleaseStage>>,
+    pub node: Option<ReleaseStage>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -8771,13 +10075,14 @@ impl GraphQLFields for ReleaseStageEdge {
         "cursor".into()
     }
 }
+/// The result of a release stage mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ReleaseStagePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The release stage that was created or updated.
-    pub release_stage: Option<Box<ReleaseStage>>,
+    pub release_stage: Option<ReleaseStage>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -8787,6 +10092,7 @@ impl GraphQLFields for ReleaseStagePayload {
         "lastSyncId success".into()
     }
 }
+/// A suggested code repository that may be relevant for implementing an issue.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct RepositorySuggestion {
@@ -8803,11 +10109,12 @@ impl GraphQLFields for RepositorySuggestion {
         "repositoryFullName hostname confidence".into()
     }
 }
+/// The result of a repository suggestions query, containing the list of suggested repositories.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct RepositorySuggestionsPayload {
     /// The suggested repositories.
-    pub suggestions: Option<Box<Vec<RepositorySuggestion>>>,
+    pub suggestions: Option<Vec<RepositorySuggestion>>,
 }
 impl GraphQLFields for RepositorySuggestionsPayload {
     type FullType = Self;
@@ -8815,7 +10122,7 @@ impl GraphQLFields for RepositorySuggestionsPayload {
         "".into()
     }
 }
-/// `Deprecated` A roadmap for projects.
+/// `Deprecated` A roadmap for grouping projects. Use Initiative instead, which supersedes this entity and provides richer hierarchy and tracking capabilities.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Roadmap {
@@ -8832,20 +10139,20 @@ pub struct Roadmap {
     pub name: Option<String>,
     /// The description of the roadmap.
     pub description: Option<String>,
-    /// The organization of the roadmap.
-    pub organization: Option<Box<Organization>>,
+    /// The workspace of the roadmap.
+    pub organization: Option<Organization>,
     /// The user who created the roadmap.
-    pub creator: Option<Box<User>>,
+    pub creator: Option<User>,
     /// The user who owns the roadmap.
-    pub owner: Option<Box<User>>,
+    pub owner: Option<User>,
     /// The roadmap's unique URL slug.
     pub slug_id: Option<String>,
-    /// The sort order of the roadmap within the organization.
+    /// The sort order of the roadmap within the workspace.
     pub sort_order: Option<f64>,
     /// The roadmap's color.
     pub color: Option<String>,
     /// Projects associated with the roadmap.
-    pub projects: Option<Box<ProjectConnection>>,
+    pub projects: Option<ProjectConnection>,
     /// The canonical url for the roadmap.
     pub url: Option<String>,
 }
@@ -8864,7 +10171,7 @@ pub struct RoadmapArchivePayload {
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The archived/unarchived entity. Null if entity was deleted.
-    pub entity: Option<Box<Roadmap>>,
+    pub entity: Option<Roadmap>,
 }
 impl GraphQLFields for RoadmapArchivePayload {
     type FullType = Self;
@@ -8875,9 +10182,9 @@ impl GraphQLFields for RoadmapArchivePayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct RoadmapConnection {
-    pub edges: Option<Box<Vec<RoadmapEdge>>>,
-    pub nodes: Option<Box<Vec<Roadmap>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<RoadmapEdge>>,
+    pub nodes: Option<Vec<Roadmap>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for RoadmapConnection {
     type FullType = Self;
@@ -8888,7 +10195,7 @@ impl GraphQLFields for RoadmapConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct RoadmapEdge {
-    pub node: Option<Box<Roadmap>>,
+    pub node: Option<Roadmap>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -8898,13 +10205,14 @@ impl GraphQLFields for RoadmapEdge {
         "cursor".into()
     }
 }
+/// The result of a roadmap mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct RoadmapPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The roadmap that was created or updated.
-    pub roadmap: Option<Box<Roadmap>>,
+    pub roadmap: Option<Roadmap>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -8914,7 +10222,7 @@ impl GraphQLFields for RoadmapPayload {
         "lastSyncId success".into()
     }
 }
-/// `Deprecated` Join table between projects and roadmaps.
+/// `Deprecated` The join entity linking a project to a roadmap. Use InitiativeToProject instead, which supersedes this entity.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct RoadmapToProject {
@@ -8928,9 +10236,9 @@ pub struct RoadmapToProject {
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The project that the roadmap is associated with.
-    pub project: Option<Box<Project>>,
+    pub project: Option<Project>,
     /// The roadmap that the project is associated with.
-    pub roadmap: Option<Box<Roadmap>>,
+    pub roadmap: Option<Roadmap>,
     /// The sort order of the project within the roadmap.
     pub sort_order: Option<String>,
 }
@@ -8943,9 +10251,9 @@ impl GraphQLFields for RoadmapToProject {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct RoadmapToProjectConnection {
-    pub edges: Option<Box<Vec<RoadmapToProjectEdge>>>,
-    pub nodes: Option<Box<Vec<RoadmapToProject>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<RoadmapToProjectEdge>>,
+    pub nodes: Option<Vec<RoadmapToProject>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for RoadmapToProjectConnection {
     type FullType = Self;
@@ -8956,7 +10264,7 @@ impl GraphQLFields for RoadmapToProjectConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct RoadmapToProjectEdge {
-    pub node: Option<Box<RoadmapToProject>>,
+    pub node: Option<RoadmapToProject>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -8966,13 +10274,14 @@ impl GraphQLFields for RoadmapToProjectEdge {
         "cursor".into()
     }
 }
+/// The result of a roadmap-to-project mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct RoadmapToProjectPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The roadmapToProject that was created or updated.
-    pub roadmap_to_project: Option<Box<RoadmapToProject>>,
+    pub roadmap_to_project: Option<RoadmapToProject>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -8982,13 +10291,14 @@ impl GraphQLFields for RoadmapToProjectPayload {
         "lastSyncId success".into()
     }
 }
-/// Payload returned by semantic search.
+/// The payload returned by the semantic search query, containing the list of matching results.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct SemanticSearchPayload {
     /// Whether the semantic search is enabled.
     pub enabled: Option<bool>,
-    pub results: Option<Box<Vec<SemanticSearchResult>>>,
+    /// The list of matching search results, ordered by relevance score.
+    pub results: Option<Vec<SemanticSearchResult>>,
 }
 impl GraphQLFields for SemanticSearchPayload {
     type FullType = Self;
@@ -8996,7 +10306,7 @@ impl GraphQLFields for SemanticSearchPayload {
         "enabled".into()
     }
 }
-/// A semantic search result reference.
+/// A reference to an entity returned by semantic search, containing its type and ID. Resolve the specific entity using the type-specific field resolvers (issue, project, initiative, document).
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct SemanticSearchResult {
@@ -9004,14 +10314,14 @@ pub struct SemanticSearchResult {
     pub id: Option<String>,
     /// The type of the semantic search result.
     pub r#type: Option<SemanticSearchResultType>,
-    /// The issue related to the semantic search result.
-    pub issue: Option<Box<Issue>>,
-    /// The project related to the semantic search result.
-    pub project: Option<Box<Project>>,
-    /// The initiative related to the semantic search result.
-    pub initiative: Option<Box<Initiative>>,
-    /// The document related to the semantic search result.
-    pub document: Option<Box<Document>>,
+    /// The issue entity, if this search result is of type Issue. Null for other result types.
+    pub issue: Option<Issue>,
+    /// The project entity, if this search result is of type Project. Null for other result types.
+    pub project: Option<Project>,
+    /// The initiative entity, if this search result is of type Initiative. Null for other result types.
+    pub initiative: Option<Initiative>,
+    /// The document entity, if this search result is of type Document. Null for other result types.
+    pub document: Option<Document>,
 }
 impl GraphQLFields for SemanticSearchResult {
     type FullType = Self;
@@ -9019,7 +10329,7 @@ impl GraphQLFields for SemanticSearchResult {
         "id type".into()
     }
 }
-/// SES domain identity used for sending emails from a custom domain.
+/// A verified Amazon SES domain identity that enables sending emails from a custom domain. Organizations configure SES domain identities to send issue notification replies and Asks auto-replies from their own domain instead of the default Linear domain. Full verification requires DKIM signing, a custom MAIL FROM domain, and organization ownership confirmation. Multiple organizations sharing the same domain each have their own SesDomainIdentity record but share the underlying SES identity.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct SesDomainIdentity {
@@ -9036,14 +10346,14 @@ pub struct SesDomainIdentity {
     pub domain: Option<String>,
     /// The AWS region of the SES domain identity.
     pub region: Option<String>,
-    /// The organization of the SES domain identity.
-    pub organization: Option<Box<Organization>>,
+    /// The workspace of the SES domain identity.
+    pub organization: Option<Organization>,
     /// The user who created the SES domain identity.
-    pub creator: Option<Box<User>>,
+    pub creator: Option<User>,
     /// Whether the domain is fully verified and can be used for sending emails.
     pub can_send_from_custom_domain: Option<bool>,
     /// The DNS records for the SES domain identity.
-    pub dns_records: Option<Box<Vec<SesDomainIdentityDnsRecord>>>,
+    pub dns_records: Option<Vec<SesDomainIdentityDnsRecord>>,
 }
 impl GraphQLFields for SesDomainIdentity {
     type FullType = Self;
@@ -9070,7 +10380,7 @@ impl GraphQLFields for SesDomainIdentityDnsRecord {
         "type name content isVerified".into()
     }
 }
-/// Tuple for mapping Slack channel IDs to names.
+/// Configuration for a Linear team within a Slack Asks channel mapping. Controls whether the default Asks template is enabled for the team in a given Slack channel.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct SlackAsksTeamSettings {
@@ -9091,7 +10401,7 @@ pub struct SlackChannelConnectPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The integration that was created or updated.
-    pub integration: Option<Box<Integration>>,
+    pub integration: Option<Integration>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// Whether the bot needs to be manually added to the channel.
@@ -9108,7 +10418,7 @@ impl GraphQLFields for SlackChannelConnectPayload {
             .into()
     }
 }
-/// Object for mapping Slack channel IDs to names and other settings.
+/// Configuration for a Slack channel connected to Linear via Slack Asks. Maps the Slack channel ID and name to team assignments and auto-creation settings that control how issues are created from Slack messages in this channel.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct SlackChannelNameMapping {
@@ -9123,7 +10433,7 @@ pub struct SlackChannelNameMapping {
     /// Whether or not the Linear Asks bot has been added to this Slack channel.
     pub bot_added: Option<bool>,
     /// Which teams are connected to the channel and settings for those teams.
-    pub teams: Option<Box<Vec<SlackAsksTeamSettings>>>,
+    pub teams: Option<Vec<SlackAsksTeamSettings>>,
     /// Whether or not top-level messages in this channel should automatically create Asks.
     pub auto_create_on_message: Option<bool>,
     /// Whether or not using the :ticket: emoji in this channel should automatically create Asks.
@@ -9164,6 +10474,156 @@ impl GraphQLFields for SsoUrlFromEmailResponse {
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
+pub struct Subscription {
+    /// Triggered when a comment is created
+    pub comment_created: Option<Comment>,
+    /// Triggered when a comment is updated
+    pub comment_updated: Option<Comment>,
+    /// Triggered when a comment is archived
+    pub comment_archived: Option<Comment>,
+    /// Triggered when a a comment is unarchived
+    pub comment_unarchived: Option<Comment>,
+    /// Triggered when a comment is deleted
+    pub comment_deleted: Option<Comment>,
+    /// Triggered when a cycle is created
+    pub cycle_created: Option<Cycle>,
+    /// Triggered when a cycle is updated
+    pub cycle_updated: Option<Cycle>,
+    /// Triggered when a cycle is archived
+    pub cycle_archived: Option<Cycle>,
+    /// Triggered when a document is created
+    pub document_created: Option<Document>,
+    /// Triggered when a document is updated
+    pub document_updated: Option<Document>,
+    /// Triggered when a document is archived
+    pub document_archived: Option<Document>,
+    /// Triggered when a a document is unarchived
+    pub document_unarchived: Option<Document>,
+    /// Triggered when a document content is created
+    pub document_content_created: Option<DocumentContent>,
+    /// Triggered when a document content is updated
+    pub document_content_updated: Option<DocumentContent>,
+    /// Triggered when a document content draft is created
+    pub document_content_draft_created: Option<DocumentContentDraft>,
+    /// Triggered when a document content draft is updated
+    pub document_content_draft_updated: Option<DocumentContentDraft>,
+    /// Triggered when a document content draft is deleted
+    pub document_content_draft_deleted: Option<DocumentContentDraft>,
+    /// Triggered when a draft is created
+    pub draft_created: Option<Draft>,
+    /// Triggered when a draft is updated
+    pub draft_updated: Option<Draft>,
+    /// Triggered when a draft is deleted
+    pub draft_deleted: Option<Draft>,
+    /// Triggered when a favorite is created
+    pub favorite_created: Option<Favorite>,
+    /// Triggered when a favorite is updated
+    pub favorite_updated: Option<Favorite>,
+    /// Triggered when a favorite is deleted
+    pub favorite_deleted: Option<Favorite>,
+    /// Triggered when an issue is created
+    pub issue_created: Option<Issue>,
+    /// Triggered when an issue is updated
+    pub issue_updated: Option<Issue>,
+    /// Triggered when an issue is archived
+    pub issue_archived: Option<Issue>,
+    /// Triggered when a an issue is unarchived
+    pub issue_unarchived: Option<Issue>,
+    /// Triggered when an issue history is created
+    pub issue_history_created: Option<IssueHistory>,
+    /// Triggered when an issue history is updated
+    pub issue_history_updated: Option<IssueHistory>,
+    /// Triggered when an issue draft is created
+    pub issue_draft_created: Option<IssueDraft>,
+    /// Triggered when an issue draft is updated
+    pub issue_draft_updated: Option<IssueDraft>,
+    /// Triggered when an issue draft is deleted
+    pub issue_draft_deleted: Option<IssueDraft>,
+    /// Triggered when an issue label is created
+    pub issue_label_created: Option<IssueLabel>,
+    /// Triggered when an issue label is updated
+    pub issue_label_updated: Option<IssueLabel>,
+    /// Triggered when an issue label is deleted
+    pub issue_label_deleted: Option<IssueLabel>,
+    /// Triggered when an issue relation is created
+    pub issue_relation_created: Option<IssueRelation>,
+    /// Triggered when an issue relation is updated
+    pub issue_relation_updated: Option<IssueRelation>,
+    /// Triggered when an issue relation is deleted
+    pub issue_relation_deleted: Option<IssueRelation>,
+    /// Triggered when an organization is updated
+    pub organization_updated: Option<Organization>,
+    /// Triggered when a project is created
+    pub project_created: Option<Project>,
+    /// Triggered when a project is updated
+    pub project_updated: Option<Project>,
+    /// Triggered when a project is archived
+    pub project_archived: Option<Project>,
+    /// Triggered when a a project is unarchived
+    pub project_unarchived: Option<Project>,
+    /// Triggered when a project update is created
+    pub project_update_created: Option<ProjectUpdate>,
+    /// Triggered when a project update is updated
+    pub project_update_updated: Option<ProjectUpdate>,
+    /// Triggered when a project update is deleted
+    pub project_update_deleted: Option<ProjectUpdate>,
+    /// Triggered when a roadmap is created
+    pub roadmap_created: Option<Roadmap>,
+    /// Triggered when a roadmap is updated
+    pub roadmap_updated: Option<Roadmap>,
+    /// Triggered when a roadmap is deleted
+    pub roadmap_deleted: Option<Roadmap>,
+    /// Triggered when an initiative is created
+    pub initiative_created: Option<Initiative>,
+    /// Triggered when an initiative is updated
+    pub initiative_updated: Option<Initiative>,
+    /// Triggered when an initiative is deleted
+    pub initiative_deleted: Option<Initiative>,
+    /// Triggered when an agent session is created
+    pub agent_session_created: Option<AgentSession>,
+    /// Triggered when an agent session is updated
+    pub agent_session_updated: Option<AgentSession>,
+    /// Triggered when an agent activity is created
+    pub agent_activity_created: Option<AgentActivity>,
+    /// Triggered when an agent activity is updated
+    pub agent_activity_updated: Option<AgentActivity>,
+    /// Triggered when an ai conversation is updated
+    pub ai_conversation_updated: Option<AiConversation>,
+    /// Triggered when an ai prompt progress is created
+    pub ai_prompt_progress_created: Option<AiPromptProgress>,
+    /// Triggered when an ai prompt progress is updated
+    pub ai_prompt_progress_updated: Option<AiPromptProgress>,
+    /// Triggered when a team is created
+    pub team_created: Option<Team>,
+    /// Triggered when a team is updated
+    pub team_updated: Option<Team>,
+    /// Triggered when a team is deleted
+    pub team_deleted: Option<Team>,
+    /// Triggered when a team membership is created
+    pub team_membership_created: Option<TeamMembership>,
+    /// Triggered when a team membership is updated
+    pub team_membership_updated: Option<TeamMembership>,
+    /// Triggered when a team membership is deleted
+    pub team_membership_deleted: Option<TeamMembership>,
+    /// Triggered when an user is created
+    pub user_created: Option<User>,
+    /// Triggered when an user is updated
+    pub user_updated: Option<User>,
+    /// Triggered when a workflow state is created
+    pub workflow_state_created: Option<WorkflowState>,
+    /// Triggered when a workflow state is updated
+    pub workflow_state_updated: Option<WorkflowState>,
+    /// Triggered when a workflow state is archived
+    pub workflow_state_archived: Option<WorkflowState>,
+}
+impl GraphQLFields for Subscription {
+    type FullType = Self;
+    fn selection() -> String {
+        "".into()
+    }
+}
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
 pub struct SuccessPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
@@ -9176,7 +10636,7 @@ impl GraphQLFields for SuccessPayload {
         "lastSyncId success".into()
     }
 }
-/// An AI-generated summary.
+/// An AI-generated summary of an issue. Each issue can have at most one summary. The summary content is stored as ProseMirror data and tracks its generation status and timing.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Summary {
@@ -9189,15 +10649,15 @@ pub struct Summary {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The issue this summary belongs to.
+    /// The issue that this summary was generated for.
     pub issue: Option<Box<Issue>>,
-    /// The summary content as a Prosemirror document.
+    /// The summary content as a ProseMirror document containing the AI-generated summary text.
     pub content: Option<serde_json::Value>,
-    /// The evaluation log id for this summary generation.
+    /// The evaluation log ID for this summary generation, used for tracking and debugging AI output quality. Null if not available.
     pub eval_log_id: Option<String>,
-    /// The generation status of the summary.
+    /// The current generation status of the summary, indicating whether generation is in progress, completed, or failed.
     pub generation_status: Option<SummaryGenerationStatus>,
-    /// The time at which the summary was generated.
+    /// The time at which the summary content was generated or last regenerated.
     pub generated_at: Option<chrono::DateTime<chrono::Utc>>,
 }
 impl GraphQLFields for Summary {
@@ -9206,26 +10666,27 @@ impl GraphQLFields for Summary {
         "id createdAt updatedAt archivedAt content evalLogId generationStatus generatedAt".into()
     }
 }
-/// A comment thread that is synced with an external source.
+/// A comment thread that is synced with an external source such as Slack, Jira, GitHub, Salesforce, or email. Provides information about the external thread's origin, its current sync status, and whether the user has the necessary personal integration connected to participate in the thread.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct SyncedExternalThread {
+    /// The unique identifier of this synced external thread. Auto-generated if not provided.
     pub id: Option<String>,
-    /// The type of the external source.
+    /// The category of the external source (e.g., 'integration' for service integrations, 'email' for email-based threads).
     pub r#type: Option<String>,
-    /// The sub type of the external source.
+    /// The specific integration service for the external source (e.g., 'slack', 'jira', 'github', 'salesforce'). Null if the source type does not have a sub-type.
     pub sub_type: Option<String>,
-    /// The display name of the source.
+    /// A human-readable display name for the external source (e.g., 'Slack', 'Jira', 'GitHub').
     pub name: Option<String>,
-    /// The display name of the thread.
+    /// A human-readable display name for the thread, derived from the external source. For Slack threads this is the channel name, for Jira it's the issue key, for email it's the sender name and count of other participants.
     pub display_name: Option<String>,
-    /// The external url of the thread.
+    /// A URL linking to the thread in the external service. For example, a Slack message permalink, a Jira issue URL, or a GitHub issue URL.
     pub url: Option<String>,
-    /// Whether this thread is syncing with the external service.
+    /// Whether this thread is currently syncing comments bidirectionally with the external service. False if the external entity relation has been removed or if the thread was explicitly unsynced.
     pub is_connected: Option<bool>,
-    /// Whether the current user has the corresponding personal integration connected for the external service.
+    /// Whether the current user has a working personal integration connected for the external service. For example, whether they have connected their personal Jira, GitHub, or Slack account. A connected personal integration may still return false if it has an authentication error.
     pub is_personal_integration_connected: Option<bool>,
-    /// Whether a connected personal integration is required to comment in this thread.
+    /// Whether a connected personal integration is required to post comments in this synced thread. True for Jira and GitHub threads, where comments must be attributed to a specific user in the external system. False for Slack and other services where the workspace integration can post on behalf of users.
     pub is_personal_integration_required: Option<bool>,
 }
 impl GraphQLFields for SyncedExternalThread {
@@ -9235,7 +10696,7 @@ impl GraphQLFields for SyncedExternalThread {
             .into()
     }
 }
-/// An organizational unit that contains issues.
+/// A team is the primary organizational unit in Linear. Issues belong to teams, and each team has its own workflow states, cycles, labels, and settings. Teams can be public (visible to all workspace members) or private (visible only to team members). Teams can also have sub-teams that inherit settings from their parent.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Team {
@@ -9250,7 +10711,7 @@ pub struct Team {
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The team's name.
     pub name: Option<String>,
-    /// The team's unique key. The key is used in URLs.
+    /// The team's unique key, used as a prefix in issue identifiers (e.g., 'ENG' in 'ENG-123') and in URLs.
     pub key: Option<String>,
     /// The team's description.
     pub description: Option<String>,
@@ -9258,19 +10719,19 @@ pub struct Team {
     pub icon: Option<String>,
     /// The team's color.
     pub color: Option<String>,
-    /// The time at which the team was retired. Null if the team has not been retired.
+    /// The time at which the team was retired. Retired teams no longer accept new issues or members. Null if the team has not been retired.
     pub retired_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The organization that the team is associated with.
+    /// The workspace that the team belongs to.
     pub organization: Option<Box<Organization>>,
-    /// `Internal` The team's parent team.
+    /// The team's parent team.
     pub parent: Option<Box<Team>>,
     /// `Internal` The team's sub-teams.
-    pub children: Option<Box<Vec<Team>>>,
-    /// Whether the team uses cycles.
+    pub children: Option<Vec<Team>>,
+    /// Whether the team uses cycles for sprint-style issue management.
     pub cycles_enabled: Option<bool>,
-    /// The day of the week that a new cycle starts.
+    /// The day of the week that a new cycle starts (0 = Sunday, 1 = Monday, ..., 6 = Saturday).
     pub cycle_start_day: Option<f64>,
-    /// The duration of a cycle in weeks.
+    /// The duration of each cycle in weeks.
     pub cycle_duration: Option<f64>,
     /// The cooldown time after each cycle in weeks.
     pub cycle_cooldown_time: Option<f64>,
@@ -9300,7 +10761,7 @@ pub struct Team {
     pub issue_estimation_extended: Option<bool>,
     /// What to use as a default estimate for unestimated issues.
     pub default_issue_estimate: Option<f64>,
-    /// Whether triage mode is enabled for the team or not.
+    /// Whether triage mode is enabled for the team. When enabled, issues created by non-members or integrations are routed to a triage state for review before entering the normal workflow.
     pub triage_enabled: Option<bool>,
     /// Whether an issue needs to have a priority set before leaving triage.
     pub require_priority_to_leave_triage: Option<bool>,
@@ -9318,17 +10779,17 @@ pub struct Team {
     pub default_project_template: Option<Box<Template>>,
     /// The workflow state into which issues are set when they are opened by non-team members or integrations if triage is enabled.
     pub triage_issue_state: Option<Box<WorkflowState>>,
-    /// Whether the team is private or not.
+    /// Whether the team is private. Private teams are only visible to their members and require an explicit invitation to join.
     pub private: Option<bool>,
     /// Whether all members in the workspace can join the team. Only used for public teams.
     pub all_members_can_join: Option<bool>,
-    /// Security settings for the team.
+    /// Security settings for the team, including role-based restrictions for issue sharing, label management, member management, and template management.
     pub security_settings: Option<serde_json::Value>,
     /// `Internal` Facets associated with the team.
-    pub facets: Option<Box<Vec<Facet>>>,
+    pub facets: Option<Vec<Facet>>,
     /// `Internal` Posts associated with the team.
-    pub posts: Option<Box<Vec<Post>>>,
-    /// Whether the team is managed by SCIM integration.
+    pub posts: Option<Vec<Post>>,
+    /// Whether the team is managed by a SCIM integration. SCIM-managed teams have their membership controlled by the identity provider.
     pub scim_managed: Option<bool>,
     /// The SCIM group name for the team.
     pub scim_group_name: Option<String>,
@@ -9362,7 +10823,7 @@ pub struct Team {
     pub auto_close_period: Option<f64>,
     /// The canceled workflow state which auto closed issues will be set to. Defaults to the first canceled state.
     pub auto_close_state_id: Option<String>,
-    /// Period after which automatically closed and completed issues are automatically archived in months.
+    /// Period after which automatically closed, completed, and duplicate issues are automatically archived in months.
     pub auto_archive_period: Option<f64>,
     /// Whether parent issues should automatically close when all child issues are closed
     pub auto_close_parent_issues: Option<bool>,
@@ -9372,38 +10833,46 @@ pub struct Team {
     pub marked_as_duplicate_workflow_state: Option<Box<WorkflowState>>,
     /// `Internal` Whether new users should join this team by default.
     pub join_by_default: Option<bool>,
+    /// `Internal` Whether the team should inherit its Slack auto-create project channel setting from its parent. Only applies to sub-teams.
+    pub inherit_slack_auto_create_project_channel: Option<bool>,
+    /// `Internal` Whether to automatically create a Slack channel when a new project is created in this team.
+    pub slack_auto_create_project_channel: Option<bool>,
     /// Calendar feed URL (iCal) for cycles.
     pub cycle_calender_url: Option<String>,
     /// The name of the team including its parent team name if it has one.
     pub display_name: Option<String>,
-    /// Issues associated with the team.
-    pub issues: Option<Box<IssueConnection>>,
-    /// Number of issues in the team.
+    /// `Internal` The team's ancestor teams, ordered from the root to the immediate parent.
+    pub ancestors: Option<Vec<Team>>,
+    /// Issues belonging to the team. Supports filtering and optional inclusion of sub-team issues.
+    pub issues: Option<IssueConnection>,
+    /// The total number of issues in the team. By default excludes archived issues; use the includeArchived argument to include them.
     pub issue_count: Option<i64>,
     /// Cycles associated with the team.
-    pub cycles: Option<Box<CycleConnection>>,
+    pub cycles: Option<CycleConnection>,
     /// Team's currently active cycle.
     pub active_cycle: Option<Box<Cycle>>,
     /// Team's triage responsibility.
     pub triage_responsibility: Option<Box<TriageResponsibility>>,
-    /// Users who are members of this team.
-    pub members: Option<Box<UserConnection>>,
+    /// Users who are members of this team. Supports filtering and pagination.
+    pub members: Option<UserConnection>,
     /// `ALPHA` The membership of the given user in the team.
     pub membership: Option<Box<TeamMembership>>,
     /// Memberships associated with the team. For easier access of the same data, use `members` query.
-    pub memberships: Option<Box<TeamMembershipConnection>>,
+    pub memberships: Option<TeamMembershipConnection>,
     /// Projects associated with the team.
-    pub projects: Option<Box<ProjectConnection>>,
+    pub projects: Option<ProjectConnection>,
+    /// `ALPHA` Release pipelines associated with the team.
+    pub release_pipelines: Option<ReleasePipelineConnection>,
     /// The states that define the workflow associated with the team.
-    pub states: Option<Box<WorkflowStateConnection>>,
+    pub states: Option<WorkflowStateConnection>,
     /// The Git automation states for the team.
-    pub git_automation_states: Option<Box<GitAutomationStateConnection>>,
+    pub git_automation_states: Option<GitAutomationStateConnection>,
     /// Templates associated with the team.
-    pub templates: Option<Box<TemplateConnection>>,
+    pub templates: Option<TemplateConnection>,
     /// Labels associated with the team.
-    pub labels: Option<Box<IssueLabelConnection>>,
+    pub labels: Option<IssueLabelConnection>,
     /// Webhooks associated with the team.
-    pub webhooks: Option<Box<WebhookConnection>>,
+    pub webhooks: Option<WebhookConnection>,
     /// Settings for all integrations associated with that team.
     pub integrations_settings: Option<Box<IntegrationsSettings>>,
     /// `DEPRECATED` Whether to move issues to bottom of the column when changing state.
@@ -9414,7 +10883,7 @@ pub struct Team {
 impl GraphQLFields for Team {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt name key description icon color retiredAt cyclesEnabled cycleStartDay cycleDuration cycleCooldownTime cycleIssueAutoAssignStarted cycleIssueAutoAssignCompleted cycleLockToActive upcomingCycleCount timezone inheritWorkflowStatuses inheritIssueEstimation issueEstimationType issueOrderingNoPriorityFirst issueEstimationAllowZero setIssueSortOrderOnStateChange issueEstimationExtended defaultIssueEstimate triageEnabled requirePriorityToLeaveTriage defaultTemplateForMembersId defaultTemplateForNonMembersId private allMembersCanJoin securitySettings scimManaged scimGroupName progressHistory currentProgress groupIssueHistory aiThreadSummariesEnabled aiDiscussionSummariesEnabled slackNewIssue slackIssueComments slackIssueStatuses autoClosePeriod autoCloseStateId autoArchivePeriod autoCloseParentIssues autoCloseChildIssues joinByDefault cycleCalenderUrl displayName issueCount issueSortOrderDefaultToBottom inviteHash"
+        "id createdAt updatedAt archivedAt name key description icon color retiredAt cyclesEnabled cycleStartDay cycleDuration cycleCooldownTime cycleIssueAutoAssignStarted cycleIssueAutoAssignCompleted cycleLockToActive upcomingCycleCount timezone inheritWorkflowStatuses inheritIssueEstimation issueEstimationType issueOrderingNoPriorityFirst issueEstimationAllowZero setIssueSortOrderOnStateChange issueEstimationExtended defaultIssueEstimate triageEnabled requirePriorityToLeaveTriage defaultTemplateForMembersId defaultTemplateForNonMembersId private allMembersCanJoin securitySettings scimManaged scimGroupName progressHistory currentProgress groupIssueHistory aiThreadSummariesEnabled aiDiscussionSummariesEnabled slackNewIssue slackIssueComments slackIssueStatuses autoClosePeriod autoCloseStateId autoArchivePeriod autoCloseParentIssues autoCloseChildIssues joinByDefault inheritSlackAutoCreateProjectChannel slackAutoCreateProjectChannel cycleCalenderUrl displayName issueCount issueSortOrderDefaultToBottom inviteHash"
             .into()
     }
 }
@@ -9427,7 +10896,7 @@ pub struct TeamArchivePayload {
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The archived/unarchived entity. Null if entity was deleted.
-    pub entity: Option<Box<Team>>,
+    pub entity: Option<Team>,
 }
 impl GraphQLFields for TeamArchivePayload {
     type FullType = Self;
@@ -9438,9 +10907,9 @@ impl GraphQLFields for TeamArchivePayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TeamConnection {
-    pub edges: Option<Box<Vec<TeamEdge>>>,
-    pub nodes: Option<Box<Vec<Team>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<TeamEdge>>,
+    pub nodes: Option<Vec<Team>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for TeamConnection {
     type FullType = Self;
@@ -9451,7 +10920,7 @@ impl GraphQLFields for TeamConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TeamEdge {
-    pub node: Option<Box<Team>>,
+    pub node: Option<Team>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -9461,7 +10930,7 @@ impl GraphQLFields for TeamEdge {
         "cursor".into()
     }
 }
-/// Defines the membership of a user to a team.
+/// A join entity that defines a user's membership in a team. Each membership record links a user to a team and tracks whether the user is a team owner. Users can be members of multiple teams, and their memberships determine which teams' issues and resources they can access.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TeamMembership {
@@ -9478,9 +10947,9 @@ pub struct TeamMembership {
     pub user: Option<Box<User>>,
     /// The team that the membership is associated with.
     pub team: Option<Box<Team>>,
-    /// Whether the user is an owner of the team.
+    /// Whether the user is an owner of the team. Team owners have elevated permissions for managing team settings, members, and resources.
     pub owner: Option<bool>,
-    /// The order of the item in the users team list.
+    /// The sort order of this team in the user's personal team list. Lower values appear first.
     pub sort_order: Option<f64>,
 }
 impl GraphQLFields for TeamMembership {
@@ -9492,9 +10961,9 @@ impl GraphQLFields for TeamMembership {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TeamMembershipConnection {
-    pub edges: Option<Box<Vec<TeamMembershipEdge>>>,
-    pub nodes: Option<Box<Vec<TeamMembership>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<TeamMembershipEdge>>,
+    pub nodes: Option<Vec<TeamMembership>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for TeamMembershipConnection {
     type FullType = Self;
@@ -9505,7 +10974,7 @@ impl GraphQLFields for TeamMembershipConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TeamMembershipEdge {
-    pub node: Option<Box<TeamMembership>>,
+    pub node: Option<TeamMembership>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -9515,13 +10984,14 @@ impl GraphQLFields for TeamMembershipEdge {
         "cursor".into()
     }
 }
+/// Team membership operation response.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TeamMembershipPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The team membership that was created or updated.
-    pub team_membership: Option<Box<TeamMembership>>,
+    pub team_membership: Option<TeamMembership>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -9531,7 +11001,7 @@ impl GraphQLFields for TeamMembershipPayload {
         "lastSyncId success".into()
     }
 }
-/// A team notification subscription.
+/// A notification subscription scoped to a specific team. The subscriber receives notifications for events related to issues and activity in this team.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TeamNotificationSubscription {
@@ -9544,31 +11014,31 @@ pub struct TeamNotificationSubscription {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The user that subscribed to receive notifications.
-    pub subscriber: Option<Box<User>>,
-    /// The customer associated with the notification subscription.
-    pub customer: Option<Box<Customer>>,
-    /// The contextual custom view associated with the notification subscription.
-    pub custom_view: Option<Box<CustomView>>,
-    /// The contextual cycle view associated with the notification subscription.
-    pub cycle: Option<Box<Cycle>>,
-    /// The contextual label view associated with the notification subscription.
-    pub label: Option<Box<IssueLabel>>,
-    /// The contextual project view associated with the notification subscription.
-    pub project: Option<Box<Project>>,
-    /// The contextual initiative view associated with the notification subscription.
-    pub initiative: Option<Box<Initiative>>,
+    /// The user who will receive notifications from this subscription.
+    pub subscriber: Option<User>,
+    /// The customer that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub customer: Option<Customer>,
+    /// The custom view that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub custom_view: Option<CustomView>,
+    /// The cycle that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub cycle: Option<Cycle>,
+    /// The issue label that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub label: Option<IssueLabel>,
+    /// The project that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub project: Option<Project>,
+    /// The initiative that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub initiative: Option<Initiative>,
     /// The team subscribed to.
-    pub team: Option<Box<Team>>,
-    /// The user view associated with the notification subscription.
-    pub user: Option<Box<User>>,
-    /// The type of view to which the notification subscription context is associated with.
+    pub team: Option<Team>,
+    /// The user that this notification subscription is scoped to, for user-specific view subscriptions. Null if the subscription targets a different entity type.
+    pub user: Option<User>,
+    /// The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type.
     pub context_view_type: Option<ContextViewType>,
-    /// The type of user view to which the notification subscription context is associated with.
+    /// The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type.
     pub user_context_view_type: Option<UserContextViewType>,
-    /// Whether the subscription is active or not.
+    /// Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists.
     pub active: Option<bool>,
-    /// The type of subscription.
+    /// The notification event types that this subscription will deliver to the subscriber.
     pub notification_subscription_types: Option<Vec<String>>,
 }
 impl GraphQLFields for TeamNotificationSubscription {
@@ -9578,13 +11048,14 @@ impl GraphQLFields for TeamNotificationSubscription {
             .into()
     }
 }
+/// Team operation response.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TeamPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The team that was created or updated.
-    pub team: Option<Box<Team>>,
+    pub team: Option<Team>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -9594,7 +11065,7 @@ impl GraphQLFields for TeamPayload {
         "lastSyncId success".into()
     }
 }
-/// A template object used for creating entities faster.
+/// A reusable template for creating issues, projects, or documents. Templates store pre-filled field values and content as JSON data. They can be scoped to a specific team or shared across the entire workspace. Team-scoped templates may be inherited from parent teams.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Template {
@@ -9607,27 +11078,31 @@ pub struct Template {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The entity type this template is for.
+    /// The entity type this template is for, such as 'issue', 'project', or 'document'.
     pub r#type: Option<String>,
     /// The name of the template.
     pub name: Option<String>,
-    /// Template description.
+    /// A description of what the template is used for.
     pub description: Option<String>,
-    /// Template data.
+    /// The icon of the template, either a decorative icon type or an emoji string. Null if no icon has been set.
+    pub icon: Option<String>,
+    /// The hex color of the template icon. Null if no custom color has been set.
+    pub color: Option<String>,
+    /// The template data as a JSON-encoded string containing the pre-filled attributes for the entity type (e.g., issue fields, project configuration, or document content).
     pub template_data: Option<serde_json::Value>,
-    /// The sort order of the template.
+    /// The sort order of the template within the templates list.
     pub sort_order: Option<f64>,
-    /// The date when the template was last applied.
+    /// The date when the template was last applied to create or update an entity. Null if the template has never been applied.
     pub last_applied_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The organization that the template is associated with. If null, the template is associated with a particular team.
+    /// The workspace that owns this template.
     pub organization: Option<Box<Organization>>,
     /// The team that the template is associated with. If null, the template is global to the workspace.
     pub team: Option<Box<Team>>,
-    /// The user who created the template.
+    /// The user who created the template. Null if the creator's account has been deleted.
     pub creator: Option<Box<User>>,
-    /// The user who last updated the template.
+    /// The user who last updated the template. Null if the user's account has been deleted.
     pub last_updated_by: Option<Box<User>>,
-    /// The original template inherited from.
+    /// The parent team template this template was inherited from. Null for original (non-inherited) templates.
     pub inherited_from: Option<Box<Template>>,
     /// `Internal` Whether the template has form fields
     pub has_form_fields: Option<bool>,
@@ -9635,16 +11110,16 @@ pub struct Template {
 impl GraphQLFields for Template {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt type name description templateData sortOrder lastAppliedAt hasFormFields"
+        "id createdAt updatedAt archivedAt type name description icon color templateData sortOrder lastAppliedAt hasFormFields"
             .into()
     }
 }
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TemplateConnection {
-    pub edges: Option<Box<Vec<TemplateEdge>>>,
-    pub nodes: Option<Box<Vec<Template>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<TemplateEdge>>,
+    pub nodes: Option<Vec<Template>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for TemplateConnection {
     type FullType = Self;
@@ -9655,7 +11130,7 @@ impl GraphQLFields for TemplateConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TemplateEdge {
-    pub node: Option<Box<Template>>,
+    pub node: Option<Template>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -9665,13 +11140,14 @@ impl GraphQLFields for TemplateEdge {
         "cursor".into()
     }
 }
+/// The result of a template mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TemplatePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The template that was created or updated.
-    pub template: Option<Box<Template>>,
+    pub template: Option<Template>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -9681,7 +11157,7 @@ impl GraphQLFields for TemplatePayload {
         "lastSyncId success".into()
     }
 }
-/// A time schedule.
+/// A time-based schedule defining on-call rotations or availability windows. Schedules contain a series of time entries, each specifying a user and their active period. They can be synced from external services (such as PagerDuty or Opsgenie) via integrations, or created manually. Schedules are used by triage responsibilities to determine who should be assigned or notified when issues enter triage.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TimeSchedule {
@@ -9697,12 +11173,12 @@ pub struct TimeSchedule {
     /// The name of the schedule.
     pub name: Option<String>,
     /// The schedule entries.
-    pub entries: Option<Box<Vec<TimeScheduleEntry>>>,
+    pub entries: Option<Vec<TimeScheduleEntry>>,
     /// The identifier of the external schedule.
     pub external_id: Option<String>,
     /// The URL to the external schedule.
     pub external_url: Option<String>,
-    /// The organization of the schedule.
+    /// The workspace of the schedule.
     pub organization: Option<Box<Organization>>,
     /// The identifier of the Linear integration populating the schedule.
     pub integration: Option<Box<Integration>>,
@@ -9716,9 +11192,9 @@ impl GraphQLFields for TimeSchedule {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TimeScheduleConnection {
-    pub edges: Option<Box<Vec<TimeScheduleEdge>>>,
-    pub nodes: Option<Box<Vec<TimeSchedule>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<TimeScheduleEdge>>,
+    pub nodes: Option<Vec<TimeSchedule>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for TimeScheduleConnection {
     type FullType = Self;
@@ -9729,7 +11205,7 @@ impl GraphQLFields for TimeScheduleConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TimeScheduleEdge {
-    pub node: Option<Box<TimeSchedule>>,
+    pub node: Option<TimeSchedule>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -9739,12 +11215,13 @@ impl GraphQLFields for TimeScheduleEdge {
         "cursor".into()
     }
 }
+/// A single entry in a time schedule, defining a time range and the user responsible during that period.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TimeScheduleEntry {
-    /// The start date of the schedule in ISO 8601 date-time format.
+    /// The start time of the schedule entry in ISO 8601 date-time format.
     pub starts_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The end date of the schedule in ISO 8601 date-time format.
+    /// The end time of the schedule entry in ISO 8601 date-time format.
     pub ends_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The Linear user id of the user on schedule. If the user cannot be mapped to a Linear user then `userEmail` can be used as a reference.
     pub user_id: Option<String>,
@@ -9757,12 +11234,14 @@ impl GraphQLFields for TimeScheduleEntry {
         "startsAt endsAt userId userEmail".into()
     }
 }
+/// The result of a time schedule mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TimeSchedulePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    pub time_schedule: Option<Box<TimeSchedule>>,
+    /// The time schedule that was created or updated.
+    pub time_schedule: Option<TimeSchedule>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -9772,7 +11251,7 @@ impl GraphQLFields for TimeSchedulePayload {
         "lastSyncId success".into()
     }
 }
-/// A team's triage responsibility.
+/// A team's triage responsibility configuration that defines how issues entering triage are handled. Each team can have one triage responsibility, which specifies the action to take (notify or assign) and the responsible users, determined either by a manual selection of specific users or by an on-call time schedule.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TriageResponsibility {
@@ -9788,7 +11267,7 @@ pub struct TriageResponsibility {
     /// The action to take when an issue is added to triage.
     pub action: Option<TriageResponsibilityAction>,
     /// Set of users used for triage responsibility.
-    pub manual_selection: Option<Box<TriageResponsibilityManualSelection>>,
+    pub manual_selection: Option<TriageResponsibilityManualSelection>,
     /// The team to which the triage responsibility belongs to.
     pub team: Option<Box<Team>>,
     /// The time schedule used for scheduling.
@@ -9805,9 +11284,9 @@ impl GraphQLFields for TriageResponsibility {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TriageResponsibilityConnection {
-    pub edges: Option<Box<Vec<TriageResponsibilityEdge>>>,
-    pub nodes: Option<Box<Vec<TriageResponsibility>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<TriageResponsibilityEdge>>,
+    pub nodes: Option<Vec<TriageResponsibility>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for TriageResponsibilityConnection {
     type FullType = Self;
@@ -9818,7 +11297,7 @@ impl GraphQLFields for TriageResponsibilityConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TriageResponsibilityEdge {
-    pub node: Option<Box<TriageResponsibility>>,
+    pub node: Option<TriageResponsibility>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -9828,6 +11307,7 @@ impl GraphQLFields for TriageResponsibilityEdge {
         "cursor".into()
     }
 }
+/// Manual triage responsibility configuration specifying a set of users to assign triaged issues to, with optional round-robin rotation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TriageResponsibilityManualSelection {
@@ -9842,12 +11322,14 @@ impl GraphQLFields for TriageResponsibilityManualSelection {
         "userIds assignmentIndex".into()
     }
 }
+/// The result of a triage responsibility mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct TriageResponsibilityPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    pub triage_responsibility: Option<Box<TriageResponsibility>>,
+    /// The triage responsibility that was created or updated.
+    pub triage_responsibility: Option<TriageResponsibility>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -9857,7 +11339,7 @@ impl GraphQLFields for TriageResponsibilityPayload {
         "lastSyncId success".into()
     }
 }
-/// Object representing Google Cloud upload policy, plus additional data.
+/// Represents a file upload destination with a pre-signed upload URL, asset URL, and required request headers for uploading to cloud storage.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct UploadFile {
@@ -9867,12 +11349,14 @@ pub struct UploadFile {
     pub content_type: Option<String>,
     /// The size of the uploaded file.
     pub size: Option<i64>,
-    /// The signed URL the for the uploaded file. (assigned automatically).
+    /// The pre-signed URL to which the file should be uploaded via a PUT request.
     pub upload_url: Option<String>,
-    /// The asset URL for the uploaded file. (assigned automatically).
+    /// The permanent asset URL where the file will be accessible after upload.
     pub asset_url: Option<String>,
+    /// Optional metadata associated with the upload, such as the related issue or comment ID.
     pub meta_data: Option<serde_json::Value>,
-    pub headers: Option<Box<Vec<UploadFileHeader>>>,
+    /// HTTP headers that must be included in the PUT request to the upload URL.
+    pub headers: Option<Vec<UploadFileHeader>>,
 }
 impl GraphQLFields for UploadFile {
     type FullType = Self;
@@ -9899,8 +11383,8 @@ impl GraphQLFields for UploadFileHeader {
 pub struct UploadPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
-    /// Object describing the file to be uploaded.
-    pub upload_file: Option<Box<UploadFile>>,
+    /// The upload file details including signed URL, asset URL, and required headers. Null if the upload could not be prepared.
+    pub upload_file: Option<UploadFile>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -9910,7 +11394,7 @@ impl GraphQLFields for UploadPayload {
         "lastSyncId success".into()
     }
 }
-/// A user that has access to the the resources of an organization.
+/// A user that belongs to a workspace. Users can have different roles (admin, member, guest, or app) that determine their level of access. Users can be members of multiple teams, and can be active or deactivated. Guest users have limited access scoped to specific teams they are invited to.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct User {
@@ -9925,32 +11409,34 @@ pub struct User {
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The user's full name.
     pub name: Option<String>,
-    /// The user's display (nick) name. Unique within each organization.
+    /// The user's display (nick) name. Must be unique within the workspace.
     pub display_name: Option<String>,
     /// The user's email address.
     pub email: Option<String>,
     /// An URL to the user's avatar image.
     pub avatar_url: Option<String>,
-    /// Reason why is the account disabled.
+    /// The reason why the user account is disabled. Null if the user is active. Possible values include admin suspension, downgrade, voluntary departure, or pending invite.
     pub disable_reason: Option<String>,
     /// `DEPRECATED` Hash for the user to be used in calendar URLs.
     pub calendar_hash: Option<String>,
-    /// A short description of the user, either its title or bio.
+    /// A short description of the user, such as their title or a brief bio.
     pub description: Option<String>,
-    /// The emoji to represent the user current status.
+    /// The user's job title.
+    pub title: Option<String>,
+    /// The emoji representing the user's current status. Null if no status is set.
     pub status_emoji: Option<String>,
-    /// The label of the user current status.
+    /// The text label of the user's current status. Null if no status is set.
     pub status_label: Option<String>,
-    /// A date at which the user current status should be cleared.
+    /// The date and time at which the user's current status should be automatically cleared. Null if the status has no expiration.
     pub status_until_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The local timezone of the user.
     pub timezone: Option<String>,
-    /// Organization the user belongs to.
+    /// The workspace that the user belongs to.
     pub organization: Option<Box<Organization>>,
-    /// The last time the user was seen online.
+    /// The last time the user was seen online. Updated based on user activity. Null if the user has never been seen.
     pub last_seen: Option<chrono::DateTime<chrono::Utc>>,
     /// `INTERNAL` Identity provider the user is managed by.
-    pub identity_provider: Option<Box<IdentityProvider>>,
+    pub identity_provider: Option<IdentityProvider>,
     /// The initials of the user.
     pub initials: Option<String>,
     /// The background color of the avatar for users without set avatar.
@@ -9961,40 +11447,38 @@ pub struct User {
     pub app: Option<bool>,
     /// Whether the user is mentionable.
     pub is_mentionable: Option<bool>,
-    /// Whether the user is assignable.
-    pub is_assignable: Option<bool>,
     /// Whether the user account is active or disabled (suspended).
     pub active: Option<bool>,
-    /// Enabled feature flags for the user.
-    pub feature_flags: Option<Vec<String>>,
-    /// The user's issue drafts
-    pub issue_drafts: Option<Box<IssueDraftConnection>>,
-    /// The user's drafts
-    pub drafts: Option<Box<DraftConnection>>,
+    /// Issue drafts that the user has created but not yet submitted.
+    pub issue_drafts: Option<IssueDraftConnection>,
+    /// The user's saved drafts.
+    pub drafts: Option<DraftConnection>,
     /// User's profile URL.
     pub url: Option<String>,
     /// Issues assigned to the user.
-    pub assigned_issues: Option<Box<IssueConnection>>,
+    pub assigned_issues: Option<IssueConnection>,
     /// Issues delegated to this user.
-    pub delegated_issues: Option<Box<IssueConnection>>,
+    pub delegated_issues: Option<IssueConnection>,
     /// Issues created by the user.
-    pub created_issues: Option<Box<IssueConnection>>,
+    pub created_issues: Option<IssueConnection>,
     /// Number of issues created.
     pub created_issue_count: Option<i64>,
-    /// Teams the user is part of.
-    pub teams: Option<Box<TeamConnection>>,
+    /// Teams the user is a member of. Supports filtering by team properties.
+    pub teams: Option<TeamConnection>,
     /// Memberships associated with the user. For easier access of the same data, use `teams` query.
-    pub team_memberships: Option<Box<TeamMembershipConnection>>,
+    pub team_memberships: Option<TeamMembershipConnection>,
     /// `INTERNAL` The user's pinned feeds.
-    pub feed_facets: Option<Box<FacetConnection>>,
-    /// Whether this user can access any public team in the organization.
+    pub feed_facets: Option<FacetConnection>,
+    /// Whether this user can access any public team in the workspace. True for non-guest members and app users with public team access.
     pub can_access_any_public_team: Option<bool>,
     /// Whether the user is the currently authenticated user.
     pub is_me: Option<bool>,
-    /// Whether the user is an organization administrator.
+    /// Whether the user is a workspace administrator. On Free plans, all members are treated as admins.
     pub admin: Option<bool>,
-    /// Whether the user is an organization owner.
+    /// Whether the user is a workspace owner, which is the highest permission level.
     pub owner: Option<bool>,
+    /// Whether the user can be assigned to issues. Regular users are always assignable; app users are assignable only if they have the app:assignable scope.
+    pub is_assignable: Option<bool>,
     /// Whether this agent user supports agent sessions.
     pub supports_agent_sessions: Option<bool>,
     /// `DEPRECATED` Unique hash for the user to be used in invite URLs.
@@ -10005,10 +11489,11 @@ pub struct User {
 impl GraphQLFields for User {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt name displayName email avatarUrl disableReason calendarHash description statusEmoji statusLabel statusUntilAt timezone lastSeen initials avatarBackgroundColor guest app isMentionable isAssignable active url createdIssueCount canAccessAnyPublicTeam isMe admin owner supportsAgentSessions inviteHash gitHubUserId"
+        "id createdAt updatedAt archivedAt name displayName email avatarUrl disableReason calendarHash description title statusEmoji statusLabel statusUntilAt timezone lastSeen initials avatarBackgroundColor guest app isMentionable active url createdIssueCount canAccessAnyPublicTeam isMe admin owner isAssignable supportsAgentSessions inviteHash gitHubUserId"
             .into()
     }
 }
+/// User admin operation response.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct UserAdminPayload {
@@ -10024,9 +11509,9 @@ impl GraphQLFields for UserAdminPayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct UserConnection {
-    pub edges: Option<Box<Vec<UserEdge>>>,
-    pub nodes: Option<Box<Vec<User>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<UserEdge>>,
+    pub nodes: Option<Vec<User>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for UserConnection {
     type FullType = Self;
@@ -10037,7 +11522,7 @@ impl GraphQLFields for UserConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct UserEdge {
-    pub node: Option<Box<User>>,
+    pub node: Option<User>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -10047,7 +11532,7 @@ impl GraphQLFields for UserEdge {
         "cursor".into()
     }
 }
-/// A user notification subscription.
+/// A notification subscription scoped to a specific user view. The subscriber receives notifications for events in the context of a particular user's activity view.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct UserNotificationSubscription {
@@ -10060,31 +11545,31 @@ pub struct UserNotificationSubscription {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The user that subscribed to receive notifications.
-    pub subscriber: Option<Box<User>>,
-    /// The customer associated with the notification subscription.
-    pub customer: Option<Box<Customer>>,
-    /// The contextual custom view associated with the notification subscription.
-    pub custom_view: Option<Box<CustomView>>,
-    /// The contextual cycle view associated with the notification subscription.
-    pub cycle: Option<Box<Cycle>>,
-    /// The contextual label view associated with the notification subscription.
-    pub label: Option<Box<IssueLabel>>,
-    /// The contextual project view associated with the notification subscription.
-    pub project: Option<Box<Project>>,
-    /// The contextual initiative view associated with the notification subscription.
-    pub initiative: Option<Box<Initiative>>,
-    /// The team associated with the notification subscription.
-    pub team: Option<Box<Team>>,
+    /// The user who will receive notifications from this subscription.
+    pub subscriber: Option<User>,
+    /// The customer that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub customer: Option<Customer>,
+    /// The custom view that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub custom_view: Option<CustomView>,
+    /// The cycle that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub cycle: Option<Cycle>,
+    /// The issue label that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub label: Option<IssueLabel>,
+    /// The project that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub project: Option<Project>,
+    /// The initiative that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub initiative: Option<Initiative>,
+    /// The team that this notification subscription is scoped to. Null if the subscription targets a different entity type.
+    pub team: Option<Team>,
     /// The user subscribed to.
-    pub user: Option<Box<User>>,
-    /// The type of view to which the notification subscription context is associated with.
+    pub user: Option<User>,
+    /// The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type.
     pub context_view_type: Option<ContextViewType>,
-    /// The type of user view to which the notification subscription context is associated with.
+    /// The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type.
     pub user_context_view_type: Option<UserContextViewType>,
-    /// Whether the subscription is active or not.
+    /// Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists.
     pub active: Option<bool>,
-    /// The type of subscription.
+    /// The notification event types that this subscription will deliver to the subscriber.
     pub notification_subscription_types: Option<Vec<String>>,
 }
 impl GraphQLFields for UserNotificationSubscription {
@@ -10094,13 +11579,14 @@ impl GraphQLFields for UserNotificationSubscription {
             .into()
     }
 }
+/// User operation response.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct UserPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The user that was created or updated.
-    pub user: Option<Box<User>>,
+    pub user: Option<User>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -10110,7 +11596,7 @@ impl GraphQLFields for UserPayload {
         "lastSyncId success".into()
     }
 }
-/// The settings of a user as a JSON object.
+/// Per-user settings and preferences for a workspace member. Includes notification delivery preferences, email subscription settings, notification category and channel preferences, theme configuration, and various UI preferences. Each user has exactly one UserSettings record per workspace.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct UserSettings {
@@ -10124,22 +11610,22 @@ pub struct UserSettings {
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The notification delivery preferences for the user. Note: notificationDisabled field is deprecated in favor of notificationChannelPreferences.
-    pub notification_delivery_preferences: Option<Box<NotificationDeliveryPreferences>>,
+    pub notification_delivery_preferences: Option<NotificationDeliveryPreferences>,
     /// The email types the user has unsubscribed from.
     pub unsubscribed_from: Option<Vec<String>>,
-    /// The user associated with these settings.
-    pub user: Option<Box<User>>,
-    /// Hash for the user to be used in calendar URLs.
+    /// The user that these settings belong to.
+    pub user: Option<User>,
+    /// A unique hash for the user, used to construct secure calendar subscription URLs.
     pub calendar_hash: Option<String>,
-    /// Whether this user is subscribed to changelog email or not.
+    /// Whether this user is subscribed to receive changelog emails about Linear product updates.
     pub subscribed_to_changelog: Option<bool>,
-    /// Whether this user is subscribed to DPA emails or not.
+    /// Whether this user is subscribed to receive Data Processing Agreement (DPA) related emails.
     pub subscribed_to_dpa: Option<bool>,
-    /// Whether this user is subscribed to invite accepted emails or not.
+    /// Whether this user is subscribed to receive email notifications when their workspace invitations are accepted.
     pub subscribed_to_invite_accepted: Option<bool>,
-    /// Whether this user is subscribed to privacy and legal update emails or not.
+    /// Whether this user is subscribed to receive emails about privacy policy and legal updates.
     pub subscribed_to_privacy_legal_updates: Option<bool>,
-    /// The user's feed summary schedule preference.
+    /// The user's preferred schedule for receiving feed summary digests. Null if the user has not set a preference and will use the workspace default.
     pub feed_summary_schedule: Option<FeedSummarySchedule>,
     /// Whether to show full user names instead of display names.
     pub show_full_user_names: Option<bool>,
@@ -10147,12 +11633,12 @@ pub struct UserSettings {
     pub feed_last_seen_time: Option<chrono::DateTime<chrono::Utc>>,
     /// Whether to auto-assign newly created issues to the current user by default.
     pub auto_assign_to_self: Option<bool>,
-    /// The user's notification category preferences.
-    pub notification_category_preferences: Option<Box<NotificationCategoryPreferences>>,
-    /// The user's notification channel preferences.
-    pub notification_channel_preferences: Option<Box<NotificationChannelPreferences>>,
-    /// The user's theme for a given mode and device type.
-    pub theme: Option<Box<UserSettingsTheme>>,
+    /// The user's notification category preferences, indicating which notification categories are enabled or disabled per notification channel.
+    pub notification_category_preferences: Option<NotificationCategoryPreferences>,
+    /// The user's notification channel preferences, indicating which notification delivery channels (email, in-app, mobile push, Slack) are enabled.
+    pub notification_channel_preferences: Option<NotificationChannelPreferences>,
+    /// The user's theme configuration for the specified color mode (light/dark) and device type (desktop/mobile). Returns null if no valid theme preset is configured.
+    pub theme: Option<UserSettingsTheme>,
 }
 impl GraphQLFields for UserSettings {
     type FullType = Self;
@@ -10161,6 +11647,7 @@ impl GraphQLFields for UserSettings {
             .into()
     }
 }
+/// Custom sidebar theme definition with accent, base colors and contrast.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct UserSettingsCustomSidebarTheme {
@@ -10177,6 +11664,7 @@ impl GraphQLFields for UserSettingsCustomSidebarTheme {
         "accent base contrast".into()
     }
 }
+/// Custom theme definition with accent, base colors, contrast, and optional sidebar theme.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct UserSettingsCustomTheme {
@@ -10187,7 +11675,7 @@ pub struct UserSettingsCustomTheme {
     /// The contrast value.
     pub contrast: Option<i64>,
     /// Optional sidebar theme colors.
-    pub sidebar: Option<Box<UserSettingsCustomSidebarTheme>>,
+    pub sidebar: Option<UserSettingsCustomSidebarTheme>,
 }
 impl GraphQLFields for UserSettingsCustomTheme {
     type FullType = Self;
@@ -10195,6 +11683,7 @@ impl GraphQLFields for UserSettingsCustomTheme {
         "accent base contrast".into()
     }
 }
+/// User settings flag update response.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct UserSettingsFlagPayload {
@@ -10213,6 +11702,7 @@ impl GraphQLFields for UserSettingsFlagPayload {
         "lastSyncId flag value success".into()
     }
 }
+/// User settings flags reset response.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct UserSettingsFlagsResetPayload {
@@ -10227,13 +11717,14 @@ impl GraphQLFields for UserSettingsFlagsResetPayload {
         "lastSyncId success".into()
     }
 }
+/// User settings operation response.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct UserSettingsPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The user's settings.
-    pub user_settings: Option<Box<UserSettings>>,
+    pub user_settings: Option<UserSettings>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -10243,13 +11734,14 @@ impl GraphQLFields for UserSettingsPayload {
         "lastSyncId success".into()
     }
 }
+/// The user's resolved theme configuration for a specific color mode and device type.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct UserSettingsTheme {
     /// The theme preset.
     pub preset: Option<UserSettingsThemePreset>,
     /// The custom theme definition, only present when preset is 'custom'.
-    pub custom: Option<Box<UserSettingsCustomTheme>>,
+    pub custom: Option<UserSettingsCustomTheme>,
 }
 impl GraphQLFields for UserSettingsTheme {
     type FullType = Self;
@@ -10257,7 +11749,7 @@ impl GraphQLFields for UserSettingsTheme {
         "preset".into()
     }
 }
-/// View preferences.
+/// The display preferences for a view, controlling layout mode (list, board, spreadsheet), grouping, sorting, column visibility, and other visual settings. View preferences exist at two levels: organization-wide defaults and per-user overrides. The effective preferences are computed by merging both layers, with user preferences taking priority.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ViewPreferences {
@@ -10270,12 +11762,12 @@ pub struct ViewPreferences {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The view preference type.
+    /// The type of view preferences: "organization" for workspace-wide defaults or "user" for personal overrides.
     pub r#type: Option<String>,
-    /// The view type.
+    /// The type of view these preferences apply to, such as board, cycle, project, customView, myIssues, etc.
     pub view_type: Option<String>,
-    /// The view preferences
-    pub preferences: Option<Box<ViewPreferencesValues>>,
+    /// The view preferences values, containing layout, grouping, sorting, and field visibility settings.
+    pub preferences: Option<ViewPreferencesValues>,
 }
 impl GraphQLFields for ViewPreferences {
     type FullType = Self;
@@ -10283,13 +11775,14 @@ impl GraphQLFields for ViewPreferences {
         "id createdAt updatedAt archivedAt type viewType".into()
     }
 }
+/// The result of a view preferences mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ViewPreferencesPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The view preferences entity being mutated.
-    pub view_preferences: Option<Box<ViewPreferences>>,
+    pub view_preferences: Option<ViewPreferences>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -10299,25 +11792,452 @@ impl GraphQLFields for ViewPreferencesPayload {
         "lastSyncId success".into()
     }
 }
+/// A label group column configuration for the project list view.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase", default)]
+pub struct ViewPreferencesProjectLabelGroupColumn {
+    /// The identifier of the label group.
+    pub id: Option<String>,
+    /// Whether the label group column is active.
+    pub active: Option<bool>,
+}
+impl GraphQLFields for ViewPreferencesProjectLabelGroupColumn {
+    type FullType = Self;
+    fn selection() -> String {
+        "id active".into()
+    }
+}
+/// The computed view preferences values for a view, containing all display settings such as layout mode, grouping, sorting, field visibility, and other visual configuration. These values represent the merged result of organization defaults and user overrides.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct ViewPreferencesValues {
+    /// The issue layout type.
+    pub layout: Option<String>,
     /// The issue ordering.
     pub view_ordering: Option<String>,
+    /// The direction of the issue ordering.
+    pub view_ordering_direction: Option<String>,
     /// The issue grouping.
     pub issue_grouping: Option<String>,
-    /// The issue sub grouping.
+    /// The issue sub-grouping.
     pub issue_sub_grouping: Option<String>,
-    /// Whether to show completed issues.
+    /// How sub-issues should be nested and displayed.
+    pub issue_nesting: Option<String>,
+    /// Whether completed issues are shown and for how long.
     pub show_completed_issues: Option<String>,
+    /// Whether to show parent issues for sub-issues.
+    pub show_parents: Option<bool>,
+    /// Whether to show sub-issues.
+    pub show_sub_issues: Option<bool>,
+    /// Whether to show sub-team issues.
+    pub show_sub_team_issues: Option<bool>,
+    /// Whether to show supervised issues.
+    pub show_supervised_issues: Option<bool>,
+    /// Whether to show triage issues.
+    pub show_triage_issues: Option<bool>,
+    /// Whether to show snoozed items.
+    pub show_snoozed_items: Option<bool>,
+    /// Whether to show only snoozed items.
+    pub show_only_snoozed_items: Option<bool>,
+    /// Whether to show archived items.
+    pub show_archived_items: Option<bool>,
+    /// Whether to show read items.
+    pub show_read_items: Option<bool>,
+    /// Whether to show unread items first.
+    pub show_unread_items_first: Option<bool>,
+    /// Whether issues in closed columns should be ordered by recency.
+    pub closed_issues_ordered_by_recency: Option<bool>,
+    /// Whether to show empty groups.
+    pub show_empty_groups: Option<bool>,
+    /// Whether to show empty groups on the board layout.
+    pub show_empty_groups_board: Option<bool>,
+    /// Whether to show empty groups on the list layout.
+    pub show_empty_groups_list: Option<bool>,
+    /// Whether to show empty sub-groups.
+    pub show_empty_sub_groups: Option<bool>,
+    /// Whether to show empty sub-groups on the board layout.
+    pub show_empty_sub_groups_board: Option<bool>,
+    /// Whether to show empty sub-groups on the list layout.
+    pub show_empty_sub_groups_list: Option<bool>,
+    /// The label group ID used for issue grouping.
+    pub issue_grouping_label_group_id: Option<String>,
+    /// The label group ID used for issue sub-grouping.
+    pub issue_sub_grouping_label_group_id: Option<String>,
+    /// Whether to show the issue identifier field.
+    pub field_id: Option<bool>,
+    /// Whether to show the issue status field.
+    pub field_status: Option<bool>,
+    /// Whether to show the issue priority field.
+    pub field_priority: Option<bool>,
+    /// Whether to show the issue creation date field.
+    pub field_date_created: Option<bool>,
+    /// Whether to show the issue updated date field.
+    pub field_date_updated: Option<bool>,
+    /// Whether to show the issue archived date field.
+    pub field_date_archived: Option<bool>,
+    /// Whether to show the issue last activity date field.
+    pub field_date_my_activity: Option<bool>,
+    /// Whether to show the issue assignee field.
+    pub field_assignee: Option<bool>,
+    /// Whether to show the issue estimate field.
+    pub field_estimate: Option<bool>,
+    /// Whether to show the pull requests field.
+    pub field_pull_requests: Option<bool>,
+    /// Whether to show preview links.
+    pub field_preview_links: Option<bool>,
+    /// Whether to show the Sentry issues field.
+    pub field_sentry_issues: Option<bool>,
+    /// Whether to show the due date field.
+    pub field_due_date: Option<bool>,
+    /// Whether to show the link count field.
+    pub field_link_count: Option<bool>,
+    /// Whether to show the customer request count field.
+    pub field_customer_count: Option<bool>,
+    /// Whether to show the customer revenue field.
+    pub field_customer_revenue: Option<bool>,
+    /// Whether to show the SLA field.
+    pub field_sla: Option<bool>,
+    /// Whether to show the labels field.
+    pub field_labels: Option<bool>,
+    /// Whether to show the project field.
+    pub field_project: Option<bool>,
+    /// Whether to show the cycle field.
+    pub field_cycle: Option<bool>,
+    /// Whether to show the milestone field.
+    pub field_milestone: Option<bool>,
+    /// Whether to show the release field.
+    pub field_release: Option<bool>,
+    /// Whether to show the time in current status field.
+    pub field_time_in_current_status: Option<bool>,
+    /// List of column model IDs which should be hidden on a board.
+    pub hidden_columns: Option<Vec<String>>,
+    /// List of row model IDs which should be hidden on a board.
+    pub hidden_rows: Option<Vec<String>>,
+    /// List of group model IDs which should be hidden on a list.
+    pub hidden_groups_list: Option<Vec<String>>,
+    /// Custom ordering of groups on the board layout.
+    pub column_order_board: Option<Vec<String>>,
+    /// Custom ordering of groups on the list layout.
+    pub column_order_list: Option<Vec<String>>,
+    /// The project layout type.
+    pub project_layout: Option<String>,
+    /// The project ordering.
+    pub project_view_ordering: Option<String>,
+    /// The project grouping.
+    pub project_grouping: Option<String>,
+    /// The project sub-grouping.
+    pub project_sub_grouping: Option<String>,
+    /// The ordering of project groups.
+    pub project_group_ordering: Option<String>,
+    /// The date resolution when grouping projects by date.
+    pub project_grouping_date_resolution: Option<String>,
+    /// Whether completed projects are shown and for how long.
+    pub show_completed_projects: Option<String>,
+    /// The label group ID used for project grouping.
+    pub project_grouping_label_group_id: Option<String>,
+    /// The label group ID used for project sub-grouping.
+    pub project_sub_grouping_label_group_id: Option<String>,
+    /// The project label group columns configuration.
+    pub project_label_group_columns: Option<Vec<ViewPreferencesProjectLabelGroupColumn>>,
+    /// Whether to show sub-team projects.
+    pub show_sub_team_projects: Option<bool>,
+    /// Whether to show sub-initiative projects.
+    pub show_sub_initiative_projects: Option<bool>,
+    /// How to show empty project groups.
+    pub project_show_empty_groups: Option<String>,
+    /// How to show empty project groups on the list layout.
+    pub project_show_empty_groups_list: Option<String>,
+    /// How to show empty project groups on the timeline layout.
+    pub project_show_empty_groups_timeline: Option<String>,
+    /// How to show empty project groups on the board layout.
+    pub project_show_empty_groups_board: Option<String>,
+    /// How to show empty project sub-groups.
+    pub project_show_empty_sub_groups: Option<String>,
+    /// How to show empty project sub-groups on the list layout.
+    pub project_show_empty_sub_groups_list: Option<String>,
+    /// How to show empty project sub-groups on the timeline layout.
+    pub project_show_empty_sub_groups_timeline: Option<String>,
+    /// How to show empty project sub-groups on the board layout.
+    pub project_show_empty_sub_groups_board: Option<String>,
+    /// Whether to show the project status field.
+    pub project_field_status: Option<bool>,
+    /// Whether to show the project priority field.
+    pub project_field_priority: Option<bool>,
+    /// Whether to show the project lead field.
+    pub project_field_lead: Option<bool>,
+    /// Whether to show the project health field.
+    pub project_field_health: Option<bool>,
+    /// Whether to show the project members field.
+    pub project_field_members: Option<bool>,
+    /// Whether to show the project start date field.
+    pub project_field_start_date: Option<bool>,
+    /// Whether to show the project target date field.
+    pub project_field_target_date: Option<bool>,
+    /// Whether to show the project teams field.
+    pub project_field_teams: Option<bool>,
+    /// Whether to show the project roadmaps field.
+    pub project_field_roadmaps: Option<bool>,
+    /// Whether to show the project initiatives field.
+    pub project_field_initiatives: Option<bool>,
+    /// Whether to show the project milestone field.
+    pub project_field_milestone: Option<bool>,
+    /// Whether to show the project description field.
+    pub project_field_description: Option<bool>,
+    /// Whether to show the project predictions field.
+    pub project_field_predictions: Option<bool>,
+    /// Whether to show the project relations field.
+    pub project_field_relations: Option<bool>,
+    /// Whether to show the project rollout stage field.
+    pub project_field_rollout_stage: Option<bool>,
+    /// Whether to show the project activity field.
+    pub project_field_activity: Option<bool>,
+    /// Whether to show the project customer count field.
+    pub project_field_customer_count: Option<bool>,
+    /// Whether to show the project customer revenue field.
+    pub project_field_customer_revenue: Option<bool>,
+    /// Whether to show the project labels field.
+    pub project_field_labels: Option<bool>,
+    /// Whether to show the project creation date field.
+    pub project_field_date_created: Option<bool>,
+    /// Whether to show the project updated date field.
+    pub project_field_date_updated: Option<bool>,
+    /// Whether to show the project completion date field.
+    pub project_field_date_completed: Option<bool>,
+    /// Whether to show the project status field on the timeline.
+    pub project_field_status_timeline: Option<bool>,
+    /// Whether to show the project lead field on the timeline.
+    pub project_field_lead_timeline: Option<bool>,
+    /// Whether to show the project health field on the timeline.
+    pub project_field_health_timeline: Option<bool>,
+    /// Whether to show the project milestone field on the timeline.
+    pub project_field_milestone_timeline: Option<bool>,
+    /// Whether to show the project predictions field on the timeline.
+    pub project_field_predictions_timeline: Option<bool>,
+    /// Whether to show the project relations field on the timeline.
+    pub project_field_relations_timeline: Option<bool>,
+    /// Whether to show the project description field on the board.
+    pub project_field_description_board: Option<bool>,
+    /// Whether to show the project members field on the board.
+    pub project_field_members_board: Option<bool>,
+    /// Whether to show the project members field on the list.
+    pub project_field_members_list: Option<bool>,
+    /// Whether to show the project members field on the timeline.
+    pub project_field_members_timeline: Option<bool>,
+    /// Whether to show the project roadmaps field on the board.
+    pub project_field_roadmaps_board: Option<bool>,
+    /// Whether to show the project roadmaps field on the list.
+    pub project_field_roadmaps_list: Option<bool>,
+    /// Whether to show the project roadmaps field on the timeline.
+    pub project_field_roadmaps_timeline: Option<bool>,
+    /// Whether to show the project teams field on the board.
+    pub project_field_teams_board: Option<bool>,
+    /// Whether to show the project teams field on the list.
+    pub project_field_teams_list: Option<bool>,
+    /// Whether to show the project teams field on the timeline.
+    pub project_field_teams_timeline: Option<bool>,
+    /// The zoom level for the timeline view.
+    pub project_zoom_level: Option<String>,
+    /// The zoom scale for the timeline view.
+    pub timeline_zoom_scale: Option<f64>,
+    /// Selected team IDs to show cycles for in timeline chronology bar.
+    pub timeline_chronology_show_cycle_team_ids: Option<Vec<String>>,
+    /// Whether to show week numbers in timeline chronology bar.
+    pub timeline_chronology_show_week_numbers: Option<bool>,
+    /// The initiative grouping.
+    pub initiative_grouping: Option<String>,
+    /// The initiative ordering.
+    pub initiatives_view_ordering: Option<String>,
+    /// Whether to show the initiative projects field.
+    pub initiative_field_projects: Option<bool>,
+    /// Whether to show the initiative teams field.
+    pub initiative_field_teams: Option<bool>,
+    /// Whether to show the initiative description field.
+    pub initiative_field_description: Option<bool>,
+    /// Whether to show the initiative owner field.
+    pub initiative_field_owner: Option<bool>,
+    /// Whether to show the initiative start date field.
+    pub initiative_field_start_date: Option<bool>,
+    /// Whether to show the initiative target date field.
+    pub initiative_field_target_date: Option<bool>,
+    /// Whether to show the initiative completed date field.
+    pub initiative_field_date_completed: Option<bool>,
+    /// Whether to show the initiative updated date field.
+    pub initiative_field_date_updated: Option<bool>,
+    /// Whether to show the initiative created date field.
+    pub initiative_field_date_created: Option<bool>,
+    /// Whether to show the initiative status field.
+    pub initiative_field_status: Option<bool>,
+    /// Whether to show the initiative activity field.
+    pub initiative_field_activity: Option<bool>,
+    /// Whether to show the initiative health field.
+    pub initiative_field_initiative_health: Option<bool>,
+    /// Whether to show the initiative active projects health field.
+    pub initiative_field_health: Option<bool>,
+    /// Whether to show sub-initiatives nested.
+    pub show_nested_initiatives: Option<bool>,
+    /// The customers view ordering.
+    pub customers_view_ordering: Option<String>,
+    /// Whether to show the customer request count field.
+    pub customer_field_request_count: Option<bool>,
+    /// Whether to show the customer domains field.
+    pub customer_field_domains: Option<bool>,
+    /// Whether to show the customer owner field.
+    pub customer_field_owner: Option<bool>,
+    /// Whether to show the customer revenue field.
+    pub customer_field_revenue: Option<bool>,
+    /// Whether to show the customer size field.
+    pub customer_field_size: Option<bool>,
+    /// Whether to show the customer source field.
+    pub customer_field_source: Option<bool>,
+    /// Whether to show the customer status field.
+    pub customer_field_status: Option<bool>,
+    /// Whether to show the customer tier field.
+    pub customer_field_tier: Option<bool>,
+    /// The customer page needs view grouping.
+    pub customer_page_needs_view_grouping: Option<String>,
+    /// The customer page needs view ordering.
+    pub customer_page_needs_view_ordering: Option<String>,
+    /// Whether to show important customer needs first.
+    pub customer_page_needs_show_important_first: Option<bool>,
+    /// Whether to show completed issues and projects in the customer page.
+    pub customer_page_needs_show_completed_issues_and_projects: Option<String>,
+    /// Whether to show the issue identifier field in the customer page.
+    pub customer_page_needs_field_issue_identifier: Option<bool>,
+    /// Whether to show the issue priority field in the customer page.
+    pub customer_page_needs_field_issue_priority: Option<bool>,
+    /// Whether to show the issue status field in the customer page.
+    pub customer_page_needs_field_issue_status: Option<bool>,
+    /// Whether to show the issue due date field in the customer page.
+    pub customer_page_needs_field_issue_target_due_date: Option<bool>,
+    /// The embedded customer needs view ordering.
+    pub embedded_customer_needs_view_ordering: Option<String>,
+    /// Whether to show important embedded customer needs first.
+    pub embedded_customer_needs_show_important_first: Option<bool>,
+    /// The project customer needs view grouping.
+    pub project_customer_needs_view_grouping: Option<String>,
+    /// The project customer needs view ordering.
+    pub project_customer_needs_view_ordering: Option<String>,
+    /// Whether to show important project customer needs first.
+    pub project_customer_needs_show_important_first: Option<bool>,
+    /// Whether to show completed issues last in project customer needs.
+    pub project_customer_needs_show_completed_issues_last: Option<bool>,
+    /// The team view ordering.
+    pub team_view_ordering: Option<String>,
+    /// Whether to show the team identifier field.
+    pub team_field_identifier: Option<bool>,
+    /// Whether to show the team membership field.
+    pub team_field_membership: Option<bool>,
+    /// Whether to show the team owner field.
+    pub team_field_owner: Option<bool>,
+    /// Whether to show the team members field.
+    pub team_field_members: Option<bool>,
+    /// Whether to show the team projects field.
+    pub team_field_projects: Option<bool>,
+    /// Whether to show the team cycle field.
+    pub team_field_cycle: Option<bool>,
+    /// Whether to show the team creation date field.
+    pub team_field_date_created: Option<bool>,
+    /// Whether to show the team updated date field.
+    pub team_field_date_updated: Option<bool>,
+    /// The custom views ordering.
+    pub custom_views_ordering: Option<String>,
+    /// Whether to show the custom view owner field.
+    pub custom_view_field_owner: Option<bool>,
+    /// Whether to show the custom view visibility field.
+    pub custom_view_field_visibility: Option<bool>,
+    /// Whether to show the custom view creation date field.
+    pub custom_view_field_date_created: Option<bool>,
+    /// Whether to show the custom view updated date field.
+    pub custom_view_field_date_updated: Option<bool>,
+    /// The dashboards ordering.
+    pub dashboards_ordering: Option<String>,
+    /// Whether to show the dashboard owner field.
+    pub dashboard_field_owner: Option<bool>,
+    /// Whether to show the dashboard creation date field.
+    pub dashboard_field_date_created: Option<bool>,
+    /// Whether to show the dashboard updated date field.
+    pub dashboard_field_date_updated: Option<bool>,
+    /// The workspace members view ordering.
+    pub workspace_members_view_ordering: Option<String>,
+    /// Whether to show the member status field.
+    pub member_field_status: Option<bool>,
+    /// Whether to show the member joined date field.
+    pub member_field_joined: Option<bool>,
+    /// Whether to show the member teams field.
+    pub member_field_teams: Option<bool>,
+    /// The release pipeline grouping.
+    pub release_pipeline_grouping: Option<String>,
+    /// The release pipelines view ordering.
+    pub release_pipelines_view_ordering: Option<String>,
+    /// Whether to show the type field for release pipelines.
+    pub release_pipeline_field_type: Option<bool>,
+    /// Whether to show the teams field for release pipelines.
+    pub release_pipeline_field_teams: Option<bool>,
+    /// Whether to show the releases field for release pipelines.
+    pub release_pipeline_field_releases: Option<bool>,
+    /// Whether to show the latest release field for release pipelines.
+    pub release_pipeline_field_latest_release: Option<bool>,
+    /// The scheduled pipeline releases view ordering.
+    pub scheduled_pipeline_releases_view_ordering: Option<String>,
+    /// The scheduled pipeline releases view grouping.
+    pub scheduled_pipeline_releases_view_grouping: Option<String>,
+    /// Whether to show the version field for scheduled pipeline releases.
+    pub scheduled_pipeline_release_field_version: Option<bool>,
+    /// Whether to show the release date field for scheduled pipeline releases.
+    pub scheduled_pipeline_release_field_release_date: Option<bool>,
+    /// Whether to show the completion field for scheduled pipeline releases.
+    pub scheduled_pipeline_release_field_completion: Option<bool>,
+    /// Whether to show the description field for scheduled pipeline releases.
+    pub scheduled_pipeline_release_field_description: Option<bool>,
+    /// The continuous pipeline releases view grouping.
+    pub continuous_pipeline_releases_view_grouping: Option<String>,
+    /// Whether to show the version field for continuous pipeline releases.
+    pub continuous_pipeline_release_field_version: Option<bool>,
+    /// Whether to show the release date field for continuous pipeline releases.
+    pub continuous_pipeline_release_field_release_date: Option<bool>,
+    /// The search view ordering.
+    pub search_view_ordering: Option<String>,
+    /// The search result type filter.
+    pub search_result_type: Option<String>,
+    /// The inbox view ordering.
+    pub inbox_view_ordering: Option<String>,
+    /// The triage view ordering.
+    pub triage_view_ordering: Option<String>,
+    /// The focus view grouping.
+    pub focus_view_grouping: Option<String>,
+    /// The focus view ordering.
+    pub focus_view_ordering: Option<String>,
+    /// The focus view ordering direction.
+    pub focus_view_ordering_direction: Option<String>,
+    /// The review grouping.
+    pub review_grouping: Option<String>,
+    /// The review view ordering.
+    pub review_view_ordering: Option<String>,
+    /// Whether completed reviews are shown and for how long.
+    pub show_completed_reviews: Option<String>,
+    /// Whether to show draft reviews.
+    pub show_draft_reviews: Option<bool>,
+    /// Whether to show the review avatar field.
+    pub review_field_avatar: Option<bool>,
+    /// Whether to show the review preview links field.
+    pub review_field_preview_links: Option<bool>,
+    /// Whether to show the review repository field.
+    pub review_field_repository: Option<bool>,
+    /// Whether to show the review identifier field.
+    pub review_field_identifier: Option<bool>,
+    /// Whether to show the review checks field.
+    pub review_field_checks: Option<bool>,
+    /// Whether completed agent sessions are shown and for how long.
+    pub show_completed_agent_sessions: Option<String>,
 }
 impl GraphQLFields for ViewPreferencesValues {
     type FullType = Self;
     fn selection() -> String {
-        "viewOrdering issueGrouping issueSubGrouping showCompletedIssues".into()
+        "layout viewOrdering viewOrderingDirection issueGrouping issueSubGrouping issueNesting showCompletedIssues showParents showSubIssues showSubTeamIssues showSupervisedIssues showTriageIssues showSnoozedItems showOnlySnoozedItems showArchivedItems showReadItems showUnreadItemsFirst closedIssuesOrderedByRecency showEmptyGroups showEmptyGroupsBoard showEmptyGroupsList showEmptySubGroups showEmptySubGroupsBoard showEmptySubGroupsList issueGroupingLabelGroupId issueSubGroupingLabelGroupId fieldId fieldStatus fieldPriority fieldDateCreated fieldDateUpdated fieldDateArchived fieldDateMyActivity fieldAssignee fieldEstimate fieldPullRequests fieldPreviewLinks fieldSentryIssues fieldDueDate fieldLinkCount fieldCustomerCount fieldCustomerRevenue fieldSla fieldLabels fieldProject fieldCycle fieldMilestone fieldRelease fieldTimeInCurrentStatus hiddenColumns hiddenRows hiddenGroupsList columnOrderBoard columnOrderList projectLayout projectViewOrdering projectGrouping projectSubGrouping projectGroupOrdering projectGroupingDateResolution showCompletedProjects projectGroupingLabelGroupId projectSubGroupingLabelGroupId showSubTeamProjects showSubInitiativeProjects projectShowEmptyGroups projectShowEmptyGroupsList projectShowEmptyGroupsTimeline projectShowEmptyGroupsBoard projectShowEmptySubGroups projectShowEmptySubGroupsList projectShowEmptySubGroupsTimeline projectShowEmptySubGroupsBoard projectFieldStatus projectFieldPriority projectFieldLead projectFieldHealth projectFieldMembers projectFieldStartDate projectFieldTargetDate projectFieldTeams projectFieldRoadmaps projectFieldInitiatives projectFieldMilestone projectFieldDescription projectFieldPredictions projectFieldRelations projectFieldRolloutStage projectFieldActivity projectFieldCustomerCount projectFieldCustomerRevenue projectFieldLabels projectFieldDateCreated projectFieldDateUpdated projectFieldDateCompleted projectFieldStatusTimeline projectFieldLeadTimeline projectFieldHealthTimeline projectFieldMilestoneTimeline projectFieldPredictionsTimeline projectFieldRelationsTimeline projectFieldDescriptionBoard projectFieldMembersBoard projectFieldMembersList projectFieldMembersTimeline projectFieldRoadmapsBoard projectFieldRoadmapsList projectFieldRoadmapsTimeline projectFieldTeamsBoard projectFieldTeamsList projectFieldTeamsTimeline projectZoomLevel timelineZoomScale timelineChronologyShowCycleTeamIds timelineChronologyShowWeekNumbers initiativeGrouping initiativesViewOrdering initiativeFieldProjects initiativeFieldTeams initiativeFieldDescription initiativeFieldOwner initiativeFieldStartDate initiativeFieldTargetDate initiativeFieldDateCompleted initiativeFieldDateUpdated initiativeFieldDateCreated initiativeFieldStatus initiativeFieldActivity initiativeFieldInitiativeHealth initiativeFieldHealth showNestedInitiatives customersViewOrdering customerFieldRequestCount customerFieldDomains customerFieldOwner customerFieldRevenue customerFieldSize customerFieldSource customerFieldStatus customerFieldTier customerPageNeedsViewGrouping customerPageNeedsViewOrdering customerPageNeedsShowImportantFirst customerPageNeedsShowCompletedIssuesAndProjects customerPageNeedsFieldIssueIdentifier customerPageNeedsFieldIssuePriority customerPageNeedsFieldIssueStatus customerPageNeedsFieldIssueTargetDueDate embeddedCustomerNeedsViewOrdering embeddedCustomerNeedsShowImportantFirst projectCustomerNeedsViewGrouping projectCustomerNeedsViewOrdering projectCustomerNeedsShowImportantFirst projectCustomerNeedsShowCompletedIssuesLast teamViewOrdering teamFieldIdentifier teamFieldMembership teamFieldOwner teamFieldMembers teamFieldProjects teamFieldCycle teamFieldDateCreated teamFieldDateUpdated customViewsOrdering customViewFieldOwner customViewFieldVisibility customViewFieldDateCreated customViewFieldDateUpdated dashboardsOrdering dashboardFieldOwner dashboardFieldDateCreated dashboardFieldDateUpdated workspaceMembersViewOrdering memberFieldStatus memberFieldJoined memberFieldTeams releasePipelineGrouping releasePipelinesViewOrdering releasePipelineFieldType releasePipelineFieldTeams releasePipelineFieldReleases releasePipelineFieldLatestRelease scheduledPipelineReleasesViewOrdering scheduledPipelineReleasesViewGrouping scheduledPipelineReleaseFieldVersion scheduledPipelineReleaseFieldReleaseDate scheduledPipelineReleaseFieldCompletion scheduledPipelineReleaseFieldDescription continuousPipelineReleasesViewGrouping continuousPipelineReleaseFieldVersion continuousPipelineReleaseFieldReleaseDate searchViewOrdering searchResultType inboxViewOrdering triageViewOrdering focusViewGrouping focusViewOrdering focusViewOrderingDirection reviewGrouping reviewViewOrdering showCompletedReviews showDraftReviews reviewFieldAvatar reviewFieldPreviewLinks reviewFieldRepository reviewFieldIdentifier reviewFieldChecks showCompletedAgentSessions"
+            .into()
     }
 }
-/// A webhook used to send HTTP notifications over data updates.
+/// A webhook subscription that sends HTTP POST callbacks to an external URL when events occur in Linear. Webhooks can be scoped to a specific team, multiple teams, or all public teams in the organization. They support filtering by resource type (e.g., Issue, Comment, Project) and can be created either manually by users or automatically by OAuth applications. Each webhook has a signing secret for verifying payload authenticity on the recipient side.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct Webhook {
@@ -10330,26 +12250,26 @@ pub struct Webhook {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Webhook label.
+    /// A human-readable label for the webhook, used for identification in the UI. Null if no label has been set.
     pub label: Option<String>,
-    /// Webhook URL.
+    /// The destination URL where webhook payloads will be sent via HTTP POST. Null for OAuth application webhooks, which use the webhook URL configured on the OAuth client instead.
     pub url: Option<String>,
-    /// Whether the Webhook is enabled.
+    /// Whether the webhook is enabled. When disabled, no payloads will be delivered even if matching events occur.
     pub enabled: Option<bool>,
-    /// The team that the webhook is associated with. If null, the webhook is associated with all public teams of the organization or multiple teams.
-    pub team: Option<Box<Team>>,
-    /// `INTERNAL` The teams that the webhook is associated with. Used to represent a webhook that targets multiple teams, potentially in addition to all public teams of the organization.
+    /// The single team that the webhook is scoped to. When null, the webhook either targets all public teams (if allPublicTeams is true), multiple specific teams (if teamIds is set), or organization-wide events.
+    pub team: Option<Team>,
+    /// `INTERNAL` An array of team IDs that the webhook is subscribed to. Used to represent a webhook that targets multiple specific teams, potentially in addition to all public teams (when allPublicTeams is also true). Null when the webhook targets a single team via teamId or all public teams only.
     pub team_ids: Option<Vec<String>>,
-    /// Whether the Webhook is enabled for all public teams, including teams created after the webhook was created.
+    /// Whether the webhook receives events from all public (non-private) teams in the organization, including teams created after the webhook was set up. When true, the webhook automatically covers new public teams without requiring reconfiguration.
     pub all_public_teams: Option<bool>,
     /// The user who created the webhook.
-    pub creator: Option<Box<User>>,
-    /// Secret token for verifying the origin on the recipient side.
+    pub creator: Option<User>,
+    /// A secret token used to sign webhook payloads with HMAC-SHA256, allowing the recipient to verify that the payload originated from Linear and was not tampered with. Automatically generated if not provided during creation.
     pub secret: Option<String>,
-    /// The resource types this webhook is subscribed to.
+    /// The resource types this webhook is subscribed to (e.g., 'Issue', 'Comment', 'Project', 'Cycle'). The webhook will only receive payloads for events affecting these resource types.
     pub resource_types: Option<Vec<String>>,
     /// `INTERNAL` Webhook failure events associated with the webhook (last 50).
-    pub failures: Option<Box<Vec<WebhookFailureEvent>>>,
+    pub failures: Option<Vec<WebhookFailureEvent>>,
 }
 impl GraphQLFields for Webhook {
     type FullType = Self;
@@ -10361,9 +12281,9 @@ impl GraphQLFields for Webhook {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct WebhookConnection {
-    pub edges: Option<Box<Vec<WebhookEdge>>>,
-    pub nodes: Option<Box<Vec<Webhook>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<WebhookEdge>>,
+    pub nodes: Option<Vec<Webhook>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for WebhookConnection {
     type FullType = Self;
@@ -10374,7 +12294,7 @@ impl GraphQLFields for WebhookConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct WebhookEdge {
-    pub node: Option<Box<Webhook>>,
+    pub node: Option<Webhook>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -10384,7 +12304,7 @@ impl GraphQLFields for WebhookEdge {
         "cursor".into()
     }
 }
-/// Entity representing a webhook execution failure.
+/// A record of a failed webhook delivery attempt. Created when a webhook payload could not be successfully delivered to the destination URL, either due to an HTTP error response or a network failure. Each failure event captures the HTTP status code (if available), the response body or error message, and a stable execution ID that is shared across retries of the same delivery.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct WebhookFailureEvent {
@@ -10393,14 +12313,14 @@ pub struct WebhookFailureEvent {
     /// The time at which the entity was created.
     pub created_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The webhook that this failure event is associated with.
-    pub webhook: Option<Box<Webhook>>,
+    pub webhook: Option<Webhook>,
     /// The URL that the webhook was trying to push to.
     pub url: Option<String>,
-    /// The HTTP status code returned by the recipient.
+    /// The HTTP status code returned by the webhook recipient. Null if the request failed before receiving a response (e.g., DNS resolution failure, connection timeout).
     pub http_status: Option<f64>,
-    /// The HTTP response body returned by the recipient or error occured.
+    /// The HTTP response body returned by the recipient, or the error message if the request failed before receiving a response. Truncated to 1000 characters.
     pub response_or_error: Option<String>,
-    /// The unique execution ID of the webhook push. This is retained between retries of the same push.
+    /// A stable identifier for the webhook delivery attempt. This ID remains the same across retries of the same payload, making it useful for correlating multiple failure events that belong to the same logical delivery.
     pub execution_id: Option<String>,
 }
 impl GraphQLFields for WebhookFailureEvent {
@@ -10409,13 +12329,14 @@ impl GraphQLFields for WebhookFailureEvent {
         "id createdAt url httpStatus responseOrError executionId".into()
     }
 }
+/// The result of a webhook mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct WebhookPayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The webhook entity being mutated.
-    pub webhook: Option<Box<Webhook>>,
+    pub webhook: Option<Webhook>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
@@ -10425,6 +12346,7 @@ impl GraphQLFields for WebhookPayload {
         "lastSyncId success".into()
     }
 }
+/// The result of a webhook secret rotation mutation.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct WebhookRotateSecretPayload {
@@ -10441,7 +12363,7 @@ impl GraphQLFields for WebhookRotateSecretPayload {
         "lastSyncId success secret".into()
     }
 }
-/// A welcome message for new users joining the workspace.
+/// A welcome message configuration for the workspace. When enabled, new users joining the workspace receive a notification with this message in their inbox. Each workspace has at most one welcome message. The message body is stored in a related DocumentContent entity.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct WelcomeMessage {
@@ -10454,11 +12376,11 @@ pub struct WelcomeMessage {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The title of the welcome message notification.
+    /// The title of the welcome message notification. Null defaults to 'Welcome to {workspace name}'.
     pub title: Option<String>,
-    /// Whether the welcome message is enabled.
+    /// Whether the welcome message is enabled and should be sent to new users joining the workspace.
     pub enabled: Option<bool>,
-    /// The user who last updated the welcome message.
+    /// The user who last updated the welcome message configuration. Null if the user's account has been deleted.
     pub updated_by: Option<Box<User>>,
 }
 impl GraphQLFields for WelcomeMessage {
@@ -10467,7 +12389,7 @@ impl GraphQLFields for WelcomeMessage {
         "id createdAt updatedAt archivedAt title enabled".into()
     }
 }
-/// A welcome message related notification.
+/// A notification containing a workspace welcome message, sent to newly joined users.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct WelcomeMessageNotification {
@@ -10480,22 +12402,21 @@ pub struct WelcomeMessageNotification {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// Notification type.
+    /// Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated.
     pub r#type: Option<String>,
-    /// The user that caused the notification.
-    pub actor: Option<Box<User>>,
-    /// The external user that caused the notification.
-    pub external_user_actor: Option<Box<ExternalUser>>,
-    /// The user that received the notification.
-    pub user: Option<Box<User>>,
-    /// The time at when the user marked the notification as read. Null, if the the user hasn't read the notification
+    /// The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event.
+    pub actor: Option<User>,
+    /// The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member.
+    pub external_user_actor: Option<ExternalUser>,
+    /// The recipient user of this notification.
+    pub user: Option<User>,
+    /// The time at which the user marked the notification as read. Null if the notification is unread.
     pub read_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at when an email reminder for this notification was sent to the user. Null, if no email
-    /// reminder has been sent.
+    /// The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent.
     pub emailed_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time until a notification will be snoozed. After that it will appear in the inbox again.
+    /// The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed.
     pub snoozed_until_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The time at which a notification was unsnoozed..
+    /// The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed.
     pub unsnoozed_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The category of the notification.
     pub category: Option<NotificationCategory>,
@@ -10526,7 +12447,7 @@ pub struct WelcomeMessageNotification {
     /// `Internal` Priority of the notification with the same grouping key. Higher number means higher priority. If priority is the same, notifications should be sorted by `createdAt`.
     pub grouping_priority: Option<f64>,
     /// The bot that caused the notification.
-    pub bot_actor: Option<Box<ActorBot>>,
+    pub bot_actor: Option<ActorBot>,
     /// Related welcome message.
     pub welcome_message_id: Option<String>,
 }
@@ -10537,6 +12458,7 @@ impl GraphQLFields for WelcomeMessageNotification {
             .into()
     }
 }
+/// An automation workflow definition that executes a set of activities when triggered by specific events. Workflows can be scoped to a team, project, cycle, label, custom view, initiative, or user context. They are triggered by entity changes (e.g., issue status change, new comment) and can include conditions that filter which events actually execute the workflow. Activities define the actions taken, such as updating issue properties, sending notifications, or posting to Slack.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct WorkflowDefinition {
@@ -10555,52 +12477,55 @@ pub struct WorkflowDefinition {
     pub group_name: Option<String>,
     /// The description of the workflow.
     pub description: Option<String>,
-    /// The type of the workflow.
+    /// The type of the workflow, such as custom automation, SLA, or auto-close.
     pub r#type: Option<WorkflowType>,
-    /// The type of the event that triggers off the workflow.
+    /// The event that triggers the workflow, such as entity creation, update, or a specific state change.
     pub trigger: Option<WorkflowTrigger>,
-    /// The object type (e.g. Issue) that triggers this workflow.
+    /// The entity type that triggers this workflow, such as Issue, Project, or Release.
     pub trigger_type: Option<WorkflowTriggerType>,
-    /// The conditions that need to be match for the workflow to be triggered.
+    /// The filter conditions that must match for the workflow to execute. When null, the workflow triggers on all matching events.
     pub conditions: Option<serde_json::Value>,
+    /// Whether the workflow is enabled and will execute when its trigger conditions are met.
     pub enabled: Option<bool>,
-    /// The team associated with the workflow. If not set, the workflow is associated with the entire organization.
-    pub team: Option<Box<Team>>,
+    /// The team associated with the workflow. If not set, the workflow is associated with the entire workspace.
+    pub team: Option<Team>,
     /// The user who created the workflow.
-    pub creator: Option<Box<User>>,
-    /// An array of activities that will be executed as part of the workflow.
+    pub creator: Option<User>,
+    /// The ordered list of activities (actions) that are executed when the workflow triggers, such as updating issue properties, sending notifications, or calling webhooks.
     pub activities: Option<serde_json::Value>,
     /// The sort order of the workflow definition within its siblings.
     pub sort_order: Option<String>,
-    /// The date when the workflow was last executed.
+    /// The date and time when the workflow was last triggered and executed. Null if the workflow has never been executed.
     pub last_executed_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The user who last updated the workflow.
-    pub last_updated_by: Option<Box<User>>,
+    pub last_updated_by: Option<User>,
     /// The contextual label view associated with the workflow.
-    pub label: Option<Box<IssueLabel>>,
+    pub label: Option<IssueLabel>,
     /// The contextual cycle view associated with the workflow.
-    pub cycle: Option<Box<Cycle>>,
+    pub cycle: Option<Cycle>,
     /// The contextual user view associated with the workflow.
-    pub user: Option<Box<User>>,
+    pub user: Option<User>,
     /// The contextual project view associated with the workflow.
-    pub project: Option<Box<Project>>,
+    pub project: Option<Project>,
     /// The contextual initiative view associated with the workflow.
-    pub initiative: Option<Box<Initiative>>,
+    pub initiative: Option<Initiative>,
     /// The context custom view associated with the workflow.
-    pub custom_view: Option<Box<CustomView>>,
+    pub custom_view: Option<CustomView>,
     /// The type of view to which this workflow's context is associated with.
     pub context_view_type: Option<ContextViewType>,
     /// The type of user view to which this workflow's context is associated with.
     pub user_context_view_type: Option<UserContextViewType>,
+    /// The workflow definition's unique URL slug.
+    pub slug_id: Option<String>,
 }
 impl GraphQLFields for WorkflowDefinition {
     type FullType = Self;
     fn selection() -> String {
-        "id createdAt updatedAt archivedAt name groupName description type trigger triggerType conditions enabled activities sortOrder lastExecutedAt contextViewType userContextViewType"
+        "id createdAt updatedAt archivedAt name groupName description type trigger triggerType conditions enabled activities sortOrder lastExecutedAt contextViewType userContextViewType slugId"
             .into()
     }
 }
-/// A state in a team workflow.
+/// A state in a team's workflow, representing an issue status such as Triage, Backlog, Todo, In Progress, In Review, Done, or Canceled. Each team has its own set of workflow states that define the progression of issues through the team's process. Workflow states have a type that categorizes them (triage, backlog, unstarted, started, completed, canceled), a position that determines their display order, and a color for visual identification. States can be inherited from parent teams to sub-teams.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct WorkflowState {
@@ -10613,22 +12538,22 @@ pub struct WorkflowState {
     pub updated_at: Option<chrono::DateTime<chrono::Utc>>,
     /// The time at which the entity was archived. Null if the entity has not been archived.
     pub archived_at: Option<chrono::DateTime<chrono::Utc>>,
-    /// The state's name.
+    /// The state's human-readable name (e.g., 'In Progress', 'Done', 'Backlog').
     pub name: Option<String>,
     /// The state's UI color as a HEX string.
     pub color: Option<String>,
     /// Description of the state.
     pub description: Option<String>,
-    /// The position of the state in the team flow.
+    /// The position of the state in the team's workflow. States are displayed in ascending order of position within their type group.
     pub position: Option<f64>,
-    /// The type of the state. One of "triage", "backlog", "unstarted", "started", "completed", "canceled".
+    /// The type of the state. One of "triage", "backlog", "unstarted", "started", "completed", "canceled", "duplicate".
     pub r#type: Option<String>,
-    /// The team to which this state belongs to.
+    /// The team that this workflow state belongs to. Each team has its own set of workflow states.
     pub team: Option<Box<Team>>,
-    /// The state inherited from
+    /// The parent team's workflow state that this state was inherited from. Null if the state is not inherited from a parent team.
     pub inherited_from: Option<Box<WorkflowState>>,
-    /// Issues belonging in this state.
-    pub issues: Option<Box<IssueConnection>>,
+    /// Issues that currently have this workflow state. Returns a paginated and filterable list of issues.
+    pub issues: Option<IssueConnection>,
 }
 impl GraphQLFields for WorkflowState {
     type FullType = Self;
@@ -10645,7 +12570,7 @@ pub struct WorkflowStateArchivePayload {
     /// Whether the operation was successful.
     pub success: Option<bool>,
     /// The archived/unarchived entity. Null if entity was deleted.
-    pub entity: Option<Box<WorkflowState>>,
+    pub entity: Option<WorkflowState>,
 }
 impl GraphQLFields for WorkflowStateArchivePayload {
     type FullType = Self;
@@ -10656,9 +12581,9 @@ impl GraphQLFields for WorkflowStateArchivePayload {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct WorkflowStateConnection {
-    pub edges: Option<Box<Vec<WorkflowStateEdge>>>,
-    pub nodes: Option<Box<Vec<WorkflowState>>>,
-    pub page_info: Option<Box<PageInfo>>,
+    pub edges: Option<Vec<WorkflowStateEdge>>,
+    pub nodes: Option<Vec<WorkflowState>>,
+    pub page_info: Option<PageInfo>,
 }
 impl GraphQLFields for WorkflowStateConnection {
     type FullType = Self;
@@ -10669,7 +12594,7 @@ impl GraphQLFields for WorkflowStateConnection {
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct WorkflowStateEdge {
-    pub node: Option<Box<WorkflowState>>,
+    pub node: Option<WorkflowState>,
     /// Used in `before` and `after` args
     pub cursor: Option<String>,
 }
@@ -10679,13 +12604,14 @@ impl GraphQLFields for WorkflowStateEdge {
         "cursor".into()
     }
 }
+/// The result of a workflow state mutation, containing the created or updated state and a success indicator.
 #[derive(Debug, Clone, Default, Serialize, Deserialize)]
 #[serde(rename_all = "camelCase", default)]
 pub struct WorkflowStatePayload {
     /// The identifier of the last sync operation.
     pub last_sync_id: Option<f64>,
     /// The state that was created or updated.
-    pub workflow_state: Option<Box<WorkflowState>>,
+    pub workflow_state: Option<WorkflowState>,
     /// Whether the operation was successful.
     pub success: Option<bool>,
 }
diff --git a/crates/lineark-sdk/src/lib.rs b/crates/lineark-sdk/src/lib.rs
index 3b9f214..ca301f1 100644
--- a/crates/lineark-sdk/src/lib.rs
+++ b/crates/lineark-sdk/src/lib.rs
@@ -4,6 +4,7 @@ pub mod auth;
 pub mod client;
 pub mod error;
 pub mod field_selection;
+pub mod field_update;
 pub mod generated;
 pub mod helpers;
 pub mod pagination;
@@ -13,5 +14,6 @@ pub use client::Client;
 pub use error::LinearError;
 pub use field_selection::FieldCompatible;
 pub use field_selection::GraphQLFields;
+pub use field_update::MaybeUndefined;
 pub use lineark_derive::GraphQLFields;
 pub use pagination::{Connection, PageInfo};
diff --git a/crates/lineark-sdk/tests/offline.rs b/crates/lineark-sdk/tests/offline.rs
index 713e0ac..831cd8a 100644
--- a/crates/lineark-sdk/tests/offline.rs
+++ b/crates/lineark-sdk/tests/offline.rs
@@ -437,8 +437,8 @@ async fn document_create_sends_input_variable() {
 
     let (server, client) = setup_mutation("documentCreate").await;
     let input = DocumentCreateInput {
-        title: Some("Test Document".to_string()),
-        content: Some("# Hello".to_string()),
+        title: "Test Document".to_string(),
+        content: "# Hello".to_string().into(),
         ..Default::default()
     };
     let _ = client.document_create::<Document>(input).await;
@@ -453,7 +453,7 @@ async fn document_update_sends_input_and_id() {
 
     let (server, client) = setup_mutation("documentUpdate").await;
     let input = DocumentUpdateInput {
-        title: Some("Updated Title".to_string()),
+        title: "Updated Title".to_string().into(),
         ..Default::default()
     };
     let _ = client
@@ -481,10 +481,10 @@ async fn issue_relation_create_sends_input() {
 
     let (server, client) = setup_mutation("issueRelationCreate").await;
     let input = IssueRelationCreateInput {
-        issue_id: Some("issue-a".to_string()),
-        related_issue_id: Some("issue-b".to_string()),
-        r#type: Some(IssueRelationType::Blocks),
-        ..Default::default()
+        id: lineark_sdk::MaybeUndefined::Undefined,
+        issue_id: "issue-a".to_string(),
+        related_issue_id: "issue-b".to_string(),
+        r#type: IssueRelationType::Blocks,
     };
     let _ = client
         .issue_relation_create::<IssueRelation>(None, input)
@@ -588,8 +588,8 @@ async fn team_create_sends_input_variable() {
 
     let (server, client) = setup_mutation("teamCreate").await;
     let input = TeamCreateInput {
-        name: Some("Test Team".to_string()),
-        key: Some("TST".to_string()),
+        name: "Test Team".to_string(),
+        key: "TST".to_string().into(),
         ..Default::default()
     };
     let _ = client.team_create::<Team>(None, input).await;
@@ -605,7 +605,7 @@ async fn team_update_sends_input_and_id() {
 
     let (server, client) = setup_mutation("teamUpdate").await;
     let input = TeamUpdateInput {
-        description: Some("Updated description".to_string()),
+        description: "Updated description".to_string().into(),
         ..Default::default()
     };
     let _ = client
@@ -632,8 +632,8 @@ async fn team_membership_create_sends_input() {
 
     let (server, client) = setup_mutation("teamMembershipCreate").await;
     let input = TeamMembershipCreateInput {
-        user_id: Some("user-uuid-abc".to_string()),
-        team_id: Some("team-uuid-def".to_string()),
+        user_id: "user-uuid-abc".to_string(),
+        team_id: "team-uuid-def".to_string(),
         ..Default::default()
     };
     let _ = client.team_membership_create::<TeamMembership>(input).await;
@@ -652,3 +652,85 @@ async fn team_membership_delete_sends_id() {
     assert_eq!(vars["id"], "membership-uuid-123");
     assert_eq!(vars["alsoLeaveParentTeams"], Value::Null);
 }
+
+// ── MaybeUndefined wire-format contract ──────────────────────────────────
+//
+// The central guarantee of the three-state wrapper: on a generated input
+// struct, `Undefined` fields disappear from the payload entirely, `Null`
+// fields serialize as JSON `null`, and `Value(v)` serializes as `v`. These
+// tests pin the contract end-to-end through a real generated `*UpdateInput`
+// without hitting the network, so a codegen change that silently breaks the
+// mapping would fail offline CI.
+
+#[test]
+fn maybe_undefined_null_serializes_as_json_null_on_generated_input() {
+    use lineark_sdk::generated::inputs::ProjectUpdateInput;
+    use lineark_sdk::MaybeUndefined;
+
+    let input = ProjectUpdateInput {
+        lead_id: MaybeUndefined::Null,
+        ..Default::default()
+    };
+    let json = serde_json::to_value(&input).unwrap();
+    let obj = json
+        .as_object()
+        .expect("ProjectUpdateInput serializes to object");
+
+    // Null fields are present with a JSON null.
+    assert_eq!(obj.get("leadId"), Some(&Value::Null));
+    // All other fields (still Undefined via Default) are omitted entirely.
+    assert_eq!(
+        obj.len(),
+        1,
+        "only the explicitly-set field should appear: {obj:?}"
+    );
+    assert!(!obj.contains_key("name"));
+    assert!(!obj.contains_key("description"));
+    assert!(!obj.contains_key("startDate"));
+    assert!(!obj.contains_key("targetDate"));
+}
+
+#[test]
+fn maybe_undefined_value_serializes_as_wrapped_value_on_generated_input() {
+    use lineark_sdk::generated::inputs::ProjectUpdateInput;
+    use lineark_sdk::MaybeUndefined;
+
+    let input = ProjectUpdateInput {
+        name: MaybeUndefined::Value("renamed".to_string()),
+        lead_id: MaybeUndefined::Null,
+        ..Default::default()
+    };
+    let json = serde_json::to_value(&input).unwrap();
+    let obj = json.as_object().unwrap();
+
+    assert_eq!(obj.get("name"), Some(&Value::String("renamed".to_string())));
+    assert_eq!(obj.get("leadId"), Some(&Value::Null));
+    assert_eq!(obj.len(), 2);
+}
+
+#[test]
+fn maybe_undefined_roundtrip_preserves_null_but_collapses_undefined() {
+    use lineark_sdk::generated::inputs::ProjectUpdateInput;
+    use lineark_sdk::MaybeUndefined;
+
+    // `Null` survives a JSON round-trip because the field is serialized and
+    // then re-parsed. `Undefined` is dropped on serialize (via
+    // skip_serializing_if) and the absent field deserializes back to
+    // `Undefined` via `#[serde(default)]` — so the round-trip is
+    // information-preserving for both states, even though they both collapse
+    // to "no wire data" mid-flight.
+    let original = ProjectUpdateInput {
+        name: MaybeUndefined::Value("X".to_string()),
+        lead_id: MaybeUndefined::Null,
+        ..Default::default()
+    };
+    let json = serde_json::to_string(&original).unwrap();
+    let restored: ProjectUpdateInput = serde_json::from_str(&json).unwrap();
+
+    assert!(matches!(restored.name, MaybeUndefined::Value(ref s) if s == "X"));
+    assert!(matches!(restored.lead_id, MaybeUndefined::Null));
+    // Fields that were Undefined round-trip back to Undefined (omitted → absent
+    // → default → Undefined).
+    assert!(matches!(restored.description, MaybeUndefined::Undefined));
+    assert!(matches!(restored.start_date, MaybeUndefined::Undefined));
+}
diff --git a/crates/lineark-sdk/tests/online.rs b/crates/lineark-sdk/tests/online.rs
index 2eb16cb..fa6690d 100644
--- a/crates/lineark-sdk/tests/online.rs
+++ b/crates/lineark-sdk/tests/online.rs
@@ -143,8 +143,8 @@ mod online {
             &uuid::Uuid::new_v4().to_string()[..8]
         );
         let input = IssueLabelCreateInput {
-            name: Some(unique.clone()),
-            color: Some("#eb5757".to_string()),
+            name: unique.clone(),
+            color: Some("#eb5757".to_string()).into(),
             ..Default::default()
         };
         let label = retry_create(|| {
@@ -163,7 +163,7 @@ mod online {
 
         // Update the label's color.
         let update_input = IssueLabelUpdateInput {
-            color: Some("#4ea7fc".to_string()),
+            color: Some("#4ea7fc".to_string()).into(),
             ..Default::default()
         };
         let updated = client
@@ -361,9 +361,9 @@ mod online {
         // Create an issue with a unique title.
         let unique = format!("[builder-test-{}]", uuid::Uuid::new_v4());
         let input = IssueCreateInput {
-            title: Some(unique.clone()),
-            team_id: Some(team_id),
-            priority: Some(4),
+            title: Some(unique.clone()).into(),
+            team_id,
+            priority: Some(4).into(),
             ..Default::default()
         };
         let entity = retry_create(|| {
@@ -434,9 +434,9 @@ mod online {
         // Create an issue with a unique title in the first team.
         let unique = format!("[team-filter-{}]", uuid::Uuid::new_v4());
         let input = IssueCreateInput {
-            title: Some(unique.clone()),
-            team_id: Some(team_id.clone()),
-            priority: Some(4),
+            title: Some(unique.clone()).into(),
+            team_id: team_id.clone(),
+            priority: Some(4).into(),
             ..Default::default()
         };
         let entity = retry_create(|| {
@@ -550,10 +550,10 @@ mod online {
 
         // Create an issue.
         let input = IssueCreateInput {
-            title: Some("[test] SDK issue_create_and_delete".to_string()),
-            team_id: Some(team_id),
-            description: Some("Automated test — will be deleted immediately.".to_string()),
-            priority: Some(4), // Low
+            title: Some("[test] SDK issue_create_and_delete".to_string()).into(),
+            team_id,
+            description: Some("Automated test — will be deleted immediately.".to_string()).into(),
+            priority: Some(4).into(), // Low
             ..Default::default()
         };
         let entity = retry_create(|| {
@@ -586,9 +586,9 @@ mod online {
         let team_id = team.id.clone();
 
         let input = IssueCreateInput {
-            title: Some("[test] SDK issue_update".to_string()),
-            team_id: Some(team_id),
-            priority: Some(4),
+            title: Some("[test] SDK issue_update".to_string()).into(),
+            team_id,
+            priority: Some(4).into(),
             ..Default::default()
         };
         let entity = retry_create(|| {
@@ -604,8 +604,8 @@ mod online {
 
         // Update the issue.
         let update_input = IssueUpdateInput {
-            title: Some("[test] SDK issue_update — updated".to_string()),
-            priority: Some(3), // Medium
+            title: Some("[test] SDK issue_update — updated".to_string()).into(),
+            priority: Some(3).into(), // Medium
             ..Default::default()
         };
         let updated_entity = client
@@ -633,9 +633,9 @@ mod online {
         let team_id = team.id.clone();
 
         let input = IssueCreateInput {
-            title: Some("[test] SDK issue_archive_and_unarchive".to_string()),
-            team_id: Some(team_id),
-            priority: Some(4),
+            title: Some("[test] SDK issue_archive_and_unarchive".to_string()).into(),
+            team_id,
+            priority: Some(4).into(),
             ..Default::default()
         };
         let entity = retry_create(|| {
@@ -679,9 +679,9 @@ mod online {
         let team_id = team.id.clone();
 
         let issue_input = IssueCreateInput {
-            title: Some("[test] SDK comment_create".to_string()),
-            team_id: Some(team_id),
-            priority: Some(4),
+            title: Some("[test] SDK comment_create".to_string()).into(),
+            team_id,
+            priority: Some(4).into(),
             ..Default::default()
         };
         let issue_entity = retry_create(|| {
@@ -697,8 +697,8 @@ mod online {
 
         // Create a comment.
         let comment_input = CommentCreateInput {
-            body: Some("Automated test comment from lineark SDK.".to_string()),
-            issue_id: Some(issue_id.clone()),
+            body: Some("Automated test comment from lineark SDK.".to_string()).into(),
+            issue_id: Some(issue_id.clone()).into(),
             ..Default::default()
         };
         let comment_entity = retry_create(|| {
@@ -745,9 +745,9 @@ mod online {
 
         // Create a document.
         let input = DocumentCreateInput {
-            title: Some("[test] SDK document_create_update_and_delete".to_string()),
-            content: Some("Automated test document content.".to_string()),
-            team_id: Some(team_id),
+            title: "[test] SDK document_create_update_and_delete".to_string(),
+            content: Some("Automated test document content.".to_string()).into(),
+            team_id: Some(team_id).into(),
             ..Default::default()
         };
         let doc_entity = retry_create(|| {
@@ -772,8 +772,8 @@ mod online {
 
         // Update the document.
         let update_input = DocumentUpdateInput {
-            title: Some("[test] SDK document — updated".to_string()),
-            content: Some("Updated content.".to_string()),
+            title: Some("[test] SDK document — updated".to_string()).into(),
+            content: Some("Updated content.".to_string()).into(),
             ..Default::default()
         };
         // Just verify the update succeeded.
@@ -814,9 +814,9 @@ mod online {
 
         // Create two issues to relate.
         let input_a = IssueCreateInput {
-            title: Some("[test] relation issue A".to_string()),
-            team_id: Some(team_id.clone()),
-            priority: Some(4),
+            title: Some("[test] relation issue A".to_string()).into(),
+            team_id: team_id.clone(),
+            priority: Some(4).into(),
             ..Default::default()
         };
         let entity_a = retry_create(|| {
@@ -831,9 +831,9 @@ mod online {
         };
 
         let input_b = IssueCreateInput {
-            title: Some("[test] relation issue B".to_string()),
-            team_id: Some(team_id),
-            priority: Some(4),
+            title: Some("[test] relation issue B".to_string()).into(),
+            team_id,
+            priority: Some(4).into(),
             ..Default::default()
         };
         let entity_b = retry_create(|| {
@@ -849,10 +849,10 @@ mod online {
 
         // Create a "blocks" relation: A blocks B.
         let relation_input = IssueRelationCreateInput {
-            issue_id: Some(issue_a_id.clone()),
-            related_issue_id: Some(issue_b_id.clone()),
-            r#type: Some(IssueRelationType::Blocks),
-            ..Default::default()
+            id: lineark_sdk::MaybeUndefined::Undefined,
+            issue_id: issue_a_id.clone(),
+            related_issue_id: issue_b_id.clone(),
+            r#type: IssueRelationType::Blocks,
         };
         let relation_entity = retry_create(|| {
             let relation_input = relation_input.clone();
@@ -979,9 +979,10 @@ mod online {
             title: Some(format!(
                 "[test] SDK batch_update A {}",
                 &uuid::Uuid::new_v4().to_string()[..8]
-            )),
-            team_id: Some(team_id.clone()),
-            priority: Some(4),
+            ))
+            .into(),
+            team_id: team_id.clone(),
+            priority: Some(4).into(),
             ..Default::default()
         };
         let entity_a = retry_create(|| {
@@ -999,9 +1000,10 @@ mod online {
             title: Some(format!(
                 "[test] SDK batch_update B {}",
                 &uuid::Uuid::new_v4().to_string()[..8]
-            )),
-            team_id: Some(team_id),
-            priority: Some(4),
+            ))
+            .into(),
+            team_id,
+            priority: Some(4).into(),
             ..Default::default()
         };
         let entity_b = retry_create(|| {
@@ -1017,7 +1019,7 @@ mod online {
 
         // Batch update both issues' priority.
         let update_input = IssueUpdateInput {
-            priority: Some(2),
+            priority: Some(2).into(),
             ..Default::default()
         };
         let result = client
@@ -1044,7 +1046,7 @@ mod online {
         // Create a team with a unique name.
         let unique = format!("[test] sdk-team {}", &uuid::Uuid::new_v4().to_string()[..8]);
         let input = TeamCreateInput {
-            name: Some(unique.clone()),
+            name: unique.clone(),
             ..Default::default()
         };
         let team = retry_create(|| {
@@ -1062,7 +1064,7 @@ mod online {
 
         // Update the team's description.
         let update_input = TeamUpdateInput {
-            description: Some("Updated by SDK test.".to_string()),
+            description: Some("Updated by SDK test.".to_string()).into(),
             ..Default::default()
         };
         let updated = client
@@ -1094,7 +1096,7 @@ mod online {
             &uuid::Uuid::new_v4().to_string()[..8]
         );
         let input = TeamCreateInput {
-            name: Some(unique),
+            name: unique,
             ..Default::default()
         };
         let team = retry_create(|| {
@@ -1121,8 +1123,8 @@ mod online {
 
         // Add the other user as a member — must succeed cleanly.
         let membership_input = TeamMembershipCreateInput {
-            team_id: Some(team_id.clone()),
-            user_id: Some(other_user_id),
+            team_id: team_id.clone(),
+            user_id: other_user_id,
             ..Default::default()
         };
         let membership = retry_create(|| {
@@ -1164,9 +1166,10 @@ mod online {
             title: Some(format!(
                 "[test] SDK comment_update_changes_body {}",
                 &uuid::Uuid::new_v4().to_string()[..8]
-            )),
-            team_id: Some(team_id),
-            priority: Some(4),
+            ))
+            .into(),
+            team_id,
+            priority: Some(4).into(),
             ..Default::default()
         };
         let issue_entity = retry_create(|| {
@@ -1182,8 +1185,8 @@ mod online {
 
         // Create a comment with the original body.
         let comment_input = CommentCreateInput {
-            body: Some("Original body".to_string()),
-            issue_id: Some(issue_id.clone()),
+            body: Some("Original body".to_string()).into(),
+            issue_id: Some(issue_id.clone()).into(),
             ..Default::default()
         };
         let comment_entity = retry_create(|| {
@@ -1196,7 +1199,7 @@ mod online {
 
         // Update the comment body.
         let update_input = CommentUpdateInput {
-            body: Some("Updated body".to_string()),
+            body: Some("Updated body".to_string()).into(),
             ..Default::default()
         };
         let updated = client
@@ -1225,9 +1228,10 @@ mod online {
             title: Some(format!(
                 "[test] SDK comment_resolve_and_unresolve {}",
                 &uuid::Uuid::new_v4().to_string()[..8]
-            )),
-            team_id: Some(team_id),
-            priority: Some(4),
+            ))
+            .into(),
+            team_id,
+            priority: Some(4).into(),
             ..Default::default()
         };
         let issue_entity = retry_create(|| {
@@ -1243,8 +1247,8 @@ mod online {
 
         // Create a comment.
         let comment_input = CommentCreateInput {
-            body: Some("Thread to resolve".to_string()),
-            issue_id: Some(issue_id.clone()),
+            body: Some("Thread to resolve".to_string()).into(),
+            issue_id: Some(issue_id.clone()).into(),
             ..Default::default()
         };
         let comment_entity = retry_create(|| {
@@ -1298,9 +1302,9 @@ mod online {
         // Create an issue so we can look up its branchName.
         let uid = &uuid::Uuid::new_v4().to_string()[..8];
         let input = IssueCreateInput {
-            title: Some(format!("[test] SDK branch search {uid}")),
-            team_id: Some(team_id),
-            priority: Some(4),
+            title: Some(format!("[test] SDK branch search {uid}")).into(),
+            team_id,
+            priority: Some(4).into(),
             ..Default::default()
         };
         let entity = retry_create(|| {
diff --git a/crates/lineark-test-utils/src/team.rs b/crates/lineark-test-utils/src/team.rs
index 72c198a..c449fd7 100644
--- a/crates/lineark-test-utils/src/team.rs
+++ b/crates/lineark-test-utils/src/team.rs
@@ -20,8 +20,8 @@ pub async fn create_test_team(client: &Client) -> TestTeam {
     let unique = format!("[test] sdk {suffix}");
     let key = format!("T{}", &suffix[..5]).to_uppercase();
     let input = TeamCreateInput {
-        name: Some(unique),
-        key: Some(key),
+        name: unique,
+        key: key.into(),
         ..Default::default()
     };
     let team = retry_create(|| {
diff --git a/crates/lineark/src/commands/comments.rs b/crates/lineark/src/commands/comments.rs
index a4bcb98..bf02f6f 100644
--- a/crates/lineark/src/commands/comments.rs
+++ b/crates/lineark/src/commands/comments.rs
@@ -86,8 +86,8 @@ pub async fn run(cmd: CommentsCmd, client: &Client, format: Format) -> anyhow::R
             let issue_id = resolve_issue_id(client, &issue).await?;
 
             let input = CommentCreateInput {
-                body: Some(body),
-                issue_id: Some(issue_id),
+                body: body.into(),
+                issue_id: issue_id.into(),
                 ..Default::default()
             };
 
@@ -104,7 +104,7 @@ pub async fn run(cmd: CommentsCmd, client: &Client, format: Format) -> anyhow::R
             }
 
             let input = CommentUpdateInput {
-                body,
+                body: body.into(),
                 ..Default::default()
             };
 
diff --git a/crates/lineark/src/commands/documents.rs b/crates/lineark/src/commands/documents.rs
index 0d071fe..f767b85 100644
--- a/crates/lineark/src/commands/documents.rs
+++ b/crates/lineark/src/commands/documents.rs
@@ -199,10 +199,10 @@ pub async fn run(cmd: DocumentsCmd, client: &Client, format: Format) -> anyhow::
             };
 
             let input = DocumentCreateInput {
-                title: Some(title),
-                content,
-                project_id,
-                issue_id,
+                title,
+                content: content.into(),
+                project_id: project_id.into(),
+                issue_id: issue_id.into(),
                 ..Default::default()
             };
 
@@ -221,8 +221,8 @@ pub async fn run(cmd: DocumentsCmd, client: &Client, format: Format) -> anyhow::
             }
 
             let input = DocumentUpdateInput {
-                title,
-                content,
+                title: title.into(),
+                content: content.into(),
                 ..Default::default()
             };
 
diff --git a/crates/lineark/src/commands/issues.rs b/crates/lineark/src/commands/issues.rs
index 1d7e8fe..d249859 100644
--- a/crates/lineark/src/commands/issues.rs
+++ b/crates/lineark/src/commands/issues.rs
@@ -6,7 +6,7 @@ use lineark_sdk::generated::types::{
     Comment, CommentConnection, Issue, IssueConnection, IssueLabel, IssueLabelConnection,
     IssueRelation, IssueRelationConnection, IssueSearchResult, User, WorkflowState,
 };
-use lineark_sdk::{Client, GraphQLFields};
+use lineark_sdk::{Client, GraphQLFields, MaybeUndefined};
 use serde::{Deserialize, Serialize};
 use tabled::Tabled;
 
@@ -722,17 +722,17 @@ pub async fn run(cmd: IssuesCmd, client: &Client, format: Format) -> anyhow::Res
             };
 
             let input = IssueCreateInput {
-                title: Some(title),
-                team_id: Some(team_id),
-                assignee_id,
-                label_ids,
-                priority,
-                estimate,
-                description,
-                parent_id,
-                state_id,
-                project_id,
-                cycle_id,
+                title: title.into(),
+                team_id,
+                assignee_id: assignee_id.into(),
+                label_ids: label_ids.into(),
+                priority: priority.into(),
+                estimate: estimate.into(),
+                description: description.into(),
+                parent_id: parent_id.into(),
+                state_id: state_id.into(),
+                project_id: project_id.into(),
+                cycle_id: cycle_id.into(),
                 ..Default::default()
             };
 
@@ -862,14 +862,14 @@ pub async fn run(cmd: IssuesCmd, client: &Client, format: Format) -> anyhow::Res
             };
 
             let input = IssueUpdateInput {
-                assignee_id,
-                priority,
-                state_id,
-                label_ids,
-                added_label_ids,
-                removed_label_ids,
-                project_id,
-                cycle_id,
+                assignee_id: assignee_id.into(),
+                priority: priority.into(),
+                state_id: state_id.into(),
+                label_ids: label_ids.into(),
+                added_label_ids: added_label_ids.into(),
+                removed_label_ids: removed_label_ids.into(),
+                project_id: project_id.into(),
+                cycle_id: cycle_id.into(),
                 ..Default::default()
             };
 
@@ -978,49 +978,32 @@ pub async fn run(cmd: IssuesCmd, client: &Client, format: Format) -> anyhow::Res
                 (None, None, None)
             };
 
+            let parent_id = if clear_parent {
+                MaybeUndefined::Null
+            } else {
+                parent_id.into()
+            };
+
             let input = IssueUpdateInput {
-                title,
-                description,
-                assignee_id,
-                priority,
-                estimate,
-                state_id,
+                title: title.into(),
+                description: description.into(),
+                assignee_id: assignee_id.into(),
+                priority: priority.into(),
+                estimate: estimate.into(),
+                state_id: state_id.into(),
                 parent_id,
-                label_ids,
-                added_label_ids,
-                removed_label_ids,
-                project_id,
-                cycle_id,
+                label_ids: label_ids.into(),
+                added_label_ids: added_label_ids.into(),
+                removed_label_ids: removed_label_ids.into(),
+                project_id: project_id.into(),
+                cycle_id: cycle_id.into(),
                 ..Default::default()
             };
 
-            // When --clear-parent is used, we need to send `parentId: null` to
-            // the API. The generated IssueUpdateInput uses skip_serializing_if
-            // so None omits the field (no-op). We serialize to Value and inject null.
-            let issue = if clear_parent {
-                let mut input_val = serde_json::to_value(&input)?;
-                input_val
-                    .as_object_mut()
-                    .unwrap()
-                    .insert("parentId".to_string(), serde_json::Value::Null);
-                let variables = serde_json::json!({ "input": input_val, "id": issue_id });
-                let sel = <IssueRef as GraphQLFields>::selection();
-                let query = format!(
-                    "mutation($input: IssueUpdateInput!, $id: String!) {{ issueUpdate(input: $input, id: $id) {{ success issue {{ {sel} }} }} }}"
-                );
-                let payload: serde_json::Value = client
-                    .execute(&query, variables, "issueUpdate")
-                    .await
-                    .map_err(|e| anyhow::anyhow!("{}", e))?;
-                serde_json::from_value::<IssueRef>(
-                    payload.get("issue").cloned().unwrap_or_default(),
-                )?
-            } else {
-                client
-                    .issue_update::<IssueRef>(input, issue_id)
-                    .await
-                    .map_err(|e| anyhow::anyhow!("{}", e))?
-            };
+            let issue = client
+                .issue_update::<IssueRef>(input, issue_id)
+                .await
+                .map_err(|e| anyhow::anyhow!("{}", e))?;
 
             output::print_one(&issue, format);
         }
diff --git a/crates/lineark/src/commands/labels.rs b/crates/lineark/src/commands/labels.rs
index 38fd129..018980e 100644
--- a/crates/lineark/src/commands/labels.rs
+++ b/crates/lineark/src/commands/labels.rs
@@ -3,7 +3,7 @@ use lineark_sdk::generated::inputs::{
     IssueLabelCreateInput, IssueLabelFilter, IssueLabelUpdateInput,
 };
 use lineark_sdk::generated::types::IssueLabel;
-use lineark_sdk::{Client, GraphQLFields};
+use lineark_sdk::{Client, GraphQLFields, MaybeUndefined};
 use serde::{Deserialize, Serialize};
 use tabled::Tabled;
 
@@ -246,12 +246,16 @@ pub async fn run(cmd: LabelsCmd, client: &Client, format: Format) -> anyhow::Res
             };
 
             let input = IssueLabelCreateInput {
-                name: Some(name),
-                color,
-                description,
-                parent_id: parent_label_group,
-                team_id,
-                is_group: if make_label_group { Some(true) } else { None },
+                name,
+                color: color.into(),
+                description: description.into(),
+                parent_id: parent_label_group.into(),
+                team_id: team_id.into(),
+                is_group: if make_label_group {
+                    MaybeUndefined::Value(true)
+                } else {
+                    MaybeUndefined::Undefined
+                },
                 ..Default::default()
             };
 
@@ -286,48 +290,32 @@ pub async fn run(cmd: LabelsCmd, client: &Client, format: Format) -> anyhow::Res
             }
 
             let is_group = if make_label_group {
-                Some(true)
+                MaybeUndefined::Value(true)
             } else if clear_label_group {
-                Some(false)
+                MaybeUndefined::Value(false)
             } else {
-                None
+                MaybeUndefined::Undefined
+            };
+
+            let parent_id = if clear_parent_label_group {
+                MaybeUndefined::Null
+            } else {
+                parent_label_group.into()
             };
 
             let input = IssueLabelUpdateInput {
-                name,
-                color,
-                description,
-                parent_id: parent_label_group,
+                name: name.into(),
+                color: color.into(),
+                description: description.into(),
+                parent_id,
                 is_group,
                 ..Default::default()
             };
 
-            // When --clear-parent-label-group is used, send `parentId: null` to the API.
-            // The generated input uses skip_serializing_if so None omits the field.
-            let label = if clear_parent_label_group {
-                let mut input_val = serde_json::to_value(&input)?;
-                input_val
-                    .as_object_mut()
-                    .unwrap()
-                    .insert("parentId".to_string(), serde_json::Value::Null);
-                let variables = serde_json::json!({ "input": input_val, "id": id });
-                let sel = <LabelRef as GraphQLFields>::selection();
-                let query = format!(
-                    "mutation($input: IssueLabelUpdateInput!, $id: String!) {{ issueLabelUpdate(input: $input, id: $id) {{ success issueLabel {{ {sel} }} }} }}"
-                );
-                let payload: serde_json::Value = client
-                    .execute(&query, variables, "issueLabelUpdate")
-                    .await
-                    .map_err(|e| anyhow::anyhow!("{}", e))?;
-                serde_json::from_value::<LabelRef>(
-                    payload.get("issueLabel").cloned().unwrap_or_default(),
-                )?
-            } else {
-                client
-                    .issue_label_update::<LabelRef>(None, input, id)
-                    .await
-                    .map_err(|e| anyhow::anyhow!("{}", e))?
-            };
+            let label = client
+                .issue_label_update::<LabelRef>(None, input, id)
+                .await
+                .map_err(|e| anyhow::anyhow!("{}", e))?;
 
             output::print_one(&label, format);
         }
diff --git a/crates/lineark/src/commands/milestones.rs b/crates/lineark/src/commands/milestones.rs
index 9fae30f..622daeb 100644
--- a/crates/lineark/src/commands/milestones.rs
+++ b/crates/lineark/src/commands/milestones.rs
@@ -205,10 +205,10 @@ pub async fn run(cmd: MilestonesCmd, client: &Client, format: Format) -> anyhow:
                 .map_err(|e| anyhow::anyhow!("Invalid date format (expected YYYY-MM-DD): {}", e))?;
 
             let input = ProjectMilestoneCreateInput {
-                name: Some(name),
-                project_id: Some(project_id),
-                target_date,
-                description,
+                name,
+                project_id,
+                target_date: target_date.into(),
+                description: description.into(),
                 ..Default::default()
             };
 
@@ -240,9 +240,9 @@ pub async fn run(cmd: MilestonesCmd, client: &Client, format: Format) -> anyhow:
                 .map_err(|e| anyhow::anyhow!("Invalid date format (expected YYYY-MM-DD): {}", e))?;
 
             let input = ProjectMilestoneUpdateInput {
-                name,
-                target_date,
-                description,
+                name: name.into(),
+                target_date: target_date.into(),
+                description: description.into(),
                 ..Default::default()
             };
 
diff --git a/crates/lineark/src/commands/projects.rs b/crates/lineark/src/commands/projects.rs
index 4e77363..36cf632 100644
--- a/crates/lineark/src/commands/projects.rs
+++ b/crates/lineark/src/commands/projects.rs
@@ -3,7 +3,7 @@ use lineark_sdk::generated::inputs::{ProjectCreateInput, ProjectFilter, ProjectU
 use lineark_sdk::generated::types::{
     Project, ProjectStatus, Team, TeamConnection, User, UserConnection,
 };
-use lineark_sdk::{Client, GraphQLFields};
+use lineark_sdk::{Client, GraphQLFields, MaybeUndefined};
 use serde::{Deserialize, Serialize};
 use tabled::Tabled;
 
@@ -336,17 +336,17 @@ pub async fn run(cmd: ProjectsCmd, client: &Client, format: Format) -> anyhow::R
                 .map_err(|e| anyhow::anyhow!("Invalid target-date (expected YYYY-MM-DD): {}", e))?;
 
             let input = ProjectCreateInput {
-                name: Some(name),
-                team_ids: Some(team_ids),
-                description,
-                lead_id,
-                member_ids,
-                start_date,
-                target_date,
-                priority,
-                content,
-                icon,
-                color,
+                name,
+                team_ids,
+                description: description.into(),
+                lead_id: lead_id.into(),
+                member_ids: member_ids.into(),
+                start_date: start_date.into(),
+                target_date: target_date.into(),
+                priority: priority.into(),
+                content: content.into(),
+                icon: icon.into(),
+                color: color.into(),
                 ..Default::default()
             };
 
@@ -435,56 +435,43 @@ pub async fn run(cmd: ProjectsCmd, client: &Client, format: Format) -> anyhow::R
                 .transpose()
                 .map_err(|e| anyhow::anyhow!("Invalid target-date (expected YYYY-MM-DD): {}", e))?;
 
+            let lead_id = if clear_lead {
+                MaybeUndefined::Null
+            } else {
+                lead_id.into()
+            };
+            let start_date = if clear_start_date {
+                MaybeUndefined::Null
+            } else {
+                start_date.into()
+            };
+            let target_date = if clear_target_date {
+                MaybeUndefined::Null
+            } else {
+                target_date.into()
+            };
+
             let input = ProjectUpdateInput {
-                name,
-                description,
-                content,
+                name: name.into(),
+                description: description.into(),
+                content: content.into(),
                 lead_id,
-                member_ids,
-                team_ids,
+                member_ids: member_ids.into(),
+                team_ids: team_ids.into(),
                 start_date,
                 target_date,
-                priority,
-                status_id,
-                icon,
-                color,
-                label_ids,
+                priority: priority.into(),
+                status_id: status_id.into(),
+                icon: icon.into(),
+                color: color.into(),
+                label_ids: label_ids.into(),
                 ..Default::default()
             };
 
-            // When --clear-* flags are used, we need to send `null` for the
-            // relevant field. ProjectUpdateInput uses skip_serializing_if so
-            // None omits the field (no-op). We serialize to Value and inject null.
-            let project = if clear_lead || clear_start_date || clear_target_date {
-                let mut input_val = serde_json::to_value(&input)?;
-                let obj = input_val.as_object_mut().unwrap();
-                if clear_lead {
-                    obj.insert("leadId".to_string(), serde_json::Value::Null);
-                }
-                if clear_start_date {
-                    obj.insert("startDate".to_string(), serde_json::Value::Null);
-                }
-                if clear_target_date {
-                    obj.insert("targetDate".to_string(), serde_json::Value::Null);
-                }
-                let variables = serde_json::json!({ "input": input_val, "id": project_id });
-                let sel = <ProjectRef as GraphQLFields>::selection();
-                let query = format!(
-                    "mutation($input: ProjectUpdateInput!, $id: String!) {{ projectUpdate(input: $input, id: $id) {{ success project {{ {sel} }} }} }}"
-                );
-                let payload: serde_json::Value = client
-                    .execute(&query, variables, "projectUpdate")
-                    .await
-                    .map_err(|e| anyhow::anyhow!("{}", e))?;
-                serde_json::from_value::<ProjectRef>(
-                    payload.get("project").cloned().unwrap_or_default(),
-                )?
-            } else {
-                client
-                    .project_update::<ProjectRef>(input, project_id)
-                    .await
-                    .map_err(|e| anyhow::anyhow!("{}", e))?
-            };
+            let project = client
+                .project_update::<ProjectRef>(input, project_id)
+                .await
+                .map_err(|e| anyhow::anyhow!("{}", e))?;
 
             output::print_one(&project, format);
         }
diff --git a/crates/lineark/src/commands/relations.rs b/crates/lineark/src/commands/relations.rs
index b39f5a1..97d9de1 100644
--- a/crates/lineark/src/commands/relations.rs
+++ b/crates/lineark/src/commands/relations.rs
@@ -2,7 +2,7 @@ use clap::Args;
 use lineark_sdk::generated::enums::IssueRelationType;
 use lineark_sdk::generated::inputs::IssueRelationCreateInput;
 use lineark_sdk::generated::types::IssueRelation;
-use lineark_sdk::{Client, GraphQLFields};
+use lineark_sdk::{Client, GraphQLFields, MaybeUndefined};
 use serde::{Deserialize, Serialize};
 
 use super::helpers::resolve_issue_id;
@@ -98,10 +98,10 @@ pub async fn run(cmd: RelationsCmd, client: &Client, format: Format) -> anyhow::
             let target_id = resolve_issue_id(client, target).await?;
 
             let input = IssueRelationCreateInput {
-                issue_id: Some(source_id),
-                related_issue_id: Some(target_id),
-                r#type: Some(relation_type),
-                ..Default::default()
+                id: MaybeUndefined::Undefined,
+                r#type: relation_type,
+                issue_id: source_id,
+                related_issue_id: target_id,
             };
 
             let relation = client
diff --git a/crates/lineark/src/commands/teams.rs b/crates/lineark/src/commands/teams.rs
index d62ac20..b3c929f 100644
--- a/crates/lineark/src/commands/teams.rs
+++ b/crates/lineark/src/commands/teams.rs
@@ -253,15 +253,15 @@ pub async fn run(cmd: TeamsCmd, client: &Client, format: Format) -> anyhow::Resu
             triage_enabled,
         } => {
             let input = TeamCreateInput {
-                name: Some(name),
-                key,
-                description,
-                icon,
-                color,
-                timezone,
-                private,
-                cycles_enabled,
-                triage_enabled,
+                name,
+                key: key.into(),
+                description: description.into(),
+                icon: icon.into(),
+                color: color.into(),
+                timezone: timezone.into(),
+                private: private.into(),
+                cycles_enabled: cycles_enabled.into(),
+                triage_enabled: triage_enabled.into(),
                 ..Default::default()
             };
 
@@ -302,15 +302,15 @@ pub async fn run(cmd: TeamsCmd, client: &Client, format: Format) -> anyhow::Resu
             let team_id = resolve_team_id(client, &id).await?;
 
             let input = TeamUpdateInput {
-                name,
-                key,
-                description,
-                icon,
-                color,
-                timezone,
-                private,
-                cycles_enabled,
-                triage_enabled,
+                name: name.into(),
+                key: key.into(),
+                description: description.into(),
+                icon: icon.into(),
+                color: color.into(),
+                timezone: timezone.into(),
+                private: private.into(),
+                cycles_enabled: cycles_enabled.into(),
+                triage_enabled: triage_enabled.into(),
                 ..Default::default()
             };
 
@@ -337,8 +337,8 @@ pub async fn run(cmd: TeamsCmd, client: &Client, format: Format) -> anyhow::Resu
                 let user_id = resolve_user_id_or_me(client, &user).await?;
 
                 let input = TeamMembershipCreateInput {
-                    team_id: Some(team_id),
-                    user_id: Some(user_id),
+                    team_id,
+                    user_id,
                     ..Default::default()
                 };
 
diff --git a/crates/lineark/tests/online.rs b/crates/lineark/tests/online.rs
index 0edb704..fea7ebe 100644
--- a/crates/lineark/tests/online.rs
+++ b/crates/lineark/tests/online.rs
@@ -1858,10 +1858,10 @@ mod online {
             use lineark_sdk::generated::inputs::IssueRelationCreateInput;
             let client = Client::from_token(test_token()).unwrap();
             let input = IssueRelationCreateInput {
-                issue_id: Some(issue_a_id.clone()),
-                related_issue_id: Some(issue_b_id.clone()),
-                r#type: Some(IssueRelationType::Blocks),
-                ..Default::default()
+                id: lineark_sdk::MaybeUndefined::Undefined,
+                issue_id: issue_a_id.clone(),
+                related_issue_id: issue_b_id.clone(),
+                r#type: IssueRelationType::Blocks,
             };
             tokio::runtime::Runtime::new().unwrap().block_on(async {
                 client
@@ -2268,8 +2268,8 @@ mod online {
         let rt = tokio::runtime::Runtime::new().unwrap();
         let project: Project = rt.block_on(async {
             let input = ProjectCreateInput {
-                name: Some(project_label.clone()),
-                team_ids: Some(vec![team_id]),
+                name: project_label.clone(),
+                team_ids: vec![team_id],
                 ..Default::default()
             };
             retry_create(|| {
@@ -3971,9 +3971,10 @@ mod online {
                     title: Some(format!(
                         "[test] CLI comments_lifecycle {}",
                         &uuid::Uuid::new_v4().to_string()[..8]
-                    )),
-                    team_id: Some(team_id),
-                    priority: Some(4),
+                    ))
+                    .into(),
+                    team_id,
+                    priority: Some(4).into(),
                     ..Default::default()
                 })
                 .await
@@ -4128,9 +4129,10 @@ mod online {
                     title: Some(format!(
                         "[test] CLI comments_resolve_with_resolving_comment {}",
                         &uuid::Uuid::new_v4().to_string()[..8]
-                    )),
-                    team_id: Some(team_id),
-                    priority: Some(4),
+                    ))
+                    .into(),
+                    team_id,
+                    priority: Some(4).into(),
                     ..Default::default()
                 })
                 .await
@@ -4171,9 +4173,9 @@ mod online {
         let reply = tokio::runtime::Runtime::new().unwrap().block_on(async {
             client
                 .comment_create::<Comment>(CommentCreateInput {
-                    body: Some("Reply that resolves thread".to_string()),
-                    issue_id: Some(issue_id.clone()),
-                    parent_id: Some(parent_id.clone()),
+                    body: Some("Reply that resolves thread".to_string()).into(),
+                    issue_id: Some(issue_id.clone()).into(),
+                    parent_id: Some(parent_id.clone()).into(),
                     ..Default::default()
                 })
                 .await
@@ -4230,9 +4232,10 @@ mod online {
                 title: Some(format!(
                     "[test] CLI find-branch {}",
                     &uuid::Uuid::new_v4().to_string()[..8]
-                )),
-                team_id: Some(team_id),
-                priority: Some(4),
+                ))
+                .into(),
+                team_id,
+                priority: Some(4).into(),
                 ..Default::default()
             };
             let entity = retry_create(|| {
@@ -4639,9 +4642,10 @@ mod online {
                     title: Some(format!(
                         "[test] CLI batch-update A {}",
                         &uuid::Uuid::new_v4().to_string()[..8]
-                    )),
-                    team_id: Some(team_id.clone()),
-                    priority: Some(4),
+                    ))
+                    .into(),
+                    team_id: team_id.clone(),
+                    priority: Some(4).into(),
                     ..Default::default()
                 })
                 .await
@@ -4659,9 +4663,10 @@ mod online {
                     title: Some(format!(
                         "[test] CLI batch-update B {}",
                         &uuid::Uuid::new_v4().to_string()[..8]
-                    )),
-                    team_id: Some(team_id),
-                    priority: Some(4),
+                    ))
+                    .into(),
+                    team_id,
+                    priority: Some(4).into(),
                     ..Default::default()
                 })
                 .await
@@ -4717,9 +4722,10 @@ mod online {
                     title: Some(format!(
                         "[test] CLI batch-update status A {}",
                         &uuid::Uuid::new_v4().to_string()[..8]
-                    )),
-                    team_id: Some(team_id.clone()),
-                    priority: Some(4),
+                    ))
+                    .into(),
+                    team_id: team_id.clone(),
+                    priority: Some(4).into(),
                     ..Default::default()
                 })
                 .await
@@ -4737,9 +4743,10 @@ mod online {
                     title: Some(format!(
                         "[test] CLI batch-update status B {}",
                         &uuid::Uuid::new_v4().to_string()[..8]
-                    )),
-                    team_id: Some(team_id),
-                    priority: Some(4),
+                    ))
+                    .into(),
+                    team_id,
+                    priority: Some(4).into(),
                     ..Default::default()
                 })
                 .await
diff --git a/schema/schema.graphql b/schema/schema.graphql
index 86e6fe0..ebdeed6 100644
--- a/schema/schema.graphql
+++ b/schema/schema.graphql
@@ -43,6 +43,152 @@
   commentThread
 }
 
+"The action performed on the entity (leave empty if just found)" enum AiConversationEntityCardWidgetArgsAction {
+  created
+  updated
+}
+
+"[Internal] The entity type" enum AiConversationEntityCardWidgetArgsType {
+  Issue
+  Project
+  Initiative
+  InitiativeUpdate
+  ProjectUpdate
+  WorkflowDefinition
+  Team
+  Template
+  Customer
+  CustomerNeed
+  Document
+  CustomView
+  Dashboard
+  PullRequest
+  Release
+  ReleasePipeline
+  AiPrompt
+}
+
+"The action performed on the entities (leave empty if just found)" enum AiConversationEntityListWidgetArgsAction {
+  created
+  updated
+}
+
+"[Internal] The entity type" enum AiConversationEntityListWidgetArgsEntitiesType {
+  Issue
+  Project
+  Initiative
+  InitiativeUpdate
+  ProjectUpdate
+  WorkflowDefinition
+  Team
+  Template
+  Customer
+  CustomerNeed
+  Document
+  CustomView
+  Dashboard
+  PullRequest
+  Release
+  ReleasePipeline
+  AiPrompt
+}
+
+"The initial source of an AI conversation." enum AiConversationInitialSource {
+  slack
+  microsoftTeams
+  mcp
+  directChat
+  comment
+  pullRequestComment
+  workflow
+}
+
+"The phase during which a conversation part was generated." enum AiConversationPartPhase {
+  commentary
+  answer
+}
+
+"The type of a part in an AI conversation." enum AiConversationPartType {
+  prompt
+  toolCall
+  reasoning
+  text
+  widget
+  widgetPlaceholder
+}
+
+enum AiConversationQueryUpdatesToolCallArgsUpdateType {
+  ProjectUpdate
+  InitiativeUpdate
+}
+
+enum AiConversationQueryViewToolCallArgsMode {
+  list
+  insight
+}
+
+"The status of an AI conversation." enum AiConversationStatus {
+  active
+  complete
+  awaitingInput
+  error
+  pending
+}
+
+"The name of a tool that was called in an AI conversation." enum AiConversationTool {
+  SearchEntities
+  RetrieveEntities
+  QueryView
+  QueryActivity
+  QueryUpdates
+  SuggestValues
+  CreateEntity
+  UpdateEntity
+  DeleteEntity
+  RestoreEntity
+  Research
+  CodeIntelligence
+  GetPullRequestDiff
+  GetPullRequestFile
+  HandoffToCodingSession
+  TranscribeVideo
+  TranscribeMedia
+  SearchDocumentation
+  WebSearch
+  GetSlackConversationHistory
+  GetMicrosoftTeamsConversationHistory
+  NavigateToPage
+  InvokeMcpTool
+}
+
+"The name of a widget in an AI conversation." enum AiConversationWidgetName {
+  EntityCard
+  EntityList
+}
+
+"[Internal] The status of a prompt workflow." enum AiPromptProgressStatus {
+  created
+  inProgress
+  finished
+  failed
+  canceled
+}
+
+"The type of AI prompt workflow." enum AiPromptType {
+  productIntelligence
+  internalResearch
+  projectUpdates
+  initiativeUpdates
+  agentGuidance
+  codeIntelligence
+  aiConversation
+  slackIssueIntake
+  intercomIssueIntake
+  gongIssueIntake
+  zendeskIssueIntake
+  microsoftTeamsIssueIntake
+}
+
 enum AuthenticationSessionType {
   web
   desktop
@@ -122,7 +268,7 @@ enum FacetPageSource {
   weekly
 }
 
-"The various states of a pull/merge request." enum GitAutomationStates {
+"The Git events that can trigger an automation rule. Each value corresponds to a pull/merge request lifecycle event (e.g., branch created, PR opened for review, PR merged)." enum GitAutomationStates {
   draft
   start
   review
@@ -192,6 +338,7 @@ enum InitiativeStatus {
   salesforce
   slack
   slackAsks
+  asksWeb
   slackCustomViewNotifications
   slackOrgProjectUpdatesPost
   slackOrgInitiativeUpdatesPost
@@ -206,6 +353,8 @@ enum InitiativeStatus {
   mcpServerPersonal
   mcpServer
   microsoftTeams
+  microsoftPersonal
+  microsoftTeamsProjectPost
 }
 
 "The type of the issue relation." enum IssueRelationType {
@@ -215,14 +364,27 @@ enum InitiativeStatus {
   similar
 }
 
-enum IssueSuggestionState {
+"Issue update fields that are disallowed for users with only shared access." enum IssueSharedAccessDisallowedField {
+  projectId
+  teamId
+  cycleId
+  projectMilestoneId
+}
+
+"Policy controlling whether and by whom issues in a team can be shared with non-team-members." enum IssueSharingPolicy {
+  disabled
+  adminsOnly
+  allMembers
+}
+
+"The state of an issue suggestion, indicating whether it is active, accepted, or dismissed." enum IssueSuggestionState {
   active
   stale
   accepted
   dismissed
 }
 
-enum IssueSuggestionType {
+"The type of an issue suggestion, indicating what kind of entity is being suggested (e.g., similar issue, assignee, label, team, project)." enum IssueSuggestionType {
   team
   project
   assignee
@@ -336,6 +498,13 @@ enum IssueSuggestionType {
   never
 }
 
+"[ALPHA] How a pull request check should be opened in the client." enum PullRequestCheckPresentation {
+  jobLogs
+  runLogs
+  markdown
+  externalOnly
+}
+
 "The method used to merge a pull request." enum PullRequestMergeMethod {
   MERGE
   REBASE
@@ -372,19 +541,19 @@ enum PullRequestReviewTool {
   public
 }
 
-"A type of release pipeline." enum ReleasePipelineType {
+"The type of a release pipeline, which determines how releases are created and managed. Continuous pipelines create a new completed release for each sync. Scheduled pipelines accumulate issues into a started release that is explicitly completed." enum ReleasePipelineType {
   continuous
   scheduled
 }
 
-"A type of release stage." enum ReleaseStageType {
+"The type of a release stage, which determines the release's lifecycle state. Types include planned, started, completed, and canceled. Each pipeline must have at least one stage of each type, though only started stages may have multiple instances." enum ReleaseStageType {
   planned
   started
   completed
   canceled
 }
 
-enum SLADayCountType {
+"Which day count to use for SLA calculations." enum SLADayCountType {
   all
   onlyBusinessDays
 }
@@ -445,6 +614,7 @@ enum SlackChannelType {
   cycle
   default
   labelGroupConflict
+  codingAgentQuotaExceeded
 }
 
 enum UserContextViewType {
@@ -485,6 +655,8 @@ enum UserContextViewType {
   tryCyclesDismissed
   tryTriageDismissed
   tryGithubDismissed
+  tryCursorDismissed
+  tryCodexDismissed
   rewindBannerDismissed
   helpIslandFeatureInsightsDismissed
   dueDateShortcutMigration
@@ -498,7 +670,11 @@ enum UserContextViewType {
   initiativesBannerDismissed
   commandMenuClearShortcutTip
   slackBotWelcomeMessageShown
+  teamsBotWelcomeMessageShown
   slackAgentPromoFromCreateNewIssueShown
+  agentExamplesDismissed
+  agentHomePageNotice
+  agentHomeHeadlineSeen
   all
 }
 
@@ -509,7 +685,7 @@ enum UserContextViewType {
   lock
 }
 
-"The different permission roles available to users on an organization." enum UserRoleType {
+"The different permission roles available to users in a workspace." enum UserRoleType {
   owner
   admin
   guest
@@ -537,7 +713,7 @@ enum UserContextViewType {
   custom
 }
 
-"The type of view preferences (either user or organization level preferences)." enum ViewPreferencesType {
+"The type of view preferences (either user or workspace level preferences)." enum ViewPreferencesType {
   organization
   user
 }
@@ -556,6 +732,7 @@ enum UserContextViewType {
   cycle
   release
   continuousPipelineReleases
+  scheduledPipelineReleases
   project
   projectDocuments
   label
@@ -592,6 +769,7 @@ enum UserContextViewType {
   myReviews
   createdReviews
   agents
+  focus
   feedAll
   feedCreated
   feedFollowing
@@ -616,13 +794,16 @@ enum WorkflowTrigger {
 enum WorkflowTriggerType {
   issue
   project
+  release
 }
 
 enum WorkflowType {
   sla
-  custom
+  automation
   viewSubscription
   triage
+  triageAutomation
+  release
 }
 
 "Activity collection filtering options." input ActivityCollectionFilter {
@@ -646,7 +827,7 @@ enum WorkflowType {
   "Compound filters, one of which need to be matched by the activity."   or: [ActivityFilter!]
 }
 
-input AgentActivityCreateInput {
+"Input for creating an agent activity." input AgentActivityCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The agent session this activity belongs to."   agentSessionId: String!
   "An optional modifier that provides additional instructions on how the activity should be interpreted."   signal: AgentActivitySignal
@@ -682,23 +863,23 @@ See https://linear.app/developers/agent-interaction#activity-content-payload for
 "[Internal] Input for creating prompt-type agent activities (created by users)." input AgentActivityPromptCreateInputContent {
   "The type of activity."   type: AgentActivityType! = prompt
   "A message requesting additional information or action from user in markdown format."   body: String
-  "[Internal] The prompt content as a ProseMirror document."   bodyData: JSONObject
+  "[Internal] The prompt content as a ProseMirror document."   bodyData: JSON
 }
 
-input AgentSessionCreateInput {
+"[Internal] Input for creating an agent session on behalf of the current user." input AgentSessionCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The issue that this session will be associated with. Can be a UUID or issue identifier (e.g., 'LIN-123')."   issueId: String
   "The app user (agent) to create a session for."   appUserId: String!
   "[Internal] Serialized JSON representing the page contexts this session is related to. Used for direct chat sessions to provide context about the current page (e.g., Issue, Project)."   context: JSONObject
 }
 
-input AgentSessionCreateOnComment {
+"Input for creating an agent session on a root comment." input AgentSessionCreateOnComment {
   "The root comment that this session will be associated with."   commentId: String!
   "The URL of an external agent-hosted page associated with this session."   externalLink: String
   "URLs of external resources associated with this session."   externalUrls: [AgentSessionExternalUrlInput!]
 }
 
-input AgentSessionCreateOnIssue {
+"Input for creating an agent session on an issue." input AgentSessionCreateOnIssue {
   "The issue that this session will be associated with. Can be a UUID or issue identifier (e.g., 'LIN-123')."   issueId: String!
   "The URL of an external agent-hosted page associated with this session."   externalLink: String
   "URLs of external resources associated with this session."   externalUrls: [AgentSessionExternalUrlInput!]
@@ -709,20 +890,20 @@ input AgentSessionCreateOnIssue {
   "Label for the URL."   label: String!
 }
 
-input AgentSessionUpdateExternalUrlInput {
+"Input for updating the external URLs of an agent session." input AgentSessionUpdateExternalUrlInput {
   "The URL of an external agent-hosted page associated with this session."   externalLink: String
   "URLs of external resources associated with this session. Replaces existing URLs."   externalUrls: [AgentSessionExternalUrlInput!]
   "URLs of external resources to be added to this session."   addedExternalUrls: [AgentSessionExternalUrlInput!]
   "URLs to be removed from this session."   removedExternalUrls: [String!]
 }
 
-input AgentSessionUpdateInput {
+"Input for updating an agent session." input AgentSessionUpdateInput {
   "The URL of an external agent-hosted page associated with this session. Only updatable by the OAuth application that owns the session."   externalLink: String
   "URLs of external resources associated with this session. Replaces existing URLs. Only updatable by the OAuth application that owns the session. If supplied, addedExternalUrls and removedExternalUrls are ignored."   externalUrls: [AgentSessionExternalUrlInput!]
   "URLs of external resources to be added to this session. Only updatable by the OAuth application that owns the session."   addedExternalUrls: [AgentSessionExternalUrlInput!]
   "URLs to be removed from this session. Only updatable by the OAuth application that owns the session."   removedExternalUrls: [String!]
   "A dynamically updated list of the agent's execution strategy. Only updatable by the OAuth application that owns the session."   plan: JSONObject
-  "[Internal] The time the agent session was dismissed. Only updatable by internal clients."   dismissedAt: DateTime
+  "[Internal] The time at which the agent session was dismissed. Set to null to un-dismiss. Only updatable by internal clients."   dismissedAt: DateTime
   "[Internal] User-specific state for the agent session. Only updatable by internal clients."   userState: [AgentSessionUserStateInput!]
 }
 
@@ -731,51 +912,47 @@ input AgentSessionUserStateInput {
   "The time at which the user most recently viewed the session."   lastReadAt: DateTime
 }
 
-input AirbyteConfigurationInput {
-  "Linear export API key."   apiKey: String!
-}
-
-"Customer approximate need count sorting options." input ApproximateNeedCountSort {
-  "Whether nulls should be sorted first or last"   nulls: PaginationNulls = last
-  "The order for the individual sort"   order: PaginationSortOrder
+"[Internal] AI prompt progress filtering options." input AiPromptProgressFilter {
+  "Comparator for the identifier."   id: IDComparator
+  "Comparator for the created at date."   createdAt: DateComparator
+  "Comparator for the updated at date."   updatedAt: DateComparator
+  "[Internal] Comparator for the AI prompt workflow type."   type: AiPromptTypeComparator
+  "[Internal] Comparator for the AI prompt workflow status."   status: AiPromptProgressStatusComparator
+  "[Internal] Compound filters, all of which need to be matched by the AI prompt progress."   and: [AiPromptProgressFilter!]
+  "[Internal] Compound filters, one of which need to be matched by the AI prompt progress."   or: [AiPromptProgressFilter!]
 }
 
-input AsksWebPageCreateInput {
-  "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
-  "The identifier of the Asks web settings this page belongs to."   asksWebSettingsId: String!
-  "The title of the page."   title: String!
-  "The description of the page."   description: String
-  "The auto-reply message for issue created. If not set, the default reply will be used."   issueCreatedAutoReply: String
-  "Whether the auto-reply for issue created is enabled."   issueCreatedAutoReplyEnabled: Boolean
-  "The auto-reply message for issue completed. If not set, the default reply will be used."   issueCompletedAutoReply: String
-  "Whether the auto-reply for issue completed is enabled."   issueCompletedAutoReplyEnabled: Boolean
-  "The auto-reply message for issue canceled. If not set, the default reply will be used."   issueCanceledAutoReply: String
-  "Whether the auto-reply for issue canceled is enabled."   issueCanceledAutoReplyEnabled: Boolean
+"[Internal] Comparator for the AI prompt workflow status." input AiPromptProgressStatusComparator {
+  "Equals constraint."   eq: AiPromptProgressStatus
+  "Not-equals constraint."   neq: AiPromptProgressStatus
+  "In-array constraint."   in: [AiPromptProgressStatus!]
+  "Not-in-array constraint."   nin: [AiPromptProgressStatus!]
+  "Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values."   null: Boolean
 }
 
-input AsksWebPageUpdateInput {
-  "The title of the page."   title: String
-  "The description of the page."   description: String
-  "The auto-reply message for issue created. If not set, the default reply will be used."   issueCreatedAutoReply: String
-  "Whether the auto-reply for issue created is enabled."   issueCreatedAutoReplyEnabled: Boolean
-  "The auto-reply message for issue completed. If not set, the default reply will be used."   issueCompletedAutoReply: String
-  "Whether the auto-reply for issue completed is enabled."   issueCompletedAutoReplyEnabled: Boolean
-  "The auto-reply message for issue canceled. If not set, the default reply will be used."   issueCanceledAutoReply: String
-  "Whether the auto-reply for issue canceled is enabled."   issueCanceledAutoReplyEnabled: Boolean
+"[Internal] Filter for AI prompt progress subscription events." input AiPromptProgressSubscriptionFilter {
+  "[Internal] Filter by issue ID."   issueId: IDComparator
+  "[Internal] Filter by comment ID."   commentId: IDComparator
+  "[Internal] Filter by pull request comment ID."   pullRequestCommentId: IDComparator
+  "[Internal] Filter by prompt workflow type."   type: AiPromptTypeComparator
+  "[Internal] Filter by prompt workflow status."   status: AiPromptProgressStatusComparator
 }
 
-input AsksWebSettingsCreateInput {
-  "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
-  "The custom domain for the Asks web form. If null, the default Linear-hosted domain will be used."   domain: String
+"[Internal] Comparator for the AI prompt workflow type." input AiPromptTypeComparator {
+  "Equals constraint."   eq: AiPromptType
+  "Not-equals constraint."   neq: AiPromptType
+  "In-array constraint."   in: [AiPromptType!]
+  "Not-in-array constraint."   nin: [AiPromptType!]
+  "Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values."   null: Boolean
 }
 
-input AsksWebSettingsEmailIntakeAddressInput {
-  "The sender name for outgoing emails."   senderName: String
-  "The email address for forwarding."   forwardingEmailAddress: String
+input AirbyteConfigurationInput {
+  "Linear export API key."   apiKey: String!
 }
 
-input AsksWebSettingsUpdateInput {
-  "The custom domain for the Asks web form. If null, the default Linear-hosted domain will be used."   domain: String
+"Customer approximate need count sorting options." input ApproximateNeedCountSort {
+  "Whether nulls should be sorted first or last"   nulls: PaginationNulls = last
+  "The order for the individual sort"   order: PaginationSortOrder
 }
 
 "Issue assignee sorting options." input AssigneeSort {
@@ -799,7 +976,7 @@ input AsksWebSettingsUpdateInput {
   "Comparator for the collection length."   length: NumberComparator
 }
 
-input AttachmentCreateInput {
+"Input for creating a new issue attachment." input AttachmentCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The attachment title."   title: String!
   "The attachment subtitle."   subtitle: String
@@ -826,7 +1003,7 @@ input AttachmentCreateInput {
   "Compound filters, one of which need to be matched by the attachment."   or: [AttachmentFilter!]
 }
 
-input AttachmentUpdateInput {
+"Input for updating an existing issue attachment." input AttachmentUpdateInput {
   "The attachment title."   title: String!
   "The attachment subtitle."   subtitle: String
   "Attachment metadata object with string and number values."   metadata: JSONObject
@@ -850,7 +1027,7 @@ input AttachmentUpdateInput {
   "Not equals constraint."   neq: Boolean
 }
 
-input CandidateRepository {
+"A candidate code repository to consider when generating repository suggestions for an issue." input CandidateRepository {
   "The full name of the repository in owner/name format (e.g., 'acme/backend')."   repositoryFullName: String!
   "Hostname of the Git service (e.g., 'github.com', 'github.company.com')."   hostname: String!
 }
@@ -865,6 +1042,8 @@ input CandidateRepository {
   "Filters that the comment's project update must satisfy."   projectUpdate: NullableProjectUpdateFilter
   "Filters that the comment parent must satisfy."   parent: NullableCommentFilter
   "Filters that the comment's document content must satisfy."   documentContent: NullableDocumentContentFilter
+  "[Internal] Filters that the comment's project must satisfy."   project: NullableProjectFilter
+  "[Internal] Filters that the comment's initiative must satisfy."   initiative: NullableInitiativeFilter
   "Filters that the comment's reactions must satisfy."   reactions: ReactionCollectionFilter
   "Filters that the comment's customer needs must satisfy."   needs: CustomerNeedCollectionFilter
   "Compound filters, all of which need to be matched by the comment."   and: [CommentCollectionFilter!]
@@ -874,7 +1053,7 @@ input CandidateRepository {
   "Comparator for the collection length."   length: NumberComparator
 }
 
-input CommentCreateInput {
+"Input for creating a new comment." input CommentCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The comment content in markdown format."   body: String
   "[Internal] The comment content as a Prosemirror document."   bodyData: JSON
@@ -883,12 +1062,14 @@ input CommentCreateInput {
   "The initiative update to associate the comment with."   initiativeUpdateId: String
   "The post to associate the comment with."   postId: String
   "The document content to associate the comment with."   documentContentId: String
+  "[Internal] The project to associate the comment with."   projectId: String
+  "[Internal] The initiative to associate the comment with."   initiativeId: String
   "The parent comment under which to nest a current comment."   parentId: String
   "Create comment as a user with the provided name. This option is only available to OAuth applications creating comments in `actor=app` mode."   createAsUser: String
   "Provide an external user avatar URL. Can only be used in conjunction with the `createAsUser` options. This option is only available to OAuth applications creating comments in `actor=app` mode."   displayIconUrl: String
-  "The date when the comment was created (e.g. if importing from another system). Must be a date in the past. If none is provided, the backend will generate the time as now."   createdAt: DateTime
+  "The time at which the comment was created (e.g. if importing from another system). Must be a time in the past. If none is provided, the backend will generate the time as now."   createdAt: DateTime
   "Flag to prevent auto subscription to the issue the comment is created on."   doNotSubscribeToIssue: Boolean
-  "Flag to indicate this comment should be created on the issue's synced Slack comment thread. If no synced Slack comment thread exists, the mutation will fail."   createOnSyncedSlackThread: Boolean
+  "Flag to indicate this comment should be created on the issue's synced Slack comment thread. If no synced Slack comment thread exists, the mutation will fail. If there are multiple synced Slack threads on the issue, the oldest one will be targeted."   createOnSyncedSlackThread: Boolean
   "The text that this comment references. Only defined for inline comments."   quotedText: String
   "[INTERNAL] The identifiers of the users subscribing to this comment thread."   subscriberIds: [String!]
 }
@@ -903,13 +1084,15 @@ input CommentCreateInput {
   "Filters that the comment's project update must satisfy."   projectUpdate: NullableProjectUpdateFilter
   "Filters that the comment parent must satisfy."   parent: NullableCommentFilter
   "Filters that the comment's document content must satisfy."   documentContent: NullableDocumentContentFilter
+  "[Internal] Filters that the comment's project must satisfy."   project: NullableProjectFilter
+  "[Internal] Filters that the comment's initiative must satisfy."   initiative: NullableInitiativeFilter
   "Filters that the comment's reactions must satisfy."   reactions: ReactionCollectionFilter
   "Filters that the comment's customer needs must satisfy."   needs: CustomerNeedCollectionFilter
   "Compound filters, all of which need to be matched by the comment."   and: [CommentFilter!]
   "Compound filters, one of which need to be matched by the comment."   or: [CommentFilter!]
 }
 
-input CommentUpdateInput {
+"Input for updating an existing comment." input CommentUpdateInput {
   "The comment content."   body: String
   "[Internal] The comment content as a Prosemirror document."   bodyData: JSON
   "[INTERNAL] The user who resolved this thread."   resolvingUserId: String
@@ -924,24 +1107,24 @@ input CommentUpdateInput {
   "The order for the individual sort"   order: PaginationSortOrder
 }
 
-input ContactCreateInput {
-  "The type of support contact."   type: String!
-  "The message the user sent."   message: String!
-  "User's operating system."   operatingSystem: String
-  "User's browser information."   browser: String
-  "User's device information."   device: String
-  "User's Linear client information."   clientVersion: String
-  "How disappointed the user would be if they could no longer use Linear."   disappointmentRating: Int
+"Input for submitting a support contact message from an authenticated user." input ContactCreateInput {
+  "The type of support contact (e.g., bug report, feature request, general feedback)."   type: String!
+  "The feedback or support message submitted by the user."   message: String!
+  "The user's operating system name and version (e.g., 'macOS 14.0')."   operatingSystem: String
+  "The user's browser name and version (e.g., 'Chrome 120')."   browser: String
+  "The user's device type or model information."   device: String
+  "The version of the Linear client application the user is running."   clientVersion: String
+  "How disappointed the user would be if they could no longer use Linear. Scale: 0 = not disappointed, 1 = somewhat disappointed, 2 = very disappointed, 3 = extremely disappointed."   disappointmentRating: Int
 }
 
-"[INTERNAL] Input for sending a message to the Linear Sales team." input ContactSalesCreateInput {
-  "Name of the person requesting information."   name: String!
-  "Work email of the person requesting information."   email: String!
-  "Size of the company."   companySize: String
-  "The message the user sent."   message: String
-  "The URL this request was sent from."   url: String
-  "PostHog distinct ID for analytics correlation."   distinctId: String
-  "Session ID for analytics correlation."   sessionId: String
+"[INTERNAL] Input for submitting a sales or pricing inquiry to the Linear sales team. Small companies are routed to Intercom support, while larger companies are routed to HubSpot." input ContactSalesCreateInput {
+  "Full name of the person submitting the sales inquiry."   name: String!
+  "Work email address of the person submitting the sales inquiry."   email: String!
+  "The size of the inquiring company (e.g., '1-19', '20-99', '100-499'). Used to route the inquiry to the appropriate sales channel."   companySize: String
+  "An optional message from the user describing their needs or questions."   message: String
+  "The page URL from which the sales inquiry was submitted, for attribution tracking."   url: String
+  "PostHog distinct ID for correlating this inquiry with anonymous analytics events."   distinctId: String
+  "PostHog session ID for correlating this inquiry with the user's browsing session."   sessionId: String
 }
 
 "[Internal] Comparator for content." input ContentComparator {
@@ -962,7 +1145,7 @@ input CreateOrganizationInput {
   "The order for the individual sort"   order: PaginationSortOrder
 }
 
-input CustomViewCreateInput {
+"Input for creating a new custom view. A name is required. Optionally scope the view to a team, project, or initiative." input CustomViewCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The name of the custom view."   name: String!
   "The description of the custom view."   description: String
@@ -976,7 +1159,7 @@ input CustomViewCreateInput {
   "The project filter applied to issues in the custom view."   projectFilterData: ProjectFilter
   "[ALPHA] The initiative filter applied to issues in the custom view."   initiativeFilterData: InitiativeFilter
   "The feed item filter applied to issues in the custom view."   feedItemFilterData: FeedItemFilter
-  "Whether the custom view is shared with everyone in the organization."   shared: Boolean
+  "Whether the custom view is shared with everyone in the workspace."   shared: Boolean
 }
 
 "Custom view creation date sorting options." input CustomViewCreatedAtSort {
@@ -1015,7 +1198,7 @@ input CustomViewSortInput {
   "Sort by custom view update date."   updatedAt: CustomViewUpdatedAtSort
 }
 
-input CustomViewUpdateInput {
+"Input for updating an existing custom view. All fields are optional; only provided fields will be updated." input CustomViewUpdateInput {
   "The name of the custom view."   name: String
   "The description of the custom view."   description: String
   "The icon of the custom view."   icon: String
@@ -1028,7 +1211,7 @@ input CustomViewUpdateInput {
   "The project filter applied to issues in the custom view."   projectFilterData: ProjectFilter
   "[ALPHA] The initiative filter applied to issues in the custom view."   initiativeFilterData: InitiativeFilter
   "The feed item filter applied to issues in the custom view."   feedItemFilterData: FeedItemFilter
-  "Whether the custom view is shared with everyone in the organization."   shared: Boolean
+  "Whether the custom view is shared with everyone in the workspace."   shared: Boolean
 }
 
 "Custom view update date sorting options." input CustomViewUpdatedAtSort {
@@ -1041,19 +1224,19 @@ input CustomViewUpdateInput {
   "The order for the individual sort"   order: PaginationSortOrder
 }
 
-input CustomerCreateInput {
+"Input for creating a new customer in the workspace." input CustomerCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
-  "The name of the customer."   name: String!
-  "The domains associated with this customer."   domains: [String!] = []
-  "The ids of the customers in external systems."   externalIds: [String!] = []
-  "The ID of the Slack channel used to interact with the customer."   slackChannelId: String
-  "The user who owns the customer."   ownerId: String
-  "The status of the customer."   statusId: String
-  "The annual revenue generated by the customer."   revenue: Int
-  "The size of the customer."   size: Int
-  "The tier of the customer customer."   tierId: String
-  "The URL of the customer's logo."   logoUrl: String
-  "The main source of the customer, for customers with multiple sources. Must be one of externalIds."   mainSourceId: String
+  "The display name of the customer organization."   name: String!
+  "The email domains associated with this customer (e.g., 'acme.com'). Public email domains are not allowed. Defaults to an empty array."   domains: [String!] = []
+  "Identifiers for this customer in external systems (e.g., CRM IDs). Defaults to an empty array."   externalIds: [String!] = []
+  "The ID of the Slack channel to link to this customer."   slackChannelId: String
+  "The identifier of the user to assign as the owner of the customer."   ownerId: String
+  "The identifier of the customer status to set."   statusId: String
+  "The annual revenue generated by the customer, in dollars."   revenue: Int
+  "The size of the customer organization (e.g., number of employees)."   size: Int
+  "The identifier of the customer tier to assign."   tierId: String
+  "The URL of the customer's logo image."   logoUrl: String
+  "The primary external source ID for customers with multiple sources. Must be one of the values provided in externalIds."   mainSourceId: String
 }
 
 "Customer creation date sorting options." input CustomerCreatedAtSort {
@@ -1100,24 +1283,24 @@ input CustomerCreateInput {
   "Comparator for the collection length."   length: NumberComparator
 }
 
-input CustomerNeedCreateFromAttachmentInput {
-  "The attachment this need is created from."   attachmentId: String!
+"Input for creating a customer need from an existing issue attachment. If the attachment already has an archived need, it will be unarchived instead." input CustomerNeedCreateFromAttachmentInput {
+  "The UUID of the existing issue attachment to create a customer need from."   attachmentId: String!
 }
 
-input CustomerNeedCreateInput {
+"Input for creating a customer need linked to an issue or project. Either issueId or projectId must be provided." input CustomerNeedCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
-  "The uuid of the customer the need belongs to."   customerId: String
-  "The external ID of the customer the need belongs to."   customerExternalId: String
-  "The issue this need is referencing. Can be a UUID or issue identifier (e.g., 'LIN-123')."   issueId: String
-  "[INTERNAL] The project this need is referencing."   projectId: String
-  "The comment this need is referencing."   commentId: String
-  "The attachment this need is referencing."   attachmentId: String
+  "The UUID of the customer this need belongs to. Cannot be used together with customerExternalId."   customerId: String
+  "The external system ID of the customer this need belongs to. Cannot be used together with customerId."   customerExternalId: String
+  "The issue to link this need to. Accepts a UUID or issue identifier (e.g., 'LIN-123'). Either issueId or projectId must be provided."   issueId: String
+  "[INTERNAL] The project to link this need to. Either issueId or projectId must be provided."   projectId: String
+  "The UUID of an existing comment to associate with this need for additional context."   commentId: String
+  "The UUID of an existing attachment to associate with this need as its source."   attachmentId: String
   "Whether the customer need is important or not. 0 = Not important, 1 = Important."   priority: Float
-  "The content of the need in markdown format."   body: String
-  "[Internal] The content of the need as a Prosemirror document."   bodyData: JSON
-  "Optional URL for the attachment associated with the customer need."   attachmentUrl: String
-  "Create need as a user with the provided name. This option is only available to OAuth applications creating needs in `actor=app` mode."   createAsUser: String
-  "Provide an external user avatar URL. Can only be used in conjunction with the `createAsUser` options. This option is only available to OAuth applications creating needs in `actor=app` mode."   displayIconUrl: String
+  "The body content of the need in Markdown format. Cannot be used together with bodyData."   body: String
+  "[Internal] The body content of the need as a Prosemirror document JSON string. Cannot be used together with body."   bodyData: JSON
+  "A URL to create an attachment from and associate with this customer need as its source."   attachmentUrl: String
+  "Create the need attributed to an external user with the provided name. This option is only available to OAuth applications creating needs in `actor=app` mode."   createAsUser: String
+  "Avatar URL for the external user specified in `createAsUser`. Can only be used in conjunction with `createAsUser`. This option is only available to OAuth applications creating needs in `actor=app` mode."   displayIconUrl: String
 }
 
 "Customer filtering options." input CustomerNeedFilter {
@@ -1133,17 +1316,17 @@ input CustomerNeedCreateInput {
   "Compound filters, one of which need to be matched by the customer need."   or: [CustomerNeedFilter!]
 }
 
-input CustomerNeedUpdateInput {
-  "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
-  "The uuid of the customer the need belongs to."   customerId: String
-  "The external ID of the customer the need belongs to."   customerExternalId: String
-  "The issue this need is referencing. Can be a UUID or issue identifier (e.g., 'LIN-123')."   issueId: String
-  "[INTERNAL] The project this need is referencing."   projectId: String
+"Input for updating a customer need. Supports reassigning the customer, moving to a different issue or project, changing priority, and updating body content." input CustomerNeedUpdateInput {
+  "An optional identifier in UUID v4 format. If provided, will be set as the customer need's ID."   id: String
+  "The UUID of the customer to reassign this need to. Cannot be used together with customerExternalId."   customerId: String
+  "The external system ID of the customer to reassign this need to. Cannot be used together with customerId."   customerExternalId: String
+  "The issue to move this need to. Accepts a UUID or issue identifier (e.g., 'LIN-123'). The need's attachment will also be moved to the target issue."   issueId: String
+  "[INTERNAL] The project to move this need to."   projectId: String
   "Whether the customer need is important or not. 0 = Not important, 1 = Important."   priority: Float
-  "Whether to also update the priority of needs from the same customer on the same issue/project."   applyPriorityToRelatedNeeds: Boolean
-  "The content of the need in markdown format."   body: String
-  "[Internal] The content of the need as a Prosemirror document."   bodyData: JSON
-  "Optional URL for the attachment associated with the customer need."   attachmentUrl: String
+  "When true and priority is also set, applies the same priority update to all other needs from the same customer on the same issue or project."   applyPriorityToRelatedNeeds: Boolean
+  "The updated body content of the need in Markdown format. Set to null to clear the body. Cannot be used together with bodyData."   body: String
+  "[Internal] The updated body content of the need as a Prosemirror document JSON string. Set to null to clear the body. Cannot be used together with body."   bodyData: JSON
+  "A URL to create a new attachment from and set as the source for this customer need. Replaces any existing manually-added attachment."   attachmentUrl: String
 }
 
 "Issue customer revenue sorting options." input CustomerRevenueSort {
@@ -1167,13 +1350,13 @@ input CustomerNeedUpdateInput {
   "Sort by approximate customer need count"   approximateNeedCount: ApproximateNeedCountSort
 }
 
-input CustomerStatusCreateInput {
+"Input for creating a customer status in the workspace's customer lifecycle flow." input CustomerStatusCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
-  "The name of the status."   name: String
-  "The UI color of the status as a HEX string."   color: String!
-  "Description of the status."   description: String
-  "The position of the status in the workspace's customer flow."   position: Float
-  "The display name of the status."   displayName: String
+  "The internal name of the status. At least one of name or displayName must be provided."   name: String
+  "The color of the status indicator in the UI, as a HEX string (e.g., '#ff0000')."   color: String!
+  "An optional description explaining what this status represents."   description: String
+  "The sort position of the status in the workspace's customer lifecycle flow. If omitted or colliding, a position is automatically assigned at the end."   position: Float
+  "The user-facing display name of the status. At least one of name or displayName must be provided."   displayName: String
 }
 
 "Customer status filtering options." input CustomerStatusFilter {
@@ -1194,21 +1377,21 @@ input CustomerStatusCreateInput {
   "The order for the individual sort"   order: PaginationSortOrder
 }
 
-input CustomerStatusUpdateInput {
-  "The name of the status."   name: String
-  "The UI color of the status as a HEX string."   color: String
-  "Description of the status."   description: String
-  "The position of the status in the workspace's customer flow."   position: Float
-  "The display name of the status."   displayName: String
+"Input for updating an existing customer status." input CustomerStatusUpdateInput {
+  "The updated internal name of the status."   name: String
+  "The updated color of the status indicator in the UI, as a HEX string."   color: String
+  "The updated description of the status."   description: String
+  "The updated sort position of the status in the workspace's customer lifecycle flow."   position: Float
+  "The updated user-facing display name of the status."   displayName: String
 }
 
-input CustomerTierCreateInput {
+"Input for creating a customer tier in the workspace's customer tier ordering." input CustomerTierCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
-  "The name of the tier."   name: String
-  "The UI color of the tier as a HEX string."   color: String!
-  "Description of the tier."   description: String
-  "The position of the tier in the workspace's customer flow."   position: Float
-  "The display name of the tier."   displayName: String
+  "The internal name of the tier. Must be unique within the workspace. At least one of name or displayName must be provided."   name: String
+  "The color of the tier indicator in the UI, as a HEX string (e.g., '#ff0000')."   color: String!
+  "An optional description explaining what this tier represents."   description: String
+  "The sort position of the tier in the workspace's customer tier ordering. If omitted or colliding, a position is automatically assigned at the end."   position: Float
+  "The user-facing display name of the tier. At least one of name or displayName must be provided."   displayName: String
 }
 
 "Customer tier filtering options." input CustomerTierFilter {
@@ -1223,50 +1406,50 @@ input CustomerTierCreateInput {
   "Compound filters, one of which needs to be matched by the customer tier."   or: [CustomerTierFilter!]
 }
 
-input CustomerTierUpdateInput {
-  "The name of the tier."   name: String
-  "The UI color of the tier as a HEX string."   color: String
-  "Description of the tier."   description: String
-  "The position of the tier in the workspace's customer flow."   position: Float
-  "The display name of the tier."   displayName: String
-}
-
-input CustomerUpdateInput {
-  "The name of the customer."   name: String
-  "The domains associated with this customer."   domains: [String!]
-  "The ids of the customers in external systems."   externalIds: [String!]
-  "The ID of the Slack channel used to interact with the customer."   slackChannelId: String
-  "The user who owns the customer."   ownerId: String
-  "The status of the customer."   statusId: String
-  "The annual revenue generated by the customer."   revenue: Int
-  "The size of the customer."   size: Int
-  "The tier of the customer customer."   tierId: String
-  "The URL of the customer's logo."   logoUrl: String
-  "The main source of the customer, for customers with multiple sources. Must be one of externalIds."   mainSourceId: String
-}
-
-input CustomerUpsertInput {
-  "The identifier in UUID v4 format."   id: String
-  "The name of the customer."   name: String
-  "The domains associated with this customer."   domains: [String!]
-  "The id of the customers in external systems."   externalId: String
-  "The ID of the Slack channel used to interact with the customer."   slackChannelId: String
-  "The user who owns the customer."   ownerId: String
-  "The status of the customer."   statusId: String
-  "The annual revenue generated by the customer."   revenue: Int
-  "The size of the customer."   size: Int
-  "The tier of the customer."   tierId: String
-  "The URL of the customer's logo."   logoUrl: String
-  "The name tier of the customer. Will be created if doesn't exist"   tierName: String
-}
-
-input CycleCreateInput {
+"Input for updating an existing customer tier." input CustomerTierUpdateInput {
+  "The updated internal name of the tier."   name: String
+  "The updated color of the tier indicator in the UI, as a HEX string."   color: String
+  "The updated description of the tier."   description: String
+  "The updated sort position of the tier in the workspace's customer tier ordering."   position: Float
+  "The updated user-facing display name of the tier."   displayName: String
+}
+
+"Input for updating an existing customer." input CustomerUpdateInput {
+  "The updated name of the customer."   name: String
+  "The updated list of email domains associated with this customer. Replaces the existing domains."   domains: [String!]
+  "The updated list of external system identifiers for this customer. New IDs will be appended with source metadata."   externalIds: [String!]
+  "The ID of the Slack channel to link to this customer. Set to null to unlink the current channel."   slackChannelId: String
+  "The identifier of the user to assign as the owner of the customer."   ownerId: String
+  "The identifier of the customer status to set."   statusId: String
+  "The annual revenue generated by the customer, in dollars."   revenue: Int
+  "The size of the customer organization (e.g., number of employees)."   size: Int
+  "The identifier of the customer tier to assign."   tierId: String
+  "The URL of the customer's logo image."   logoUrl: String
+  "The primary external source ID for customers with multiple sources. Must be one of the values in externalIds."   mainSourceId: String
+}
+
+"Input for upserting a customer. Matches against existing customers using id, externalId, slackChannelId, or domains. Creates a new customer if no match is found." input CustomerUpsertInput {
+  "The identifier in UUID v4 format. Used to match an existing customer for upsert."   id: String
+  "The name of the customer. Required when creating a new customer."   name: String
+  "The email domains associated with this customer."   domains: [String!]
+  "An external system identifier for this customer. Used for matching existing customers during upsert."   externalId: String
+  "The ID of the Slack channel to link to this customer."   slackChannelId: String
+  "The identifier of the user to assign as the owner of the customer."   ownerId: String
+  "The identifier of the customer status to set."   statusId: String
+  "The annual revenue generated by the customer, in dollars."   revenue: Int
+  "The size of the customer organization (e.g., number of employees)."   size: Int
+  "The identifier of the customer tier to assign. Cannot be used together with tierName."   tierId: String
+  "The URL of the customer's logo image."   logoUrl: String
+  "The name of the customer tier to assign. A new tier will be created if one with this name does not exist. Cannot be used together with tierId."   tierName: String
+}
+
+"Input for creating a new cycle." input CycleCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The custom name of the cycle."   name: String
   "The description of the cycle."   description: String
   "The team to associate the cycle with."   teamId: String!
-  "The start date of the cycle."   startsAt: DateTime!
-  "The end date of the cycle."   endsAt: DateTime!
+  "The start time of the cycle."   startsAt: DateTime!
+  "The end time of the cycle."   endsAt: DateTime!
   "The completion time of the cycle. If null, the cycle hasn't been completed."   completedAt: DateTime
 }
 
@@ -1300,7 +1483,7 @@ input CycleCreateInput {
   "Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values."   null: Boolean
 }
 
-"Input for shifting all cycles from a certain cycle onwards by a certain number of days" input CycleShiftAllInput {
+"Input for shifting all cycles from a certain cycle onwards by a certain number of days." input CycleShiftAllInput {
   "The cycle ID at which to start the shift."   id: String!
   "The number of days to shift the cycles by."   daysToShift: Float!
 }
@@ -1311,12 +1494,12 @@ input CycleCreateInput {
   "When set to true, cycles will be ordered with a custom order. Current cycle comes first, followed by upcoming cycles in ASC order, followed by previous cycles in DESC order."   currentCycleFirst: Boolean = false
 }
 
-input CycleUpdateInput {
+"Input for updating an existing cycle." input CycleUpdateInput {
   "The custom name of the cycle."   name: String
   "The description of the cycle."   description: String
-  "The start date of the cycle."   startsAt: DateTime
-  "The end date of the cycle."   endsAt: DateTime
-  "The end date of the cycle."   completedAt: DateTime
+  "The start time of the cycle."   startsAt: DateTime
+  "The end time of the cycle."   endsAt: DateTime
+  "The completion time of the cycle. If null, the cycle hasn't been completed."   completedAt: DateTime
 }
 
 "Comparator for dates." input DateComparator {
@@ -1335,17 +1518,11 @@ input CycleUpdateInput {
   "The order for the individual sort"   order: PaginationSortOrder
 }
 
-input DeleteOrganizationInput {
+"Input for confirming workspace deletion with a verification code." input DeleteOrganizationInput {
   "The deletion code to confirm operation."   deletionCode: String!
 }
 
-"Document content history filtering options." input DocumentContentHistoryFilter {
-  "Comparator for the identifier."   id: IDComparator
-  "Comparator for the created at date."   createdAt: DateComparator
-  "Comparator for the updated at date."   updatedAt: DateComparator
-}
-
-input DocumentCreateInput {
+"Input for creating a new document." input DocumentCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The title of the document."   title: String!
   "The icon of the document."   icon: String
@@ -1373,11 +1550,13 @@ input DocumentCreateInput {
   "Filters that the document's project must satisfy."   project: ProjectFilter
   "Filters that the document's issue must satisfy."   issue: IssueFilter
   "Filters that the document's initiative must satisfy."   initiative: InitiativeFilter
+  "Filters that the document's cycle must satisfy."   cycle: CycleFilter
+  "Filters that the document's release must satisfy."   release: ReleaseFilter
   "Compound filters, all of which need to be matched by the document."   and: [DocumentFilter!]
   "Compound filters, one of which need to be matched by the document."   or: [DocumentFilter!]
 }
 
-input DocumentUpdateInput {
+"Input for updating an existing document." input DocumentUpdateInput {
   "The title of the document."   title: String
   "The icon of the document."   icon: String
   "The color of the icon."   color: String
@@ -1390,9 +1569,9 @@ input DocumentUpdateInput {
   "[Internal] Related cycle for the document."   cycleId: String
   "[Internal] The resource folder containing the document."   resourceFolderId: String
   "The ID of the last template applied to the document."   lastAppliedTemplateId: String
-  "The time at which the document was hidden."   hiddenAt: DateTime
+  "The time at which the document was hidden. Set to null to unhide."   hiddenAt: DateTime
   "The order of the item in the resources list."   sortOrder: Float
-  "Whether the document has been trashed."   trashed: Boolean
+  "Whether the document has been trashed. Set to true to trash, or null to restore from trash."   trashed: Boolean
   "[INTERNAL] The identifiers of the users subscribing to this document."   subscriberIds: [String!]
 }
 
@@ -1401,7 +1580,7 @@ input DocumentUpdateInput {
   "The order for the individual sort"   order: PaginationSortOrder
 }
 
-input EmailIntakeAddressCreateInput {
+"Input for creating a new email intake address." input EmailIntakeAddressCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The type of the email address. If not provided, the backend will default to team or template."   type: EmailIntakeAddressType
   "The email address used to forward emails to the intake address."   forwardingEmailAddress: String
@@ -1417,9 +1596,10 @@ input EmailIntakeAddressCreateInput {
   "Whether the issue canceled auto-reply is enabled."   issueCanceledAutoReplyEnabled: Boolean
   "The auto-reply message for issue canceled."   issueCanceledAutoReply: String
   "Whether customer requests are enabled."   customerRequestsEnabled: Boolean
+  "Whether to reopen completed or canceled issues when a substantive email reply is received."   reopenOnReply: Boolean
 }
 
-input EmailIntakeAddressUpdateInput {
+"Input for updating an existing email intake address." input EmailIntakeAddressUpdateInput {
   "Whether the email address is currently enabled. If set to false, the email address will be disabled and no longer accept incoming emails."   enabled: Boolean
   "The email address used to forward emails to the intake address."   forwardingEmailAddress: String
   "The name to be used for outgoing emails."   senderName: String
@@ -1434,9 +1614,10 @@ input EmailIntakeAddressUpdateInput {
   "Whether the issue canceled auto-reply is enabled."   issueCanceledAutoReplyEnabled: Boolean
   "Custom auto-reply message for issue canceled."   issueCanceledAutoReply: String
   "Whether customer requests are enabled."   customerRequestsEnabled: Boolean
+  "Whether to reopen completed or canceled issues when a substantive email reply is received."   reopenOnReply: Boolean
 }
 
-input EmailUnsubscribeInput {
+"Input for unsubscribing a user from a specific email notification type." input EmailUnsubscribeInput {
   "Email type to unsubscribe from."   type: String!
   "The user's email validation token."   token: String!
   "The identifier of the user."   userId: String!
@@ -1446,18 +1627,19 @@ input EmailUserAccountAuthChallengeInput {
   "The email for which to generate the magic login code."   email: String!
   "Whether the login was requested from the desktop app."   isDesktop: Boolean
   "Auth code for the client initiating the sequence."   clientAuthCode: String
-  "The organization invite link to associate with this authentication."   inviteLink: String
+  "The workspace invite link to associate with this authentication."   inviteLink: String
   "Whether to only return the login code. This is used by mobile apps to skip showing the login link."   loginCodeOnly: Boolean
   "Response from the login challenge."   challengeResponse: String
+  "PostHog session ID for attribution tracking."   sessionId: String
 }
 
-input EmojiCreateInput {
+"Input for creating a new custom emoji." input EmojiCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The name of the custom emoji."   name: String!
   "The URL for the emoji."   url: String!
 }
 
-input EntityExternalLinkCreateInput {
+"Input for creating a new external link on an entity. A URL, label, and exactly one parent entity (initiative, project, team, release, or cycle) are required." input EntityExternalLinkCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The URL of the link."   url: String!
   "The label for the link."   label: String!
@@ -1470,7 +1652,7 @@ input EntityExternalLinkCreateInput {
   "The order of the item in the entities resources list."   sortOrder: Float
 }
 
-input EntityExternalLinkUpdateInput {
+"Input for updating an existing external link. All fields are optional; only provided fields will be updated." input EntityExternalLinkUpdateInput {
   "The URL of the link."   url: String
   "The label for the link."   label: String
   "The order of the item in the entities resources list."   sortOrder: Float
@@ -1496,7 +1678,13 @@ input EntityExternalLinkUpdateInput {
   "The order for the individual sort"   order: PaginationSortOrder
 }
 
-input FavoriteCreateInput {
+"Input for tracking an anonymous analytics event." input EventTrackingInput {
+  "The event name to track."   event: String!
+  "Optional properties for the event."   properties: JSONObject
+  "Client session ID for PostHog session correlation."   sessionId: String
+}
+
+"Input for creating a favorite. Exactly one target entity must be specified (e.g., issueId, projectId, customViewId, folderName, etc.)." input FavoriteCreateInput {
   "The identifier. If none is provided, the backend will generate one."   id: String
   "The name of the favorite folder."   folderName: String
   "The parent folder of the favorite."   parentId: String
@@ -1512,7 +1700,7 @@ input FavoriteCreateInput {
   "[INTERNAL] The identifier of the initiative to favorite."   initiativeId: String
   "The tab of the initiative to favorite."   initiativeTab: InitiativeTab
   "The identifier of the label to favorite."   labelId: String
-  "The identifier of the label to favorite."   projectLabelId: String
+  "The identifier of the project label to favorite."   projectLabelId: String
   "The identifier of the user to favorite."   userId: String
   "The position of the item in the favorites list."   sortOrder: Float
   "The identifier of the customer to favorite."   customerId: String
@@ -1522,7 +1710,7 @@ input FavoriteCreateInput {
   "[ALPHA] The identifier of the release pipeline to favorite."   releasePipelineId: String
 }
 
-input FavoriteUpdateInput {
+"Input for updating a favorite's position, parent folder, or folder name." input FavoriteUpdateInput {
   "The position of the item in the favorites list."   sortOrder: Float
   "The identifier (in UUID v4 format) of the folder to move the favorite under."   parentId: String
   "The name of the favorite folder."   folderName: String
@@ -1554,7 +1742,7 @@ input FrontSettingsInput {
   "Whether Linear Agent should be enabled for this integration."   enableAiIntake: Boolean
 }
 
-input GitAutomationStateCreateInput {
+"Input for creating a new Git automation rule." input GitAutomationStateCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The team associated with the automation state."   teamId: String!
   "The associated workflow state. If null, will override default behaviour and take no action."   stateId: String
@@ -1562,20 +1750,20 @@ input GitAutomationStateCreateInput {
   "The event that triggers the automation."   event: GitAutomationStates!
 }
 
-input GitAutomationStateUpdateInput {
+"Input for updating an existing Git automation rule." input GitAutomationStateUpdateInput {
   "The associated workflow state."   stateId: String
   "The associated target branch. If null, all branches are targeted."   targetBranchId: String
   "The event that triggers the automation."   event: GitAutomationStates
 }
 
-input GitAutomationTargetBranchCreateInput {
+"Input for creating a new Git target branch definition." input GitAutomationTargetBranchCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The team associated with the Git target branch automation."   teamId: String!
   "The target branch pattern."   branchPattern: String!
   "Whether the branch pattern is a regular expression."   isRegex: Boolean = false
 }
 
-input GitAutomationTargetBranchUpdateInput {
+"Input for updating an existing Git target branch definition." input GitAutomationTargetBranchUpdateInput {
   "The target branch pattern."   branchPattern: String
   "Whether the branch pattern is a regular expression."   isRegex: Boolean
 }
@@ -1596,6 +1784,7 @@ input GitHubRepoInput {
   "The GitHub repo id."   id: Float!
   "The full name of the repository."   fullName: String!
   "Whether the repository is archived."   archived: Boolean
+  "The external identifier (GitHub node ID) for the repository."   externalId: String
 }
 
 input GitHubRepoMappingInput {
@@ -1611,10 +1800,12 @@ input GitHubSettingsInput {
   pullRequestReviewTool: PullRequestReviewTool
   "The avatar URL for the GitHub organization."   orgAvatarUrl: String
   "The GitHub organization's name."   orgLogin: String!
+  "The stable external identifier (GitHub node ID) for the organization."   externalOrgId: String
   "The names of the repositories connected for the GitHub integration."   repositories: [GitHubRepoInput!]
   "Mapping of team to repository for syncing."   repositoriesMapping: [GitHubRepoMappingInput!]
   "The type of Github org"   orgType: GithubOrgType
   "Whether the integration has code access"   codeAccess: Boolean
+  "The enterprise URL if this is a GitHub Enterprise Cloud integration."   enterpriseUrl: String
 }
 
 input GitLabSettingsInput {
@@ -1629,6 +1820,7 @@ input GongRecordingImportConfigInput {
 
 input GongSettingsInput {
   "Configuration for recording import."   importConfig: GongRecordingImportConfigInput
+  "Whether to tag matching internal Gong call participants as user mentions in created issues."   tagParticipantsInIssues: Boolean
 }
 
 input GoogleSheetsExportSettings {
@@ -1653,8 +1845,9 @@ input GoogleUserAccountAuthInput {
   "Code returned from Google's OAuth flow."   code: String!
   "The URI to redirect the user to."   redirectUri: String
   "The timezone of the user's browser."   timezone: String!
-  "An optional invite link for an organization used to populate available organizations."   inviteLink: String
+  "An optional invite link for a workspace used to populate available workspaces."   inviteLink: String
   "An optional parameter to disable new user signup and force login. Default: false."   disallowSignup: Boolean
+  "PostHog session ID for attribution tracking."   sessionId: String
 }
 
 "Comparator for identifiers." input IDComparator {
@@ -1680,10 +1873,13 @@ input InheritanceEntityMapping {
   "Filters that the initiative teams must satisfy."   teams: TeamCollectionFilter
   "Filters that the initiative owner must satisfy."   owner: NullableUserFilter
   "Comparator for the initiative target date."   targetDate: NullableDateComparator
+  "Comparator for the initiative started at date."   startedAt: NullableDateComparator
+  "Comparator for the initiative completed at date."   completedAt: NullableDateComparator
   "Comparator for the initiative health: onTrack, atRisk, offTrack"   health: StringComparator
   "Comparator for the initiative health (with age): onTrack, atRisk, offTrack, outdated, noUpdate"   healthWithAge: StringComparator
   "Comparator for the initiative activity type."   activityType: StringComparator
   "Filters that the initiative must be an ancestor of."   ancestors: InitiativeCollectionFilter
+  "Filters that the initiative updates must satisfy."   initiativeUpdates: InitiativeUpdatesCollectionFilter
   "Compound filters, all of which need to be matched by the initiative."   and: [InitiativeCollectionFilter!]
   "Compound filters, one of which need to be matched by the initiative."   or: [InitiativeCollectionFilter!]
   "Filters that needs to be matched by some initiatives."   some: InitiativeFilter
@@ -1696,7 +1892,7 @@ input InheritanceEntityMapping {
   "The name of the initiative."   name: String!
   "The description of the initiative."   description: String
   "The owner of the initiative."   ownerId: String
-  "The sort order of the initiative within the organization."   sortOrder: Float
+  "The sort order of the initiative within the workspace."   sortOrder: Float
   "The initiative's color."   color: String
   "The initiative's icon."   icon: String
   "The initiative's status."   status: InitiativeStatus
@@ -1721,10 +1917,13 @@ input InheritanceEntityMapping {
   "Filters that the initiative teams must satisfy."   teams: TeamCollectionFilter
   "Filters that the initiative owner must satisfy."   owner: NullableUserFilter
   "Comparator for the initiative target date."   targetDate: NullableDateComparator
+  "Comparator for the initiative started at date."   startedAt: NullableDateComparator
+  "Comparator for the initiative completed at date."   completedAt: NullableDateComparator
   "Comparator for the initiative health: onTrack, atRisk, offTrack"   health: StringComparator
   "Comparator for the initiative health (with age): onTrack, atRisk, offTrack, outdated, noUpdate"   healthWithAge: StringComparator
   "Comparator for the initiative activity type."   activityType: StringComparator
   "Filters that the initiative must be an ancestor of."   ancestors: InitiativeCollectionFilter
+  "Filters that the initiative updates must satisfy."   initiativeUpdates: InitiativeUpdatesCollectionFilter
   "Compound filters, all of which need to be matched by the initiative."   and: [InitiativeFilter!]
   "Compound filters, one of which need to be matched by the initiative."   or: [InitiativeFilter!]
 }
@@ -1754,15 +1953,15 @@ input InheritanceEntityMapping {
   "The order for the individual sort"   order: PaginationSortOrder
 }
 
-input InitiativeRelationCreateInput {
+"Input for creating a parent-child relationship between two initiatives. The initiativeId is the parent and the relatedInitiativeId is the child." input InitiativeRelationCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
-  "The identifier of the parent initiative."   initiativeId: String!
-  "The identifier of the child initiative."   relatedInitiativeId: String!
-  "The sort order of the initiative relation."   sortOrder: Float
+  "The identifier of the parent initiative in the hierarchy."   initiativeId: String!
+  "The identifier of the child initiative in the hierarchy."   relatedInitiativeId: String!
+  "The sort order of the child initiative within its parent."   sortOrder: Float
 }
 
-"The properties of the initiativeRelation to update." input InitiativeRelationUpdateInput {
-  "The sort order of the initiative relation."   sortOrder: Float
+"The properties of the initiative relation to update." input InitiativeRelationUpdateInput {
+  "The sort order of the child initiative within its parent."   sortOrder: Float
 }
 
 "Initiative sorting options." input InitiativeSortInput {
@@ -1785,14 +1984,14 @@ input InitiativeRelationCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The identifier of the project."   projectId: String!
   "The identifier of the initiative."   initiativeId: String!
-  "The sort order for the project within its organization."   sortOrder: Float
+  "The sort order for the project within the initiative."   sortOrder: Float
 }
 
-"The properties of the initiativeToProject to update." input InitiativeToProjectUpdateInput {
-  "The sort order for the project within its organization."   sortOrder: Float
+"The properties of the initiative-to-project association to update." input InitiativeToProjectUpdateInput {
+  "The sort order for the project within the initiative."   sortOrder: Float
 }
 
-input InitiativeUpdateCreateInput {
+"Input for creating a new initiative update." input InitiativeUpdateCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The content of the update in markdown format."   body: String
   "[Internal] The content of the update as a Prosemirror document."   bodyData: JSON
@@ -1816,22 +2015,22 @@ input InitiativeUpdateCreateInput {
   "The name of the initiative."   name: String
   "The description of the initiative."   description: String
   "The owner of the initiative."   ownerId: String
-  "The sort order of the initiative within the organization."   sortOrder: Float
+  "The sort order of the initiative within the workspace."   sortOrder: Float
   "The initiative's color."   color: String
   "The initiative's icon."   icon: String
-  "The estimated completion date of the initiative."   targetDate: TimelessDate
+  "The estimated completion date of the initiative. Set to null to clear."   targetDate: TimelessDate
   "The initiative's status."   status: InitiativeStatus
   "The resolution of the initiative's estimated completion date."   targetDateResolution: DateResolutionType
-  "Whether the initiative has been trashed."   trashed: Boolean
+  "Whether the initiative has been trashed. Set to true to trash, or null to restore."   trashed: Boolean
   "The initiative's content in markdown format."   content: String
-  "The n-weekly frequency at which to prompt for updates. When not set, reminders are inherited from workspace."   updateReminderFrequencyInWeeks: Float
-  "The frequency at which to prompt for updates. When not set, reminders are inherited from workspace."   updateReminderFrequency: Float
-  "The frequency resolution."   frequencyResolution: FrequencyResolutionType
-  "The day at which to prompt for updates."   updateRemindersDay: Day
-  "The hour at which to prompt for updates."   updateRemindersHour: Int
+  "The n-weekly frequency at which to prompt for initiative updates. When not set, reminders are inherited from workspace settings."   updateReminderFrequencyInWeeks: Float
+  "The frequency at which to prompt for initiative updates. When not set, reminders are inherited from workspace settings."   updateReminderFrequency: Float
+  "The resolution type for the update reminder frequency (e.g., weekly, biweekly)."   frequencyResolution: FrequencyResolutionType
+  "The day of the week on which to prompt for initiative updates."   updateRemindersDay: Day
+  "The hour of the day (0-23) at which to prompt for initiative updates."   updateRemindersHour: Int
 }
 
-input InitiativeUpdateUpdateInput {
+"Input for updating an existing initiative update." input InitiativeUpdateUpdateInput {
   "The content of the update in markdown format."   body: String
   "The content of the update as a Prosemirror document."   bodyData: JSON
   "The health of the initiative at the time of the update."   health: InitiativeUpdateHealthType
@@ -1843,11 +2042,30 @@ input InitiativeUpdateUpdateInput {
   "The order for the individual sort"   order: PaginationSortOrder
 }
 
+"Collection filtering options for filtering initiatives by initiative updates." input InitiativeUpdatesCollectionFilter {
+  "Comparator for the identifier."   id: IDComparator
+  "Comparator for the created at date."   createdAt: DateComparator
+  "Comparator for the updated at date."   updatedAt: DateComparator
+  "Compound filters, all of which need to be matched by the initiative update."   and: [InitiativeUpdatesCollectionFilter!]
+  "Compound filters, one of which need to be matched by the update."   or: [InitiativeUpdatesCollectionFilter!]
+  "Filters that needs to be matched by some initiative updates."   some: InitiativeUpdatesFilter
+  "Filters that needs to be matched by all initiative updates."   every: InitiativeUpdatesFilter
+  "Comparator for the collection length."   length: NumberComparator
+}
+
+"Options for filtering initiatives by initiative updates." input InitiativeUpdatesFilter {
+  "Comparator for the identifier."   id: IDComparator
+  "Comparator for the created at date."   createdAt: DateComparator
+  "Comparator for the updated at date."   updatedAt: DateComparator
+  "Compound filters, all of which need to be matched by the initiative updates."   and: [InitiativeUpdatesFilter!]
+  "Compound filters, one of which need to be matched by the initiative updates."   or: [InitiativeUpdatesFilter!]
+}
+
 input IntegrationCustomerDataAttributesRefreshInput {
   "The integration service to refresh customer data attributes from."   service: String!
 }
 
-input IntegrationRequestInput {
+"Input for requesting a currently unavailable integration." input IntegrationRequestInput {
   "Email associated with the request."   email: String
   "Name of the requested integration."   name: String!
 }
@@ -1872,6 +2090,7 @@ input IntegrationSettingsInput {
   front: FrontSettingsInput
   gong: GongSettingsInput
   microsoftTeams: MicrosoftTeamsSettingsInput
+  microsoftTeamsProjectPost: MicrosoftTeamsPostSettingsInput
   jira: JiraSettingsInput
   notion: NotionSettingsInput
   opsgenie: OpsgenieInput
@@ -1881,7 +2100,7 @@ input IntegrationSettingsInput {
   salesforce: SalesforceSettingsInput
 }
 
-input IntegrationTemplateCreateInput {
+"Input for creating a new integration template." input IntegrationTemplateCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The identifier of the integration."   integrationId: String!
   "The identifier of the template."   templateId: String!
@@ -1899,6 +2118,7 @@ input IntegrationsSettingsCreateInput {
   "Whether to send a Slack message when any of the project or team's issues change to completed or cancelled."   slackIssueStatusChangedDone: Boolean
   "Whether to send a Slack message when any of the project or team's issues has a change in status."   slackIssueStatusChangedAll: Boolean
   "Whether to send a Slack message when a project update is created."   slackProjectUpdateCreated: Boolean
+  "Whether to send a Microsoft Teams message when a project update is created."   microsoftTeamsProjectUpdateCreated: Boolean
   "Whether to send a Slack message when a project update is created to team channels."   slackProjectUpdateCreatedToTeam: Boolean
   "Whether to send a Slack message when a project update is created to workspace channel."   slackProjectUpdateCreatedToWorkspace: Boolean
   "Whether to send a Slack message when an initiative update is created."   slackInitiativeUpdateCreated: Boolean
@@ -1920,6 +2140,7 @@ input IntegrationsSettingsUpdateInput {
   "Whether to send a Slack message when any of the project or team's issues change to completed or cancelled."   slackIssueStatusChangedDone: Boolean
   "Whether to send a Slack message when any of the project or team's issues has a change in status."   slackIssueStatusChangedAll: Boolean
   "Whether to send a Slack message when a project update is created."   slackProjectUpdateCreated: Boolean
+  "Whether to send a Microsoft Teams message when a project update is created."   microsoftTeamsProjectUpdateCreated: Boolean
   "Whether to send a Slack message when a project update is created to team channels."   slackProjectUpdateCreatedToTeam: Boolean
   "Whether to send a Slack message when a project update is created to workspace channel."   slackProjectUpdateCreatedToWorkspace: Boolean
   "Whether to send a Slack message when an initiative update is created."   slackInitiativeUpdateCreated: Boolean
@@ -1940,7 +2161,7 @@ input IntercomSettingsInput {
   "Whether Linear Agent should be enabled for this integration."   enableAiIntake: Boolean
 }
 
-input IssueBatchCreateInput {
+"Input for creating multiple issues at once in a batch operation. Up to 50 issues can be created in a single batch." input IssueBatchCreateInput {
   "The issues to create."   issues: [IssueCreateInput!]!
 }
 
@@ -1951,12 +2172,13 @@ input IssueBatchCreateInput {
   "Comparator for the issues number."   number: NumberComparator
   "Comparator for the issues title."   title: StringComparator
   "Comparator for the issues description."   description: NullableStringComparator
-  "Comparator for the issues priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low."   priority: NullableNumberComparator
+  "Comparator for the issues priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low."   priority: NullableNumberComparator
   "Comparator for the issues estimate."   estimate: EstimateComparator
   "Comparator for the issues started at date."   startedAt: NullableDateComparator
   "Comparator for the issues triaged at date."   triagedAt: NullableDateComparator
   "Comparator for the issues completed at date."   completedAt: NullableDateComparator
   "Comparator for the issues canceled at date."   canceledAt: NullableDateComparator
+  "Comparator for the issue's SLA breach date."   slaBreachesAt: NullableDateComparator
   "Comparator for the issues archived at date."   archivedAt: NullableDateComparator
   "Comparator for the issues auto closed at date."   autoClosedAt: NullableDateComparator
   "Comparator for the issues auto archived at date."   autoArchivedAt: NullableDateComparator
@@ -2015,7 +2237,7 @@ input IssueBatchCreateInput {
   "Comparator for the collection length."   length: NumberComparator
 }
 
-input IssueCreateInput {
+"Input for creating a new issue. At minimum, a team must be specified. A title is required unless a template is provided. All other fields are optional and will use defaults from the team or template if not specified." input IssueCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The title of the issue."   title: String
   "The issue description in markdown format."   description: String
@@ -2023,7 +2245,7 @@ input IssueCreateInput {
   "The identifier of the user to assign the issue to."   assigneeId: String
   "The identifier of the agent user to delegate the issue to."   delegateId: String
   "The identifier of the parent issue. Can be a UUID or issue identifier (e.g., 'LIN-123')."   parentId: String
-  "The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low."   priority: Int
+  "The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low."   priority: Int
   "The estimated complexity of the issue."   estimate: Int
   "The identifiers of the users subscribing to this ticket."   subscriberIds: [String!]
   "The identifiers of the issue labels associated with this ticket."   labelIds: [String!]
@@ -2043,13 +2265,15 @@ input IssueCreateInput {
   "Create issue as a user with the provided name. This option is only available to OAuth applications creating issues in `actor=app` mode."   createAsUser: String
   "Provide an external user avatar URL. Can only be used in conjunction with the `createAsUser` options. This option is only available to OAuth applications creating comments in `actor=app` mode."   displayIconUrl: String
   "Whether the passed sort order should be preserved."   preserveSortOrderOnCreate: Boolean
-  "The date when the issue was created (e.g. if importing from another system). Must be a date in the past. If none is provided, the backend will generate the time as now."   createdAt: DateTime
-  "[Internal] The timestamp at which an issue will be considered in breach of SLA."   slaBreachesAt: DateTime
-  "[Internal] The timestamp at which the issue's SLA was started."   slaStartedAt: DateTime
+  "The time at which the issue was created (e.g. if importing from another system). Must be a time in the past. If none is provided, the backend will generate the time as now."   createdAt: DateTime
+  "[Internal] The time at which an issue will be considered in breach of SLA."   slaBreachesAt: DateTime
+  "[Internal] The time at which the issue's SLA was started."   slaStartedAt: DateTime
   "The identifier of a template the issue should be created from. If other values are provided in the input, they will override template values."   templateId: String
-  "The date when the issue was completed (e.g. if importing from another system). Must be a date in the past and after createdAt date. Cannot be provided with an incompatible workflow state."   completedAt: DateTime
+  "The time at which the issue was completed (e.g. if importing from another system). Must be a time in the past and after createdAt. Cannot be provided with an incompatible workflow state."   completedAt: DateTime
   "The SLA day count type for the issue. Whether SLA should be business days only or calendar days (default)."   slaType: SLADayCountType
   "Whether to use the default template for the team. When set to true, the default template of this team based on user's membership will be applied."   useDefaultTemplate: Boolean
+  "[ALPHA] The identifiers of the releases to associate with this issue."   releaseIds: [String!]
+  "[Internal] Whether this issue should inherit shared access from its parent issue. Set to false to opt out of automatic shared access inheritance when creating a sub-issue."   inheritsSharedAccess: Boolean
 }
 
 "Issue filtering options." input IssueFilter {
@@ -2059,12 +2283,13 @@ input IssueCreateInput {
   "Comparator for the issues number."   number: NumberComparator
   "Comparator for the issues title."   title: StringComparator
   "Comparator for the issues description."   description: NullableStringComparator
-  "Comparator for the issues priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low."   priority: NullableNumberComparator
+  "Comparator for the issues priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low."   priority: NullableNumberComparator
   "Comparator for the issues estimate."   estimate: EstimateComparator
   "Comparator for the issues started at date."   startedAt: NullableDateComparator
   "Comparator for the issues triaged at date."   triagedAt: NullableDateComparator
   "Comparator for the issues completed at date."   completedAt: NullableDateComparator
   "Comparator for the issues canceled at date."   canceledAt: NullableDateComparator
+  "Comparator for the issue's SLA breach date."   slaBreachesAt: NullableDateComparator
   "Comparator for the issues archived at date."   archivedAt: NullableDateComparator
   "Comparator for the issues auto closed at date."   autoClosedAt: NullableDateComparator
   "Comparator for the issues auto archived at date."   autoArchivedAt: NullableDateComparator
@@ -2127,7 +2352,7 @@ input IssueCreateInput {
   "Not-in-array constraint."   nin: [ID!]
 }
 
-input IssueImportUpdateInput {
+"Input for updating an import job's mapping configuration, such as user and workflow state mappings between the source service and Linear." input IssueImportUpdateInput {
   "The mapping configuration for the import."   mapping: JSONObject!
 }
 
@@ -2148,7 +2373,7 @@ input IssueImportUpdateInput {
   "Comparator for the collection length."   length: NumberComparator
 }
 
-input IssueLabelCreateInput {
+"Input for creating a new label. A name is required. If no team is specified, the label is created as a workspace-level label available to all teams." input IssueLabelCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The name of the label."   name: String!
   "The description of the label."   description: String
@@ -2156,7 +2381,7 @@ input IssueLabelCreateInput {
   "The identifier of the parent label."   parentId: String
   "The team associated with the label. If not given, the label will be associated with the entire workspace."   teamId: String
   "Whether the label is a group."   isGroup: Boolean
-  "When the label was retired."   retiredAt: DateTime
+  "The time at which the label was retired. Set to null to restore a retired label."   retiredAt: DateTime
 }
 
 "Issue label filtering options." input IssueLabelFilter {
@@ -2172,28 +2397,28 @@ input IssueLabelCreateInput {
   "Compound filters, one of which need to be matched by the label."   or: [IssueLabelFilter!]
 }
 
-input IssueLabelUpdateInput {
+"Input for updating an existing label. All fields are optional; only provided fields will be updated." input IssueLabelUpdateInput {
   "The name of the label."   name: String
   "The description of the label."   description: String
   "The identifier of the parent label."   parentId: String
   "The color of the label."   color: String
   "Whether the label is a group."   isGroup: Boolean
-  "When the label was retired."   retiredAt: DateTime
+  "The time at which the label was retired. Set to null to restore a retired label."   retiredAt: DateTime
 }
 
-"A reference to an issue found during release creation." input IssueReferenceInput {
+"A reference to an issue discovered during release sync, linking the issue identifier to the commit SHA where the reference was found." input IssueReferenceInput {
   "The issue identifier (e.g. ENG-123)."   identifier: String!
   "The commit SHA where this issue reference was found."   commitSha: String!
 }
 
-input IssueRelationCreateInput {
+"Input for creating a new issue relation between two issues. Both the source issue and related issue must be specified along with the relationship type." input IssueRelationCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The type of relation of the issue to the related issue."   type: IssueRelationType!
   "The identifier of the issue that is related to another issue. Can be a UUID or issue identifier (e.g., 'LIN-123')."   issueId: String!
   "The identifier of the related issue. Can be a UUID or issue identifier (e.g., 'LIN-123')."   relatedIssueId: String!
 }
 
-input IssueRelationUpdateInput {
+"Input for updating an existing issue relation. All fields are optional; only provided fields will be updated." input IssueRelationUpdateInput {
   "The type of relation of the issue to the related issue."   type: String
   "The identifier of the issue that is related to another issue. Can be a UUID or issue identifier (e.g., 'LIN-123')."   issueId: String
   "The identifier of the related issue. Can be a UUID or issue identifier (e.g., 'LIN-123')."   relatedIssueId: String
@@ -2225,6 +2450,15 @@ input IssueRelationUpdateInput {
   "Sort by number of important customers associated with the issue"   customerImportantCount: CustomerImportantCountSort
   "Sort by the root issue"   rootIssue: RootIssueSort
   "[ALPHA] Sort by number of links associated with the issue"   linkCount: LinkCountSort
+  "[ALPHA] Sort by most recent release date"   release: ReleaseSort
+}
+
+"Filter for issue subscription events." input IssueSubscriptionFilter {
+  "Filter by team ID."   teamId: IDComparator
+  "Filter by project ID."   projectId: IDComparator
+  "Filter by assignee ID."   assigneeId: IDComparator
+  "Filter by workflow state ID."   stateId: IDComparator
+  "Filter by parent issue ID."   parentId: IDComparator
 }
 
 "IssueSuggestion collection filtering options." input IssueSuggestionCollectionFilter {
@@ -2258,25 +2492,28 @@ input IssueRelationUpdateInput {
   "Compound filters, one of which need to be matched by the suggestion."   or: [IssueSuggestionFilter!]
 }
 
-"[ALPHA] The properties of the issueToRelease to create." input IssueToReleaseCreateInput {
+"[ALPHA] Input for creating a new association between an issue and a release. Both an issue identifier and a release identifier must be provided." input IssueToReleaseCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The identifier of the issue. Can be a UUID or issue identifier (e.g., 'LIN-123')."   issueId: String!
-  "The identifier of the release"   releaseId: String!
+  "The identifier of the release."   releaseId: String!
 }
 
-input IssueUpdateInput {
+"Input for updating an existing issue. All fields are optional; only provided fields will be updated. Setting a field to null (where supported) will clear the value." input IssueUpdateInput {
   "The issue title."   title: String
   "The issue description in markdown format."   description: String
   "[Internal] The issue description as a Prosemirror document."   descriptionData: JSON
   "The identifier of the user to assign the issue to."   assigneeId: String
   "The identifier of the agent user to delegate the issue to."   delegateId: String
   "The identifier of the parent issue. Can be a UUID or issue identifier (e.g., 'LIN-123')."   parentId: String
-  "The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low."   priority: Int
+  "The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low."   priority: Int
   "The estimated complexity of the issue."   estimate: Int
   "The identifiers of the users subscribing to this ticket."   subscriberIds: [String!]
   "The identifiers of the issue labels associated with this ticket."   labelIds: [String!]
   "The identifiers of the issue labels to be added to this issue."   addedLabelIds: [String!]
   "The identifiers of the issue labels to be removed from this issue."   removedLabelIds: [String!]
+  "The identifiers of the releases associated with this issue."   releaseIds: [String!]
+  "The identifiers of the releases to be added to this issue."   addedReleaseIds: [String!]
+  "The identifiers of the releases to be removed from this issue."   removedReleaseIds: [String!]
   "The identifier of the team associated with the issue."   teamId: String
   "The cycle associated with the issue."   cycleId: String
   "The project associated with the issue."   projectId: String
@@ -2287,10 +2524,11 @@ input IssueUpdateInput {
   "The position of the issue related to other issues, when ordered by priority."   prioritySortOrder: Float
   "The position of the issue in parent's sub-issue list."   subIssueSortOrder: Float
   "The date at which the issue is due."   dueDate: TimelessDate
+  "Whether this issue should inherit shared access from its parent issue."   inheritsSharedAccess: Boolean
   "Whether the issue has been trashed."   trashed: Boolean
-  "[Internal] The timestamp at which an issue will be considered in breach of SLA."   slaBreachesAt: DateTime
-  "[Internal] The timestamp at which the issue's SLA was started."   slaStartedAt: DateTime
-  "The time until an issue will be snoozed in Triage view."   snoozedUntilAt: DateTime
+  "[Internal] The time at which an issue will be considered in breach of SLA."   slaBreachesAt: DateTime
+  "[Internal] The time at which the issue's SLA was started."   slaStartedAt: DateTime
+  "The time until which the issue will be snoozed in Triage view."   snoozedUntilAt: DateTime
   "The identifier of the user who snoozed the issue."   snoozedById: String
   "The SLA day count type for the issue. Whether SLA should be business days only or calendar days (default)."   slaType: SLADayCountType
   "Whether the issue was automatically closed because its parent issue was closed."   autoClosedByParentClosing: Boolean
@@ -2303,11 +2541,17 @@ input JiraConfigurationInput {
   "Whether this integration will be setup using the manual webhook flow."   manualSetup: Boolean
 }
 
+input JiraFetchProjectStatusesInput {
+  "The id of the Jira integration."   integrationId: String!
+  "The Jira project ID to fetch statuses for."   projectId: String!
+}
+
 input JiraLinearMappingInput {
   "The Jira id for this project."   jiraProjectId: String!
   "The Linear team id to map to the given project."   linearTeamId: String!
   "Whether the sync for this mapping is bidirectional."   bidirectional: Boolean
   "Whether this mapping is the default one for issue creation."   default: Boolean
+  "Whether this mapping uses legacy unidirectional sync behavior where no changes sync from Linear to Jira."   legacyUnidirectional: Boolean
 }
 
 input JiraPersonalSettingsInput {
@@ -2324,10 +2568,13 @@ input JiraSettingsInput {
   "The mapping of Jira project id => Linear team id."   projectMapping: [JiraLinearMappingInput!]
   "The Jira projects for the organization."   projects: [JiraProjectDataInput!]!
   "Whether this integration is for Jira Server or not."   isJiraServer: Boolean = false
+  "Whether this integration uses custom OAuth authentication (enterprise SSO)."   isCustomOAuth: Boolean
+  "The OAuth client ID for the personal connection OAuth app, when using custom OAuth."   personalOAuthClientId: String
+  "The custom OAuth server token endpoint URL (enterprise SSO)."   customOAuthServerUrl: String
   "Whether the user needs to provide setup information about the webhook to complete the integration setup. Only relevant for integrations that use a manual setup flow"   setupPending: Boolean
   "Whether this integration is using a manual setup flow."   manualSetup: Boolean
   "The label of the Jira instance, for visual identification purposes only"   label: String
-  "The status names per issue type, per project."   statusNamesPerIssueType: JSONObject
+  "Jira status names grouped by project, separated into issue statuses (non-Epic) and project statuses (Epic). Structure: projectId -> { issueStatuses: string[], projectStatuses: string[] }"   statusNamesPerIssueType: JSONObject
 }
 
 input JiraUpdateInput {
@@ -2372,8 +2619,23 @@ input LaunchDarklySettingsInput {
   "The order for the individual sort"   order: PaginationSortOrder
 }
 
+"An additional HTTP header sent with requests to the connected MCP server. Header values are stored securely." input McpServerCustomHeaderInput {
+  "The HTTP header name."   name: String!
+  "The HTTP header value."   value: String!
+}
+
+input MicrosoftTeamsPostSettingsInput {
+  "AAD group id of the Team."   teamId: String!
+  "Display name of the Team."   teamName: String!
+  "Microsoft Teams channel id."   channelId: String!
+  "Display name of the channel."   channelName: String!
+  "Membership type of the channel: standard, private, or shared."   membershipType: String!
+  "Azure AD tenant id the team belongs to."   tenantId: String!
+}
+
 input MicrosoftTeamsSettingsInput {
   "The display name of the Azure AD tenant."   tenantName: String
+  "Whether Code Intelligence should be enabled for this Microsoft Teams integration."   enableCodeIntelligence: Boolean
 }
 
 "Issue project milestone options." input MilestoneSort {
@@ -2408,8 +2670,8 @@ input NotificationDeliveryPreferencesChannelInput {
 }
 
 input NotificationDeliveryPreferencesDayInput {
-  "The time notifications start."   start: String
-  "The time notifications end."   end: String
+  "The start time of the notification delivery window in HH:MM military time format (e.g., '09:00'). Must be earlier than 'end'."   start: String
+  "The end time of the notification delivery window in HH:MM military time format (e.g., '18:00'). Must be later than 'start'."   end: String
 }
 
 input NotificationDeliveryPreferencesInput {
@@ -2417,7 +2679,7 @@ input NotificationDeliveryPreferencesInput {
 }
 
 input NotificationDeliveryPreferencesScheduleInput {
-  "Whether the schedule is disabled."   disabled: Boolean
+  "Whether the entire delivery schedule is disabled. When true, notifications are delivered at any time regardless of the per-day settings."   disabled: Boolean
   "Delivery preferences for Sunday."   sunday: NotificationDeliveryPreferencesDayInput!
   "Delivery preferences for Monday."   monday: NotificationDeliveryPreferencesDayInput!
   "Delivery preferences for Tuesday."   tuesday: NotificationDeliveryPreferencesDayInput!
@@ -2427,7 +2689,7 @@ input NotificationDeliveryPreferencesScheduleInput {
   "Delivery preferences for Saturday."   saturday: NotificationDeliveryPreferencesDayInput!
 }
 
-"Describes the type and id of the entity to target for notifications." input NotificationEntityInput {
+"Identifies a specific entity whose related notifications should be targeted by a batch operation. Exactly one entity identifier should be provided." input NotificationEntityInput {
   "The id of the issue related to the notification."   issueId: String
   "[DEPRECATED] The id of the project related to the notification."   projectId: String
   "The id of the initiative related to the notification."   initiativeId: String
@@ -2447,7 +2709,7 @@ input NotificationDeliveryPreferencesScheduleInput {
   "Compound filters, one of which need to be matched by the notification."   or: [NotificationFilter!]
 }
 
-input NotificationSubscriptionCreateInput {
+"Input for creating a notification subscription. Exactly one target entity (customer, custom view, cycle, initiative, label, project, team, or user) must be specified along with the notification types to subscribe to." input NotificationSubscriptionCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The identifier of the customer to subscribe to."   customerId: String
   "The identifier of the custom view to subscribe to."   customViewId: String
@@ -2459,20 +2721,20 @@ input NotificationSubscriptionCreateInput {
   "The identifier of the user to subscribe to."   userId: String
   "The type of view to which the notification subscription context is associated with."   contextViewType: ContextViewType
   "The type of user view to which the notification subscription context is associated with."   userContextViewType: UserContextViewType
-  "The types of notifications of the subscription."   notificationSubscriptionTypes: [String!]
-  "Whether the subscription is active."   active: Boolean
+  "The specific notification event types the subscriber wants to receive for the target entity."   notificationSubscriptionTypes: [String!]
+  "Whether the subscription is active. Set to false to pause notifications without deleting the subscription."   active: Boolean
 }
 
-input NotificationSubscriptionUpdateInput {
-  "The types of notifications of the subscription."   notificationSubscriptionTypes: [String!]
+"Input for updating an existing notification subscription. Allows changing the subscribed notification types and active state." input NotificationSubscriptionUpdateInput {
+  "The specific notification event types the subscriber wants to receive. Replaces all previously configured types."   notificationSubscriptionTypes: [String!]
   "Whether the subscription is active."   active: Boolean
 }
 
-input NotificationUpdateInput {
+"Input for updating a notification's read and snooze state." input NotificationUpdateInput {
   "The time when notification was marked as read."   readAt: DateTime
   "The time until a notification will be snoozed. After that it will appear in the inbox again."   snoozedUntilAt: DateTime
   "The id of the project update related to the notification."   projectUpdateId: String
-  "The id of the project update related to the notification."   initiativeUpdateId: String
+  "The id of the initiative update related to the notification."   initiativeUpdateId: String
 }
 
 input NotionSettingsInput {
@@ -2490,6 +2752,8 @@ input NotionSettingsInput {
   "Filters that the comment's project update must satisfy."   projectUpdate: NullableProjectUpdateFilter
   "Filters that the comment parent must satisfy."   parent: NullableCommentFilter
   "Filters that the comment's document content must satisfy."   documentContent: NullableDocumentContentFilter
+  "[Internal] Filters that the comment's project must satisfy."   project: NullableProjectFilter
+  "[Internal] Filters that the comment's initiative must satisfy."   initiative: NullableInitiativeFilter
   "Filters that the comment's reactions must satisfy."   reactions: ReactionCollectionFilter
   "Filters that the comment's customer needs must satisfy."   needs: CustomerNeedCollectionFilter
   "Filter based on the existence of the relation."   null: Boolean
@@ -2575,6 +2839,29 @@ input NotionSettingsInput {
   "Greater-than-or-equal constraint. Matches any values that are greater than or equal to the given value."   gte: Duration
 }
 
+"Initiative filtering options." input NullableInitiativeFilter {
+  "Comparator for the identifier."   id: IDComparator
+  "Comparator for the created at date."   createdAt: DateComparator
+  "Comparator for the updated at date."   updatedAt: DateComparator
+  "Comparator for the initiative name."   name: StringComparator
+  "Comparator for the initiative slug ID."   slugId: StringComparator
+  "Filters that the initiative creator must satisfy."   creator: NullableUserFilter
+  "Comparator for the initiative status: Planned, Active, Completed"   status: StringComparator
+  "Filters that the initiative teams must satisfy."   teams: TeamCollectionFilter
+  "Filters that the initiative owner must satisfy."   owner: NullableUserFilter
+  "Comparator for the initiative target date."   targetDate: NullableDateComparator
+  "Comparator for the initiative started at date."   startedAt: NullableDateComparator
+  "Comparator for the initiative completed at date."   completedAt: NullableDateComparator
+  "Comparator for the initiative health: onTrack, atRisk, offTrack"   health: StringComparator
+  "Comparator for the initiative health (with age): onTrack, atRisk, offTrack, outdated, noUpdate"   healthWithAge: StringComparator
+  "Comparator for the initiative activity type."   activityType: StringComparator
+  "Filters that the initiative must be an ancestor of."   ancestors: InitiativeCollectionFilter
+  "Filters that the initiative updates must satisfy."   initiativeUpdates: InitiativeUpdatesCollectionFilter
+  "Filter based on the existence of the relation."   null: Boolean
+  "Compound filters, all of which need to be matched by the initiative."   and: [NullableInitiativeFilter!]
+  "Compound filters, one of which need to be matched by the initiative."   or: [NullableInitiativeFilter!]
+}
+
 "Issue filtering options." input NullableIssueFilter {
   "Comparator for the identifier."   id: IssueIDComparator
   "Comparator for the created at date."   createdAt: DateComparator
@@ -2582,12 +2869,13 @@ input NotionSettingsInput {
   "Comparator for the issues number."   number: NumberComparator
   "Comparator for the issues title."   title: StringComparator
   "Comparator for the issues description."   description: NullableStringComparator
-  "Comparator for the issues priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low."   priority: NullableNumberComparator
+  "Comparator for the issues priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low."   priority: NullableNumberComparator
   "Comparator for the issues estimate."   estimate: EstimateComparator
   "Comparator for the issues started at date."   startedAt: NullableDateComparator
   "Comparator for the issues triaged at date."   triagedAt: NullableDateComparator
   "Comparator for the issues completed at date."   completedAt: NullableDateComparator
   "Comparator for the issues canceled at date."   canceledAt: NullableDateComparator
+  "Comparator for the issue's SLA breach date."   slaBreachesAt: NullableDateComparator
   "Comparator for the issues archived at date."   archivedAt: NullableDateComparator
   "Comparator for the issues auto closed at date."   autoClosedAt: NullableDateComparator
   "Comparator for the issues auto archived at date."   autoArchivedAt: NullableDateComparator
@@ -2753,8 +3041,11 @@ input NotionSettingsInput {
   "Comparator for the team key."   key: StringComparator
   "Comparator for the team description."   description: NullableStringComparator
   "Comparator for the team privacy."   private: BooleanComparator
+  "Comparator for the time at which the team was retired."   retiredAt: NullableDateComparator
   "Filters that the teams issues must satisfy."   issues: IssueCollectionFilter
   "Filters that the teams parent must satisfy."   parent: NullableTeamFilter
+  "Filters that the team's ancestors must satisfy."   ancestors: TeamCollectionFilter
+  "[ALPHA] Filters that the team's release pipelines must satisfy."   releasePipelines: ReleasePipelineCollectionFilter
   "Filter based on the existence of the relation."   null: Boolean
   "Compound filters, all of which need to be matched by the team."   and: [NullableTeamFilter!]
   "Compound filters, one of which need to be matched by the team."   or: [NullableTeamFilter!]
@@ -2824,6 +3115,13 @@ input OpsgenieInput {
   "The date when the Opsgenie API failed with an unauthorized error."   apiFailedWithUnauthorizedErrorAt: DateTime
 }
 
+"Input for updating workspace authentication settings." input OrganizationAuthSettingsInput {
+  "Allowed authentication providers, empty array means all are allowed."   allowedAuthServices: [String!]
+  "[Internal] The minimum role required for the auth service bypass exemption."   allowedAuthServiceBypassRole: String
+  "Whether to hide non-primary workspaces during signup for users with matching email domains."   hideNonPrimaryOrganizations: Boolean
+  "Whether to disable admin/owner auth service bypass."   disableAuthServiceBypass: Boolean
+}
+
 input OrganizationDomainCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The identity provider to which to add the domain."   identityProviderId: String
@@ -2860,7 +3158,17 @@ input OrganizationInviteUpdateInput {
   "Whether the restriction is enabled."   enabled: Boolean!
 }
 
-input OrganizationSecuritySettingsInput {
+"[Internal] An MCP server URL entry for the Linear Agent allowlist." input OrganizationLinearAgentMcpServerAllowlistEntryInput {
+  "[Internal] The MCP server URL that Linear Agent is allowed to use."   url: String!
+}
+
+"[Internal] Input for updating Linear Agent settings for the workspace." input OrganizationLinearAgentSettingsInput {
+  "[Internal] Whether the workspace has enabled web search for Linear Agent."   webSearchEnabled: Boolean
+  "[Internal] Whether the workspace has enabled MCP servers for Linear Agent."   mcpServersEnabled: Boolean
+  "[Internal] The MCP server allowlist for Linear Agent. When unset, all MCP servers are allowed."   mcpServersAllowlist: [OrganizationLinearAgentMcpServerAllowlistEntryInput!]
+}
+
+"Input for updating workspace security settings such as role-based access controls." input OrganizationSecuritySettingsInput {
   "The minimum role required to create personal API keys."   personalApiKeysRole: UserRoleType
   "The minimum role required to invite users."   invitationsRole: UserRoleType
   "The minimum role required to create teams."   teamCreationRole: UserRoleType
@@ -2872,19 +3180,19 @@ input OrganizationSecuritySettingsInput {
   "The minimum role required to install and connect new integrations."   integrationCreationRole: UserRoleType
 }
 
-input OrganizationStartTrialInput {
+"Input for starting a workspace trial on a specific plan." input OrganizationStartTrialInput {
   "The plan type to trial."   planType: String!
 }
 
-input OrganizationUpdateInput {
-  "The name of the organization."   name: String
-  "The logo of the organization."   logoUrl: String
-  "The URL key of the organization."   urlKey: String
+"Input for updating the workspace." input OrganizationUpdateInput {
+  "The name of the workspace."   name: String
+  "The logo URL of the workspace."   logoUrl: String
+  "The URL key of the workspace."   urlKey: String
   "How git branches are formatted. If null, default formatting will be used."   gitBranchFormat: String
   "Whether the Git integration linkback messages should be sent for private repositories."   gitLinkbackMessagesEnabled: Boolean
   "Whether the Git integration linkback messages should be sent for public repositories."   gitPublicLinkbackMessagesEnabled: Boolean
   "Whether issue descriptions should be included in Git integration linkback messages."   gitLinkbackDescriptionsEnabled: Boolean
-  "Whether the organization is using roadmap."   roadmapEnabled: Boolean
+  "Whether the workspace is using roadmap."   roadmapEnabled: Boolean
   "The n-weekly frequency at which to prompt for project updates."   projectUpdateReminderFrequencyInWeeks: Float
   "The day at which project updates are sent."   projectUpdateRemindersDay: Day
   "The hour at which project updates are sent."   projectUpdateRemindersHour: Float
@@ -2893,32 +3201,38 @@ input OrganizationUpdateInput {
   "[ALPHA] The hour at which initiative updates are sent."   initiativeUpdateRemindersHour: Float
   "The month at which the fiscal year starts."   fiscalYearStartMonth: Float
   "[Internal] The list of working days. Sunday is 0, Monday is 1, etc."   workingDays: [Float!]
-  "Whether the organization has opted for reduced customer support attachment information."   reducedPersonalInformation: Boolean
-  "Whether the organization has opted for having to approve all OAuth applications for install."   oauthAppReview: Boolean
+  "Whether the workspace has opted for reduced customer support attachment information."   reducedPersonalInformation: Boolean
+  "Whether the workspace has opted for having to approve all OAuth applications for install."   oauthAppReview: Boolean
   "List of services that are allowed to be used for login."   allowedAuthServices: [String!]
-  "Internal. Whether SLAs have been enabled for the organization."   slaEnabled: Boolean
+  "Internal. Whether SLAs have been enabled for the workspace."   slaEnabled: Boolean
   "Whether agent invocation is restricted to full workspace members."   restrictAgentInvocationToMembers: Boolean
   "IP restriction configurations controlling allowed access the workspace."   ipRestrictions: [OrganizationIpRestrictionInput!]
   "Allowed file upload content types."   allowedFileUploadContentTypes: [String!]
-  "[ALPHA] Theme settings for the organization."   themeSettings: JSONObject
-  "[INTERNAL] Whether the organization is using customers."   customersEnabled: Boolean
+  "[ALPHA] Theme settings for the workspace."   themeSettings: JSONObject
+  "[INTERNAL] Whether the workspace is using customers."   customersEnabled: Boolean
   "[INTERNAL] Configuration settings for the Customers feature."   customersConfiguration: JSONObject
-  "[INTERNAL] Whether code intelligence is enabled for the organization."   codeIntelligenceEnabled: Boolean
+  "[INTERNAL] Whether code intelligence is enabled for the workspace."   codeIntelligenceEnabled: Boolean
   "[INTERNAL] GitHub repository in owner/repo format for code intelligence."   codeIntelligenceRepository: String
-  "Whether the organization has enabled the feed feature."   feedEnabled: Boolean
+  "Whether the workspace has enabled the feed feature."   feedEnabled: Boolean
   "Whether to hide other workspaces for new users signing up with email domains claimed by this organization."   hideNonPrimaryOrganizations: Boolean
   "Default schedule for how often feed summaries are generated."   defaultFeedSummarySchedule: FeedSummarySchedule
-  "[INTERNAL] Whether the organization has enabled the AI add-on."   aiAddonEnabled: Boolean
-  "[INTERNAL] Whether the organization has enabled generated updates."   generatedUpdatesEnabled: Boolean
-  "[INTERNAL] Whether the organization has opted in to AI telemetry."   aiTelemetryEnabled: Boolean
-  "Whether the organization has enabled AI discussion summaries for issues."   aiDiscussionSummariesEnabled: Boolean
-  "Whether the organization has enabled resolved thread AI summaries."   aiThreadSummariesEnabled: Boolean
-  "Whether HIPAA compliance is enabled for organization."   hipaaComplianceEnabled: Boolean
-  "The security settings for the organization."   securitySettings: OrganizationSecuritySettingsInput
+  "[INTERNAL] Whether the workspace has enabled the AI add-on."   aiAddonEnabled: Boolean
+  "[INTERNAL] Whether the workspace has enabled agent automation."   agentAutomationEnabled: Boolean
+  "[INTERNAL] Whether the workspace has enabled generated updates."   generatedUpdatesEnabled: Boolean
+  "[INTERNAL] Whether the workspace has opted in to AI telemetry."   aiTelemetryEnabled: Boolean
+  "Whether the workspace has enabled AI discussion summaries for issues."   aiDiscussionSummariesEnabled: Boolean
+  "Whether the workspace has enabled resolved thread AI summaries."   aiThreadSummariesEnabled: Boolean
+  "Whether HIPAA compliance is enabled for the workspace."   hipaaComplianceEnabled: Boolean
+  "The security settings for the workspace."   securitySettings: OrganizationSecuritySettingsInput
+  "The authentication settings for the workspace."   authSettings: OrganizationAuthSettingsInput
   "[INTERNAL] Configure per-modality AI host providers and model families."   aiProviderConfiguration: JSONObject
   "The ID of the Slack integration to use for auto-creating project channels."   slackProjectChannelIntegrationId: String
   "The prefix to use for auto-created Slack project channels (p-, proj-, or project-)."   slackProjectChannelPrefix: String
-  "[Internal] Whether the organization has enabled Linear Agent."   linearAgentEnabled: Boolean
+  "[Internal] Whether the Slack project channels feature is enabled for the workspace."   slackProjectChannelsEnabled: Boolean
+  "[Internal] Whether to automatically create a Slack channel when a new project is created."   slackAutoCreateProjectChannel: Boolean
+  "[Internal] Whether the workspace has enabled Linear Agent."   linearAgentEnabled: Boolean
+  "[Internal] Settings for Linear Agent features."   linearAgentSettings: OrganizationLinearAgentSettingsInput
+  "[INTERNAL] Whether the workspace has enabled the Coding Agent."   codingAgentEnabled: Boolean
 }
 
 "Customer owner sorting options." input OwnerSort {
@@ -2990,7 +3304,7 @@ input PartialNotificationChannelPreferencesInput {
   "Comparator for the collection length."   length: NumberComparator
 }
 
-input ProjectCreateInput {
+"Input for creating a new project. A name and at least one team are required. All other fields are optional and will use defaults if not specified." input ProjectCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The name of the project."   name: String!
   "The icon of the project."   icon: String
@@ -2999,9 +3313,9 @@ input ProjectCreateInput {
   "The description for the project."   description: String
   "The project content as markdown."   content: String
   "The identifiers of the teams this project is associated with."   teamIds: [String!]!
-  "The ID of the issue from which that project is created."   convertedFromIssueId: String
+  "The ID of the issue that was converted into this project."   convertedFromIssueId: String
   "The ID of the last template applied to the project."   lastAppliedTemplateId: String
-  "The ID of the template to apply when creating the project."   templateId: String
+  "The ID of a project template to apply when creating the project. Overrides useDefaultTemplate if both are provided."   templateId: String
   "When set to true, the default project template of the first team provided will be applied. If templateId is provided, this will be ignored."   useDefaultTemplate: Boolean
   "The identifier of the project lead."   leadId: String
   "The identifiers of the members of this project."   memberIds: [String!]
@@ -3011,8 +3325,8 @@ input ProjectCreateInput {
   "The resolution of the project's estimated completion date."   targetDateResolution: DateResolutionType
   "The sort order for the project within shared views."   sortOrder: Float
   "The sort order for the project within shared views, when ordered by priority."   prioritySortOrder: Float
-  "The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low."   priority: Int
-  "[Internal]The identifiers of the project labels associated with this project."   labelIds: [String!]
+  "The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low."   priority: Int
+  "[Internal] The identifiers of the project labels associated with this project."   labelIds: [String!]
 }
 
 "Project creation date sorting options." input ProjectCreatedAtSort {
@@ -3085,14 +3399,14 @@ input ProjectCreateInput {
   "Comparator for the collection length."   length: NumberComparator
 }
 
-input ProjectLabelCreateInput {
+"Input for creating a new project label. A name is required. The label is created as a workspace-level label available to all projects." input ProjectLabelCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The name of the label."   name: String!
   "The description of the label."   description: String
   "The color of the label."   color: String
   "The identifier of the parent label."   parentId: String
   "Whether the label is a group."   isGroup: Boolean
-  "When the label was retired."   retiredAt: DateTime
+  "The time at which the label was retired. Set to null to restore a retired label."   retiredAt: DateTime
 }
 
 "Project label filtering options." input ProjectLabelFilter {
@@ -3107,13 +3421,13 @@ input ProjectLabelCreateInput {
   "Compound filters, one of which need to be matched by the label."   or: [ProjectLabelFilter!]
 }
 
-input ProjectLabelUpdateInput {
+"Input for updating an existing project label. All fields are optional; only provided fields will be updated." input ProjectLabelUpdateInput {
   "The name of the label."   name: String
   "The description of the label."   description: String
   "The identifier of the parent label."   parentId: String
   "The color of the label."   color: String
   "Whether the label is a group."   isGroup: Boolean
-  "When the label was retired."   retiredAt: DateTime
+  "The time at which the label was retired. Set to null to restore a retired label."   retiredAt: DateTime
 }
 
 "Project lead sorting options." input ProjectLeadSort {
@@ -3140,7 +3454,7 @@ input ProjectLabelUpdateInput {
   "Comparator for the collection length."   length: NumberComparator
 }
 
-input ProjectMilestoneCreateInput {
+"Input for creating a new project milestone." input ProjectMilestoneCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The name of the project milestone."   name: String!
   "The description of the project milestone in markdown format."   description: String
@@ -3161,7 +3475,7 @@ input ProjectMilestoneCreateInput {
   "Compound filters, one of which need to be matched by the project milestone."   or: [ProjectMilestoneFilter!]
 }
 
-input ProjectMilestoneMoveInput {
+"[Internal] Input for moving a project milestone to another project." input ProjectMilestoneMoveInput {
   "The identifier of the project to move the milestone to."   projectId: String!
   "The team id to move the attached issues to. This is needed when there is a mismatch between a project's teams and the milestone's issues' teams. Either this or addIssueTeamToProject is required in that situation to resolve constraints."   newIssueTeamId: String
   "Whether to add each milestone issue's team to the project. This is needed when there is a mismatch between a project's teams and the milestone's issues' teams. Either this or newIssueTeamId is required in that situation to resolve constraints."   addIssueTeamToProject: Boolean
@@ -3179,7 +3493,7 @@ input ProjectMilestoneMoveInput {
   "The team ids for the project"   teamIds: [String!]!
 }
 
-input ProjectMilestoneUpdateInput {
+"Input for updating an existing project milestone." input ProjectMilestoneUpdateInput {
   "The name of the project milestone."   name: String
   "The description of the project milestone in markdown format."   description: String
   "[Internal] The description of the project milestone as a Prosemirror document."   descriptionData: JSONObject
@@ -3199,7 +3513,7 @@ input ProjectMilestoneUpdateInput {
   "Whether to consider no priority as the highest or lowest priority"   noPriorityFirst: Boolean = false
 }
 
-input ProjectRelationCreateInput {
+"Input for creating a new project relation." input ProjectRelationCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The type of relation of the project to the related project."   type: String!
   "The identifier of the project that is related to another project."   projectId: String!
@@ -3210,7 +3524,7 @@ input ProjectRelationCreateInput {
   "The type of the anchor for the related project."   relatedAnchorType: String!
 }
 
-input ProjectRelationUpdateInput {
+"Input for updating an existing project relation." input ProjectRelationUpdateInput {
   "The type of relation of the project to the related project."   type: String
   "The identifier of the project that is related to another project."   projectId: String
   "The identifier of the project milestone."   projectMilestoneId: String
@@ -3238,7 +3552,7 @@ input ProjectRelationUpdateInput {
   "Sort by project lead name."   lead: ProjectLeadSort
 }
 
-input ProjectStatusCreateInput {
+"Input for creating a new project status." input ProjectStatusCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The name of the status."   name: String!
   "The UI color of the status as a HEX string."   color: String!
@@ -3266,7 +3580,7 @@ input ProjectStatusCreateInput {
   "The order for the individual sort"   order: PaginationSortOrder
 }
 
-input ProjectStatusUpdateInput {
+"Input for updating an existing project status." input ProjectStatusUpdateInput {
   "The name of the status."   name: String
   "The UI color of the status as a HEX string."   color: String
   "Description of the status."   description: String
@@ -3275,7 +3589,7 @@ input ProjectStatusUpdateInput {
   "Whether or not a project can be in this status indefinitely."   indefinite: Boolean
 }
 
-input ProjectUpdateCreateInput {
+"Input for creating a new project update." input ProjectUpdateCreateInput {
   "The identifier. If none is provided, the backend will generate one."   id: String
   "The content of the project update in markdown format."   body: String
   "[Internal] The content of the project update as a Prosemirror document."   bodyData: JSON
@@ -3295,7 +3609,7 @@ input ProjectUpdateCreateInput {
   "Compound filters, one of which need to be matched by the ProjectUpdate."   or: [ProjectUpdateFilter!]
 }
 
-input ProjectUpdateInput {
+"Input for updating an existing project. All fields are optional; only provided fields will be updated. Setting a field to null (where supported) will clear the value." input ProjectUpdateInput {
   "The ID of the project status."   statusId: String
   "The name of the project."   name: String
   "The description for the project."   description: String
@@ -3305,31 +3619,31 @@ input ProjectUpdateInput {
   "The icon of the project."   icon: String
   "The color of the project."   color: String
   "The identifiers of the teams this project is associated with."   teamIds: [String!]
-  "The time until which project update reminders are paused."   projectUpdateRemindersPausedUntilAt: DateTime
-  "The n-weekly frequency at which to prompt for updates. When not set, reminders are inherited from workspace."   updateReminderFrequencyInWeeks: Float
-  "The frequency at which to prompt for updates. When not set, reminders are inherited from workspace."   updateReminderFrequency: Float
-  "The frequency resolution."   frequencyResolution: FrequencyResolutionType
-  "The day at which to prompt for updates."   updateRemindersDay: Day
-  "The hour at which to prompt for updates."   updateRemindersHour: Int
+  "The time until which project update reminders are paused. Set to null to resume reminders."   projectUpdateRemindersPausedUntilAt: DateTime
+  "The n-weekly frequency at which to prompt for project updates. When not set, reminders are inherited from workspace settings."   updateReminderFrequencyInWeeks: Float
+  "The frequency at which to prompt for project updates. When not set, reminders are inherited from workspace settings."   updateReminderFrequency: Float
+  "The resolution type for the update reminder frequency (e.g., weekly, biweekly)."   frequencyResolution: FrequencyResolutionType
+  "The day of the week on which to prompt for project updates."   updateRemindersDay: Day
+  "The hour of the day (0-23) at which to prompt for project updates."   updateRemindersHour: Int
   "The identifier of the project lead."   leadId: String
   "The identifiers of the members of this project."   memberIds: [String!]
   "The planned start date of the project."   startDate: TimelessDate
   "The resolution of the project's start date."   startDateResolution: DateResolutionType
   "The planned target date of the project."   targetDate: TimelessDate
   "The resolution of the project's estimated completion date."   targetDateResolution: DateResolutionType
-  "The date when the project was completed."   completedAt: DateTime
-  "The date when the project was canceled."   canceledAt: DateTime
+  "The time at which the project was completed."   completedAt: DateTime
+  "The time at which the project was canceled."   canceledAt: DateTime
   "Whether to send new issue notifications to Slack."   slackNewIssue: Boolean
   "Whether to send new issue comment notifications to Slack."   slackIssueComments: Boolean
   "Whether to send issue status update notifications to Slack."   slackIssueStatuses: Boolean
   "The sort order for the project in shared views."   sortOrder: Float
   "The sort order for the project within shared views, when ordered by priority."   prioritySortOrder: Float
-  "Whether the project has been trashed."   trashed: Boolean
-  "The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low."   priority: Int
+  "Whether the project has been trashed. Set to true to trash, or null to restore."   trashed: Boolean
+  "The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low."   priority: Int
   "The identifiers of the project labels associated with this project."   labelIds: [String!]
 }
 
-input ProjectUpdateUpdateInput {
+"Input for updating an existing project update." input ProjectUpdateUpdateInput {
   "The content of the project update in markdown format."   body: String
   "The content of the project update as a Prosemirror document."   bodyData: JSON
   "The health of the project at the time of the update."   health: ProjectUpdateHealthType
@@ -3362,16 +3676,16 @@ input ProjectUpdateUpdateInput {
   "Compound filters, one of which need to be matched by the project updates."   or: [ProjectUpdatesFilter!]
 }
 
-"Input for referencing a pull request by repository and number." input PullRequestReferenceInput {
+"A reference to a pull request by its repository owner, name, and pull request number. Used during release sync to look up pull requests and associate their linked issues with the release." input PullRequestReferenceInput {
   "The owner of the repository (e.g., organization or user name)."   repositoryOwner: String!
   "The name of the repository."   repositoryName: String!
-  "The pull request number."   number: Float!
+  "The pull request number."   number: Int!
 }
 
-input PushSubscriptionCreateInput {
+"Input for creating a push subscription to receive push notifications on a device or browser." input PushSubscriptionCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
-  "The data of the subscription in stringified JSON format."   data: String!
-  "Whether this is a subscription payload for Google Cloud Messaging or Apple Push Notification service."   type: PushSubscriptionType = web
+  "The push subscription data in stringified JSON format. For web subscriptions, this must contain keys, endpoint, and expirationTime fields per the Web Push API specification. For mobile subscriptions, this contains the device token."   data: String!
+  "The type of push subscription: 'web' for browser-based Web Push API, 'apple' for Apple Push Notification service (or 'appleDevelopment' for sandbox), or 'firebase' for Firebase Cloud Messaging (Android)."   type: PushSubscriptionType = web
 }
 
 "Reaction filtering options." input ReactionCollectionFilter {
@@ -3387,7 +3701,7 @@ input PushSubscriptionCreateInput {
   "Comparator for the collection length."   length: NumberComparator
 }
 
-input ReactionCreateInput {
+"Input for creating a new reaction." input ReactionCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The emoji the user reacted with."   emoji: String!
   "The comment to associate the reaction with."   commentId: String
@@ -3418,8 +3732,11 @@ input ReactionCreateInput {
   "Comparator for the identifier."   id: IDComparator
   "Comparator for the created at date."   createdAt: DateComparator
   "Comparator for the updated at date."   updatedAt: DateComparator
+  "Comparator for the release name."   name: StringComparator
+  "Comparator for the release version."   version: StringComparator
   "Filters that the release's pipeline must satisfy."   pipeline: ReleasePipelineFilter
   "Filters that the release's stage must satisfy."   stage: ReleaseStageFilter
+  "Comparator for the release completion date."   completedAt: NullableDateComparator
   "Compound filters, all of which need to be matched by the release."   and: [ReleaseCollectionFilter!]
   "Compound filters, one of which need to be matched by the release."   or: [ReleaseCollectionFilter!]
   "Filters that needs to be matched by some releases."   some: ReleaseFilter
@@ -3427,13 +3744,13 @@ input ReactionCreateInput {
   "Comparator for the collection length."   length: NumberComparator
 }
 
-input ReleaseCompleteInput {
+"Input for completing a release in a specific pipeline." input ReleaseCompleteInput {
   "The version of the release to complete. If not provided, the latest started release will be completed."   version: String
   "The commit SHA associated with this completion. If a completed release with this SHA already exists, it will be returned instead of completing a new release."   commitSha: String
   "The identifier of the pipeline to mark a release as completed."   pipelineId: String!
 }
 
-input ReleaseCompleteInputBase {
+"Base input for completing a release. Contains the optional version and commit SHA. The pipeline ID is provided separately or inferred from the access key." input ReleaseCompleteInputBase {
   "The version of the release to complete. If not provided, the latest started release will be completed."   version: String
   "The commit SHA associated with this completion. If a completed release with this SHA already exists, it will be returned instead of completing a new release."   commitSha: String
 }
@@ -3450,9 +3767,10 @@ input ReleaseCompleteInputBase {
   "The estimated completion date of the release."   targetDate: TimelessDate
 }
 
-"Debug sink for release creation diagnostics." input ReleaseDebugSinkInput {
+"Diagnostic data captured during release sync, including inspected commits, discovered issue references, and pull request metadata. Stored on the release for debugging release association issues." input ReleaseDebugSinkInput {
   "List of commit SHAs that were inspected."   inspectedShas: [String!]!
   "Map of issue identifiers to their source information."   issues: JSONObject!
+  "Map of reverted issue identifiers to their source information."   revertedIssues: JSONObject
   "Pull request debug information."   pullRequests: [JSONObject!]!
   "List of paths applied during commit scanning."   includePaths: [String!]
 }
@@ -3461,36 +3779,88 @@ input ReleaseCompleteInputBase {
   "Comparator for the identifier."   id: IDComparator
   "Comparator for the created at date."   createdAt: DateComparator
   "Comparator for the updated at date."   updatedAt: DateComparator
+  "Comparator for the release name."   name: StringComparator
+  "Comparator for the release version."   version: StringComparator
   "Filters that the release's pipeline must satisfy."   pipeline: ReleasePipelineFilter
   "Filters that the release's stage must satisfy."   stage: ReleaseStageFilter
+  "Comparator for the release completion date."   completedAt: NullableDateComparator
   "Compound filters, all of which need to be matched by the release."   and: [ReleaseFilter!]
   "Compound filters, one of which need to be matched by the release."   or: [ReleaseFilter!]
 }
 
-input ReleasePipelineCreateInput {
+"[ALPHA] Input for creating a release note." input ReleaseNoteCreateInput {
+  "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
+  "Identifier of the release pipeline."   pipelineId: String!
+  "The releases included in this note."   releaseIds: [String!]!
+}
+
+"[ALPHA] Input for updating a release note." input ReleaseNoteUpdateInput {
+  "The releases included in this note."   releaseIds: [String!]
+}
+
+"[ALPHA] Release pipeline collection filtering options." input ReleasePipelineCollectionFilter {
+  "Comparator for the identifier."   id: IDComparator
+  "Comparator for the created at date."   createdAt: DateComparator
+  "Comparator for the updated at date."   updatedAt: DateComparator
+  "Comparator for the pipeline name."   name: StringComparator
+  "Comparator for the pipeline production flag."   isProduction: BooleanComparator
+  "Filters that the release pipeline's teams must satisfy."   teams: TeamCollectionFilter
+  "Compound filters, all of which need to be matched by the release pipeline."   and: [ReleasePipelineCollectionFilter!]
+  "Compound filters, one of which need to be matched by the release pipeline."   or: [ReleasePipelineCollectionFilter!]
+  "Filters that needs to be matched by some release pipelines."   some: ReleasePipelineFilter
+  "Filters that needs to be matched by all release pipelines."   every: ReleasePipelineFilter
+  "Comparator for the collection length."   length: NumberComparator
+}
+
+"Input for creating a new release pipeline." input ReleasePipelineCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The name of the pipeline."   name: String!
   "The pipeline's unique slug identifier. If not provided, it will be auto-generated."   slugId: String
   "The type of the pipeline."   type: ReleasePipelineType
+  "Whether this pipeline targets a production environment. Default to true."   isProduction: Boolean
   "Glob patterns to include commits affecting matching file paths."   includePathPatterns: [String!]
+  "The identifiers of the teams this pipeline is associated with."   teamIds: [String!]
 }
 
 "[ALPHA] Release pipeline filtering options." input ReleasePipelineFilter {
   "Comparator for the identifier."   id: IDComparator
   "Comparator for the created at date."   createdAt: DateComparator
   "Comparator for the updated at date."   updatedAt: DateComparator
+  "Comparator for the pipeline name."   name: StringComparator
+  "Comparator for the pipeline production flag."   isProduction: BooleanComparator
+  "Filters that the release pipeline's teams must satisfy."   teams: TeamCollectionFilter
   "Compound filters, all of which need to be matched by the pipeline."   and: [ReleasePipelineFilter!]
   "Compound filters, one of which need to be matched by the pipeline."   or: [ReleasePipelineFilter!]
 }
 
-input ReleasePipelineUpdateInput {
+"Release pipeline name sorting options." input ReleasePipelineNameSort {
+  "Whether nulls should be sorted first or last"   nulls: PaginationNulls = last
+  "The order for the individual sort"   order: PaginationSortOrder
+}
+
+"Release pipeline sorting options." input ReleasePipelineSortInput {
+  "Sort by release pipeline name."   name: ReleasePipelineNameSort
+}
+
+"Input for updating an existing release pipeline." input ReleasePipelineUpdateInput {
   "The name of the pipeline."   name: String
   "The pipeline's unique slug identifier."   slugId: String
   "The type of the pipeline."   type: ReleasePipelineType
+  "Whether this pipeline targets a production environment. Default to true."   isProduction: Boolean
   "Glob patterns to include commits affecting matching file paths."   includePathPatterns: [String!]
+  "The identifiers of the teams this pipeline is associated with."   teamIds: [String!]
+}
+
+"[Internal] Issue release sorting options." input ReleaseSort {
+  "Whether nulls should be sorted first or last"   nulls: PaginationNulls = last
+  "The order for the individual sort"   order: PaginationSortOrder
 }
 
-input ReleaseStageCreateInput {
+"Release sorting options." input ReleaseSortInput {
+  "Sort by release stage"   stage: ReleaseStageSort
+}
+
+"Input for creating a new release stage." input ReleaseStageCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The name of the stage."   name: String!
   "The UI color of the stage as a HEX string."   color: String!
@@ -3510,6 +3880,11 @@ input ReleaseStageCreateInput {
   "Compound filters, one of which need to be matched by the stage."   or: [ReleaseStageFilter!]
 }
 
+"Release stage sorting options." input ReleaseStageSort {
+  "Whether nulls should be sorted first or last"   nulls: PaginationNulls = last
+  "The order for the individual sort"   order: PaginationSortOrder
+}
+
 "[ALPHA] Comparator for release stage type." input ReleaseStageTypeComparator {
   "Equals constraint."   eq: ReleaseStageType
   "Not-equals constraint."   neq: ReleaseStageType
@@ -3518,46 +3893,48 @@ input ReleaseStageCreateInput {
   "Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values."   null: Boolean
 }
 
-input ReleaseStageUpdateInput {
+"Input for updating an existing release stage." input ReleaseStageUpdateInput {
   "The name of the stage."   name: String
   "The UI color of the stage as a HEX string."   color: String
   "The position of the stage."   position: Float
   "Whether this stage is frozen. Only applicable to started stages."   frozen: Boolean
 }
 
-"The release data to sync." input ReleaseSyncInput {
+"Input for syncing release data to a specific pipeline. Extends the base sync input with the target pipeline identifier." input ReleaseSyncInput {
   "The name of the release."   name: String
   "The version of the release."   version: String
   "The commit SHA associated with this release."   commitSha: String!
   "Issue references (e.g. ENG-123) to associate with this release."   issueReferences: [IssueReferenceInput!]
+  "Issue references that were reverted and should be removed from the release."   revertedIssueReferences: [IssueReferenceInput!]
   "Pull request references to look up. Issues linked to found PRs will be associated with this release."   pullRequestReferences: [PullRequestReferenceInput!]
   "Information about the source repository."   repository: RepositoryDataInput
   "Debug information for release creation diagnostics."   debugSink: ReleaseDebugSinkInput
   "The identifier of the pipeline this release belongs to."   pipelineId: String!
 }
 
-"Base release sync data without pipeline specification." input ReleaseSyncInputBase {
+"Base input for syncing release data, containing the commit SHA, issue references, pull request references, and optional metadata. Does not include the pipeline ID, which is provided separately or inferred from the access key." input ReleaseSyncInputBase {
   "The name of the release."   name: String
   "The version of the release."   version: String
   "The commit SHA associated with this release."   commitSha: String!
   "Issue references (e.g. ENG-123) to associate with this release."   issueReferences: [IssueReferenceInput!]
+  "Issue references that were reverted and should be removed from the release."   revertedIssueReferences: [IssueReferenceInput!]
   "Pull request references to look up. Issues linked to found PRs will be associated with this release."   pullRequestReferences: [PullRequestReferenceInput!]
   "Information about the source repository."   repository: RepositoryDataInput
   "Debug information for release creation diagnostics."   debugSink: ReleaseDebugSinkInput
 }
 
-"Input for updating a release by pipeline." input ReleaseUpdateByPipelineInput {
+"Input for updating a release by pipeline identifier. Extends the base update input with the target pipeline identifier." input ReleaseUpdateByPipelineInput {
   "The version of the release to update. If not provided, the latest started or latest planned release will be updated."   version: String
   "The stage name to set. First tries exact match, then falls back to case-insensitive matching with dashes/underscores treated as spaces."   stage: String
   "The identifier of the pipeline."   pipelineId: String!
 }
 
-input ReleaseUpdateByPipelineInputBase {
+"Base input for updating a release by pipeline. Contains optional version and stage name. The pipeline ID is provided separately or inferred from the access key." input ReleaseUpdateByPipelineInputBase {
   "The version of the release to update. If not provided, the latest started or latest planned release will be updated."   version: String
   "The stage name to set. First tries exact match, then falls back to case-insensitive matching with dashes/underscores treated as spaces."   stage: String
 }
 
-input ReleaseUpdateInput {
+"Input for updating an existing release." input ReleaseUpdateInput {
   "The name of the release."   name: String
   "The description of the release."   description: String
   "The version of the release."   version: String
@@ -3566,9 +3943,10 @@ input ReleaseUpdateInput {
   "The current stage of the release."   stageId: String
   "The estimated start date of the release."   startDate: TimelessDate
   "The estimated completion date of the release."   targetDate: TimelessDate
+  "Whether the release has been trashed."   trashed: Boolean
 }
 
-"Information about the source repository." input RepositoryDataInput {
+"Metadata about the source code repository from which a release is being synced, including the hosting provider and repository coordinates." input RepositoryDataInput {
   "The owner of the repository (e.g., organization or user name)."   owner: String!
   "The name of the repository."   name: String!
   "The VCS provider hosting the repository (e.g., 'github', 'gitlab')."   provider: String!
@@ -3594,12 +3972,12 @@ input ReleaseUpdateInput {
   "Comparator for the collection length."   length: NumberComparator
 }
 
-input RoadmapCreateInput {
+"Input for creating a new roadmap." input RoadmapCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The name of the roadmap."   name: String!
   "The description of the roadmap."   description: String
   "The owner of the roadmap."   ownerId: String
-  "The sort order of the roadmap within the organization."   sortOrder: Float
+  "The sort order of the roadmap within the workspace."   sortOrder: Float
   "The roadmap's color."   color: String
 }
 
@@ -3614,22 +3992,22 @@ input RoadmapCreateInput {
   "Compound filters, one of which need to be matched by the roadmap."   or: [RoadmapFilter!]
 }
 
-input RoadmapToProjectCreateInput {
+"Input for creating a new roadmap-to-project mapping." input RoadmapToProjectCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The identifier of the project."   projectId: String!
   "The identifier of the roadmap."   roadmapId: String!
-  "The sort order for the project within its organization."   sortOrder: Float
+  "The sort order for the project within its workspace."   sortOrder: Float
 }
 
-input RoadmapToProjectUpdateInput {
-  "The sort order for the project within its organization."   sortOrder: Float
+"Input for updating an existing roadmap-to-project mapping." input RoadmapToProjectUpdateInput {
+  "The sort order for the project within its workspace."   sortOrder: Float
 }
 
-input RoadmapUpdateInput {
+"Input for updating an existing roadmap." input RoadmapUpdateInput {
   "The name of the roadmap."   name: String
   "The description of the roadmap."   description: String
   "The owner of the roadmap."   ownerId: String
-  "The sort order of the roadmap within the organization."   sortOrder: Float
+  "The sort order of the roadmap within the workspace."   sortOrder: Float
   "The roadmap's color."   color: String
 }
 
@@ -3730,11 +4108,11 @@ input SlackChannelNameMappingInput {
 }
 
 input SlackPostSettingsInput {
-  channel: String!
-  channelId: String!
-  configurationUrl: String!
-  "Slack workspace id"   teamId: String
-  channelType: SlackChannelType
+  "The name of the Slack channel."   channel: String!
+  "The Slack channel ID."   channelId: String!
+  "The URL to the Slack integration configuration page."   configurationUrl: String!
+  "The Slack workspace ID."   teamId: String
+  "The type of the Slack channel (e.g., public, private, or DM)."   channelType: SlackChannelType
 }
 
 input SlackSettingsInput {
@@ -3748,13 +4126,10 @@ input SlackSettingsInput {
   "Whether Linear should automatically respond with issue unfurls when an issue identifier is mentioned in a Slack message."   linkOnIssueIdMention: Boolean!
   "Whether Linear Agent should be enabled for this Slack integration."   enableAgent: Boolean
   "Whether Linear Agent should be given Org-wide access within Slack workflows."   enableLinearAgentWorkflowAccess: Boolean
+  "Whether Code Intelligence should be enabled for this Slack integration."   enableCodeIntelligence: Boolean
 }
 
 "Comparator for issue source type." input SourceMetadataComparator {
-  "Equals constraint."   eq: String
-  "Not-equals constraint."   neq: String
-  "In-array constraint."   in: [String!]
-  "Not-in-array constraint."   nin: [String!]
   "Null constraint. Matches any non-null values if the given value is false, otherwise it matches null values."   null: Boolean
   "Comparator for the sub type."   subType: SubTypeComparator
   "[INTERNAL] Comparator for the salesforce metadata."   salesforceMetadata: SalesforceMetadataIntegrationComparator
@@ -3851,6 +4226,7 @@ input SlackSettingsInput {
   "Filters that needs to be matched by all teams."   every: TeamFilter
   "Comparator for the collection length."   length: NumberComparator
   "Filters that the teams parent must satisfy."   parent: NullableTeamFilter
+  "Filters that the team's ancestors must satisfy."   ancestors: TeamCollectionFilter
 }
 
 input TeamCreateInput {
@@ -3885,11 +4261,14 @@ input TeamCreateInput {
   "Internal. Whether the team is private or not."   private: Boolean
   "Period after which issues are automatically closed, in months."   autoClosePeriod: Float
   "The canceled workflow state which auto closed issues will be set to."   autoCloseStateId: String
-  "Period after which closed and completed issues are automatically archived, in months. 0 means disabled."   autoArchivePeriod: Float
+  "Period after which closed (completed, canceled, or duplicate) issues are automatically archived, in months. 0 means disabled."   autoArchivePeriod: Float
   "The workflow state into which issues are moved when they are marked as a duplicate of another issue."   markedAsDuplicateWorkflowStateId: String
   "The parent team ID."   parentId: String
   "[Internal] Whether the team should inherit its product intelligence scope from its parent. Only applies to sub-teams."   inheritProductIntelligenceScope: Boolean
   "[Internal] The scope of product intelligence suggestion data for the team."   productIntelligenceScope: ProductIntelligenceScope
+  "Whether issue sharing is enabled for this team."   issueSharingEnabled: Boolean
+  "[Internal] Whether the team should inherit its Slack auto-create project channel setting from its parent. Only applies to sub-teams."   inheritSlackAutoCreateProjectChannel: Boolean
+  "[Internal] Whether to automatically create a Slack channel when a new project is created in this team."   slackAutoCreateProjectChannel: Boolean
 }
 
 "Team filtering options." input TeamFilter {
@@ -3900,13 +4279,16 @@ input TeamCreateInput {
   "Comparator for the team key."   key: StringComparator
   "Comparator for the team description."   description: NullableStringComparator
   "Comparator for the team privacy."   private: BooleanComparator
+  "Comparator for the time at which the team was retired."   retiredAt: NullableDateComparator
   "Filters that the teams issues must satisfy."   issues: IssueCollectionFilter
   "Filters that the teams parent must satisfy."   parent: NullableTeamFilter
+  "Filters that the team's ancestors must satisfy."   ancestors: TeamCollectionFilter
+  "[ALPHA] Filters that the team's release pipelines must satisfy."   releasePipelines: ReleasePipelineCollectionFilter
   "Compound filters, all of which need to be matched by the team."   and: [TeamFilter!]
   "Compound filters, one of which need to be matched by the team."   or: [TeamFilter!]
 }
 
-input TeamMembershipCreateInput {
+"Input for creating a new team membership." input TeamMembershipCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The identifier of the user associated with the membership."   userId: String!
   "The identifier of the team associated with the membership."   teamId: String!
@@ -3914,12 +4296,13 @@ input TeamMembershipCreateInput {
   "The position of the item in the users list."   sortOrder: Float
 }
 
-input TeamMembershipUpdateInput {
+"Input for updating an existing team membership." input TeamMembershipUpdateInput {
   "Internal. Whether the user is the owner of the team."   owner: Boolean
   "The position of the item in the users list."   sortOrder: Float
 }
 
 input TeamSecuritySettingsInput {
+  "The minimum team role required to share issues with non-team-members."   issueSharing: TeamRoleType
   "The minimum team role required to manage labels in the team."   labelManagement: TeamRoleType
   "The minimum team role required to manage full workspace members (non-guests) in the team."   memberManagement: TeamRoleType
   "The minimum team role required to manage team settings."   teamManagement: TeamRoleType
@@ -3944,7 +4327,7 @@ input TeamUpdateInput {
   "Auto assign started issues to current active cycle setting."   cycleIssueAutoAssignStarted: Boolean
   "Auto assign completed issues to current active cycle setting."   cycleIssueAutoAssignCompleted: Boolean
   "Only allow issues with cycles in Active Issues."   cycleLockToActive: Boolean
-  "The date to begin cycles on."   cycleEnabledStartDate: DateTime
+  "The time at which to begin cycles."   cycleEnabledStartDate: DateTime
   "How many upcoming cycles to create."   upcomingCycleCount: Float
   "The timezone of the team."   timezone: String
   "Whether the team should inherit estimation settings from its parent. Only applies to sub-teams."   inheritIssueEstimation: Boolean
@@ -3970,7 +4353,7 @@ input TeamUpdateInput {
   "The canceled workflow state which auto closed issues will be set to."   autoCloseStateId: String
   "Whether to automatically close a parent issue in this team if all its sub-issues are closed."   autoCloseParentIssues: Boolean
   "Whether to automatically close all sub-issues when a parent issue in this team is closed."   autoCloseChildIssues: Boolean
-  "Period after which closed and completed issues are automatically archived, in months."   autoArchivePeriod: Float
+  "Period after which closed (completed, canceled, or duplicate) issues are automatically archived, in months."   autoArchivePeriod: Float
   "The workflow state into which issues are moved when they are marked as a duplicate of another issue."   markedAsDuplicateWorkflowStateId: String
   "Whether new users should join this team by default. Mutation restricted to workspace admins or owners!"   joinByDefault: Boolean
   "Whether the team is managed by SCIM integration. Mutation restricted to workspace admins or owners and only unsetting is allowed!"   scimManaged: Boolean
@@ -3978,27 +4361,34 @@ input TeamUpdateInput {
   "[Internal] Whether the team should inherit workflow statuses from its parent."   inheritWorkflowStatuses: Boolean
   "[Internal] Whether the team should inherit its product intelligence scope from its parent. Only applies to sub-teams."   inheritProductIntelligenceScope: Boolean
   "[Internal] The scope of product intelligence suggestion data for the team."   productIntelligenceScope: ProductIntelligenceScope
+  "Whether issue sharing is enabled for this team."   issueSharingEnabled: Boolean
+  "[Internal] Whether the team should inherit its Slack auto-create project channel setting from its parent. Only applies to sub-teams."   inheritSlackAutoCreateProjectChannel: Boolean
+  "[Internal] Whether to automatically create a Slack channel when a new project is created in this team."   slackAutoCreateProjectChannel: Boolean
   "The security settings for the team."   securitySettings: TeamSecuritySettingsInput
   "Whether all members in the workspace can join the team. Only used for public teams."   allMembersCanJoin: Boolean
   "When the team was retired."   retiredAt: DateTime
   "[Internal] How to handle sub-teams when retiring. Required if the team has active sub-teams."   handleSubTeamsOnRetirement: TeamRetirementSubTeamHandling
 }
 
-input TemplateCreateInput {
+"Input for creating a new template. A name, type, and template data are required. If no team is specified, the template is shared across the workspace." input TemplateCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
-  "The template type, e.g. 'issue'."   type: String!
+  "The template type, e.g. 'issue', 'project', or 'document'."   type: String!
   "The identifier or key of the team associated with the template. If not given, the template will be shared across all teams."   teamId: String
   "The template name."   name: String!
   "The template description."   description: String
-  "The template data as JSON encoded attributes of the type of entity, such as an issue."   templateData: JSON!
-  "The position of the template in the templates list."   sortOrder: Float
+  "The icon of the template."   icon: String
+  "The color of the template icon."   color: String
+  "The template data as JSON-encoded attributes of the target entity type, such as pre-filled issue fields, project configuration, or document content."   templateData: JSON!
+  "The sort position of the template in the templates list."   sortOrder: Float
 }
 
-input TemplateUpdateInput {
+"Input for updating an existing template. All fields are optional; only provided fields will be updated." input TemplateUpdateInput {
   "The template name."   name: String
   "The template description."   description: String
+  "The icon of the template."   icon: String
+  "The color of the template icon."   color: String
   "The identifier or key of the team associated with the template. If set to null, the template will be shared across all teams."   teamId: String
-  "The template data as JSON encoded attributes of the type of entity, such as an issue."   templateData: JSON
+  "The template data as JSON-encoded attributes of the target entity type, such as pre-filled issue fields, project configuration, or document content."   templateData: JSON
   "The position of the template in the templates list."   sortOrder: Float
 }
 
@@ -4012,7 +4402,7 @@ input TemplateUpdateInput {
   "The order for the individual sort"   order: PaginationSortOrder
 }
 
-input TimeScheduleCreateInput {
+"Input for creating a new time schedule." input TimeScheduleCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The name of the schedule."   name: String!
   "The schedule entries."   entries: [TimeScheduleEntryInput!]!
@@ -4021,13 +4411,13 @@ input TimeScheduleCreateInput {
 }
 
 input TimeScheduleEntryInput {
-  "The start date of the schedule in ISO 8601 date-time format."   startsAt: DateTime!
-  "The end date of the schedule in ISO 8601 date-time format."   endsAt: DateTime!
+  "The start time of the schedule entry in ISO 8601 date-time format."   startsAt: DateTime!
+  "The end time of the schedule entry in ISO 8601 date-time format."   endsAt: DateTime!
   "The Linear user id of the user on schedule. If the user cannot be mapped to a Linear user then `userEmail` can be used as a reference."   userId: String
   "The email, name or reference to the user on schedule. This is used in case the external user could not be mapped to a Linear user id."   userEmail: String
 }
 
-input TimeScheduleUpdateInput {
+"Input for updating an existing time schedule." input TimeScheduleUpdateInput {
   "The name of the schedule."   name: String
   "The schedule entries."   entries: [TimeScheduleEntryInput!]
   "The unique identifier of the external schedule."   externalId: String
@@ -4043,10 +4433,11 @@ input TokenUserAccountAuthInput {
   "The email which to login via the magic login code."   email: String!
   "The magic login code."   token: String!
   "The timezone of the user's browser."   timezone: String!
-  "An optional invite link for an organization."   inviteLink: String
+  "An optional invite link for a workspace."   inviteLink: String
+  "Auth code for the client initiating the login sequence."   clientAuthCode: String
 }
 
-input TriageResponsibilityCreateInput {
+"Input for creating a new triage responsibility." input TriageResponsibilityCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "The identifier of the team associated with the triage responsibility."   teamId: String!
   "The action to take when an issue is added to triage."   action: String!
@@ -4059,7 +4450,7 @@ input TriageResponsibilityCreateInput {
   "[Internal] The index of the current userId used for the assign action when having more than one user."   assignmentIndex: Int
 }
 
-input TriageResponsibilityUpdateInput {
+"Input for updating an existing triage responsibility." input TriageResponsibilityUpdateInput {
   "The action to take when an issue is added to triage."   action: String
   "The manual selection of users responsible for triage."   manualSelection: TriageResponsibilityManualSelectionInput
   "The identifier of the time schedule used for scheduling triage responsibility."   timeScheduleId: String
@@ -4141,20 +4532,21 @@ input UserSettingsUpdateInput {
   "Sort by user display name"   displayName: UserDisplayNameSort
 }
 
-input UserUpdateInput {
+"Input for updating the authenticated user." input UserUpdateInput {
   "The name of the user."   name: String
   "The display name of the user."   displayName: String
   "The avatar image URL of the user."   avatarUrl: String
   "The user description or a short bio."   description: String
+  "The user's job title."   title: String
   "The emoji part of the user status."   statusEmoji: String
   "The label part of the user status."   statusLabel: String
   "When the user status should be cleared."   statusUntilAt: DateTime
   "The local timezone of the user."   timezone: String
 }
 
-input ViewPreferencesCreateInput {
+"Input for creating view preferences." input ViewPreferencesCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
-  "The type of view preferences (either user or organization level preferences)."   type: ViewPreferencesType!
+  "The type of view preferences (either user or workspace level preferences)."   type: ViewPreferencesType!
   "The view type of the view preferences are associated with."   viewType: ViewType!
   "View preferences object."   preferences: JSONObject!
   "The default parameters for the insight on that view."   insights: JSONObject
@@ -4163,16 +4555,17 @@ input ViewPreferencesCreateInput {
   "[Internal] The initiative these view preferences are associated with."   initiativeId: String
   "The label these view preferences are associated with."   labelId: String
   "The project label these view preferences are associated with."   projectLabelId: String
+  "The release pipeline these view preferences are associated with."   releasePipelineId: String
   "The custom view these view preferences are associated with."   customViewId: String
   "The user profile these view preferences are associated with."   userId: String
 }
 
-input ViewPreferencesUpdateInput {
+"Input for updating view preferences." input ViewPreferencesUpdateInput {
   "View preferences."   preferences: JSONObject
   "The default parameters for the insight on that view."   insights: JSONObject
 }
 
-input WebhookCreateInput {
+"Input for creating a new webhook." input WebhookCreateInput {
   "Label for the webhook."   label: String
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
   "Whether this webhook is enabled."   enabled: Boolean = true
@@ -4183,7 +4576,7 @@ input WebhookCreateInput {
   "Whether this webhook is enabled for all public teams."   allPublicTeams: Boolean
 }
 
-input WebhookUpdateInput {
+"Input for updating an existing webhook." input WebhookUpdateInput {
   "Label for the webhook."   label: String
   "A secret token used to sign the webhook payload."   secret: String
   "Whether this webhook is enabled."   enabled: Boolean
@@ -4191,9 +4584,9 @@ input WebhookUpdateInput {
   "List of resources the webhook should subscribe to."   resourceTypes: [String!]
 }
 
-input WorkflowStateCreateInput {
+"Input for creating a new workflow state (issue status) in a team. The name, type, color, and team are required." input WorkflowStateCreateInput {
   "The identifier in UUID v4 format. If none is provided, the backend will generate one."   id: String
-  "The workflow type."   type: String!
+  "The workflow state type, which categorizes the state. Valid values: backlog, unstarted, started, completed, canceled. The type determines how the state is treated in workflow progression and reporting."   type: String!
   "The name of the state."   name: String!
   "The color of the state."   color: String!
   "The description of the state."   description: String
@@ -4208,7 +4601,7 @@ input WorkflowStateCreateInput {
   "Comparator for the workflow state name."   name: StringComparator
   "Comparator for the workflow state description."   description: StringComparator
   "Comparator for the workflow state position."   position: NumberComparator
-  "Comparator for the workflow state type. Possible values are \"triage\", \"backlog\", \"unstarted\", \"started\", \"completed\", \"canceled\"."   type: StringComparator
+  "Comparator for the workflow state type. Possible values are \"triage\", \"backlog\", \"unstarted\", \"started\", \"completed\", \"canceled\", \"duplicate\"."   type: StringComparator
   "Filters that the workflow states team must satisfy."   team: TeamFilter
   "Filters that the workflow states issues must satisfy."   issues: IssueCollectionFilter
   "Compound filters, all of which need to be matched by the workflow state."   and: [WorkflowStateFilter!]
@@ -4221,7 +4614,7 @@ input WorkflowStateCreateInput {
   "Whether to sort closed issues by recency"   closedIssuesOrderedByRecency: Boolean = false
 }
 
-input WorkflowStateUpdateInput {
+"Input for updating an existing workflow state. All fields are optional; only provided fields will be updated. The state type cannot be changed after creation." input WorkflowStateUpdateInput {
   "The name of the state."   name: String
   "The color of the state."   color: String
   "The description of the state."   description: String
@@ -4246,6 +4639,25 @@ input ZendeskSettingsInput {
   "The host mappings from Zendesk brands."   hostMappings: [String!]
 }
 
+"A base part in an AI conversation." interface AiConversationBasePart {
+  "The ID of the part."   id: String!
+  "The type of the part."   type: AiConversationPartType!
+  "The metadata of the part."   metadata: AiConversationPartMetadata!
+}
+
+interface AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+}
+
+interface AiConversationBaseWidget {
+  "The name of the widget."   name: AiConversationWidgetName!
+  "The arguments of the widget."   rawArgs: JSON
+  "Display information for the widget, including ProseMirror and Markdown representations."   displayInfo: AiConversationWidgetDisplayInfo
+}
+
 "A generic payload return from entity archive or deletion mutations." interface ArchivePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "Whether the operation was successful."   success: Boolean!
@@ -4264,23 +4676,21 @@ interface Node {
   "The unique identifier of the entity."   id: ID!
 }
 
-"A notification sent to a user." interface Notification implements Entity & Node {
+"A notification delivered to a user's inbox. Notifications are created in response to activity in the workspace such as issue assignments, comments, mentions, and status changes. Each notification has a specific type that determines the associated entity (issue, project, document, etc.) and the nature of the event. Notifications can be read, snoozed, or archived by the user." interface Notification implements Entity & Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "Notification type."   type: String!
-  "The user that caused the notification."   actor: User
-  "The external user that caused the notification."   externalUserActor: ExternalUser
-  "The user that received the notification."   user: User!
-  "The time at when the user marked the notification as read. Null, if the the user hasn't read the notification"   readAt: DateTime
-  """The time at when an email reminder for this notification was sent to the user. Null, if no email
-    reminder has been sent."""
-  emailedAt: DateTime
-  "The time until a notification will be snoozed. After that it will appear in the inbox again."   snoozedUntilAt: DateTime
-  "The time at which a notification was unsnoozed.."   unsnoozedAt: DateTime
+  "Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated."   type: String!
+  "The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event."   actor: User
+  "The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member."   externalUserActor: ExternalUser
+  "The recipient user of this notification."   user: User!
+  "The time at which the user marked the notification as read. Null if the notification is unread."   readAt: DateTime
+  "The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent."   emailedAt: DateTime
+  "The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed."   snoozedUntilAt: DateTime
+  "The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed."   unsnoozedAt: DateTime
   "The category of the notification."   category: NotificationCategory!
   "[Internal] URL to the target of the notification."   url: String!
   "[Internal] Inbox URL for the notification."   inboxUrl: String!
@@ -4298,50 +4708,37 @@ interface Node {
   "The bot that caused the notification."   botActor: ActorBot
 }
 
-"Notification subscriptions for models." interface NotificationSubscription implements Entity & Node {
-  "The unique identifier of the entity."   id: ID!
-  "The time at which the entity was created."   createdAt: DateTime!
-  """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
-    been updated after creation."""
-  updatedAt: DateTime!
-  "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The user that subscribed to receive notifications."   subscriber: User!
-  "The customer associated with the notification subscription."   customer: Customer
-  "The contextual custom view associated with the notification subscription."   customView: CustomView
-  "The contextual cycle view associated with the notification subscription."   cycle: Cycle
-  "The contextual label view associated with the notification subscription."   label: IssueLabel
-  "The contextual project view associated with the notification subscription."   project: Project
-  "The contextual initiative view associated with the notification subscription."   initiative: Initiative
-  "The team associated with the notification subscription."   team: Team
-  "The user view associated with the notification subscription."   user: User
-  "The type of view to which the notification subscription context is associated with."   contextViewType: ContextViewType
-  "The type of user view to which the notification subscription context is associated with."   userContextViewType: UserContextViewType
-  "Whether the subscription is active or not."   active: Boolean!
-}
-
-"[Internal] An access key for CI/CD integrations." type AccessKey implements Node {
+"A subscription that controls which notifications a user receives for a specific entity such as a team, project, cycle, label, custom view, initiative, or user. This is not a billing subscription -- it determines notification preferences. Each subscription is scoped to exactly one target entity and specifies the notification types the subscriber wants to receive. When active, matching events on the target entity generate notifications for the subscriber." interface NotificationSubscription implements Entity & Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "Organization the API key belongs to."   organization: Organization!
-  "The user who created the access key."   creator: User
-  "When the access key was last used."   lastUsedAt: DateTime
-  "When the access key was revoked."   revokedAt: DateTime
-}
-
-"A bot actor is an actor that is not a user, but an application or integration." type ActorBot {
-  id: ID
-  "The type of bot."   type: String!
-  "The sub type of the bot."   subType: String
+  "The user who will receive notifications from this subscription."   subscriber: User!
+  "The customer that this notification subscription is scoped to. Null if the subscription targets a different entity type."   customer: Customer
+  "The custom view that this notification subscription is scoped to. Null if the subscription targets a different entity type."   customView: CustomView
+  "The cycle that this notification subscription is scoped to. Null if the subscription targets a different entity type."   cycle: Cycle
+  "The issue label that this notification subscription is scoped to. Null if the subscription targets a different entity type."   label: IssueLabel
+  "The project that this notification subscription is scoped to. Null if the subscription targets a different entity type."   project: Project
+  "The initiative that this notification subscription is scoped to. Null if the subscription targets a different entity type."   initiative: Initiative
+  "The team that this notification subscription is scoped to. Null if the subscription targets a different entity type."   team: Team
+  "The user that this notification subscription is scoped to, for user-specific view subscriptions. Null if the subscription targets a different entity type."   user: User
+  "The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type."   contextViewType: ContextViewType
+  "The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type."   userContextViewType: UserContextViewType
+  "Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists."   active: Boolean!
+}
+
+"A bot actor representing a non-human entity that performed an action, such as an integration (GitHub, Slack, Zendesk), an AI assistant, or an automated workflow. Bot actors are displayed in activity feeds and history to indicate when changes were made by applications rather than users." type ActorBot {
+  "A unique identifier for the bot actor."   id: ID
+  "The source type of the bot, identifying the application or integration (e.g., 'github', 'slack', 'workflow', 'ai')."   type: String!
+  "A more specific classification within the bot type, providing additional context about the integration or application variant."   subType: String
   "The display name of the bot."   name: String
-  "The display name of the external user on behalf of which the bot acted."   userDisplayName: String
-  "A url pointing to the avatar representing this bot."   avatarUrl: String
+  "The display name of the external user on behalf of whom the bot acted. Shown when an integration action was triggered by a specific person in the external system."   userDisplayName: String
+  "A URL pointing to the avatar image representing this bot, typically the integration's logo or icon."   avatarUrl: String
 }
 
-"An activity within an agent context." type AgentActivity implements Node {
+"An activity performed by or directed at an AI coding agent during a session. Activities represent the observable steps of an agent's work, including thoughts, actions (tool calls), responses, prompts from users, errors, and elicitation requests. Each activity belongs to an agent session and is associated with the user who initiated it." type AgentActivity implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -4349,14 +4746,14 @@ interface Node {
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The agent session this activity belongs to."   agentSession: AgentSession!
-  "The content of the activity"   content: AgentActivityContent!
-  "The comment this activity is linked to."   sourceComment: Comment
+  "The content of the activity, which varies by type (thought, action, response, prompt, error, or elicitation)."   content: AgentActivityContent!
+  "The source comment this activity is linked to. Null if the activity was not triggered by a comment."   sourceComment: Comment
   "The user who created this agent activity."   user: User!
   "Metadata about the external source that created this agent activity."   sourceMetadata: JSON
   "An optional modifier that provides additional instructions on how the activity should be interpreted."   signal: AgentActivitySignal
-  "Metadata about this agent activity's signal."   signalMetadata: JSON
   "Whether the activity is ephemeral, and should disappear after the next agent activity."   ephemeral: Boolean!
   "[Internal] Metadata about user-provided contextual information for this agent activity."   contextualMetadata: JSON
+  "Metadata about this agent activity's signal."   signalMetadata: JSON
 }
 
 "Content for an action activity (tool call or action)." type AgentActivityActionContent {
@@ -4390,7 +4787,7 @@ type AgentActivityEdge {
   "[Internal] The error content as ProseMirror document."   bodyData: JSONObject!
 }
 
-type AgentActivityPayload {
+"The result of an agent activity mutation." type AgentActivityPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The agent activity that was created or updated."   agentActivity: AgentActivity!
   "Whether the operation was successful."   success: Boolean!
@@ -4414,7 +4811,7 @@ type AgentActivityPayload {
   "[Internal] The thought content as ProseMirror document."   bodyData: JSONObject!
 }
 
-"A session for agent activities and state management." type AgentSession implements Node {
+"A session representing an AI coding agent's work on an issue or conversation. Agent sessions track the lifecycle of an agent's engagement, from creation through active work to completion or dismissal. Each session is associated with an agent user (the bot), optionally a human creator, an issue, and a comment thread where the agent posts updates. Sessions contain activities that record the agent's observable steps and can be linked to pull requests created during the work." type AgentSession implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -4426,19 +4823,20 @@ type AgentActivityPayload {
   "The comment this agent session is associated with."   comment: Comment
   "The comment that this agent session was spawned from, if from a different thread."   sourceComment: Comment
   "The issue this agent session is associated with."   issue: Issue
-  "The current status of the agent session."   status: AgentSessionStatus!
-  "The time the agent session started."   startedAt: DateTime
-  "The time the agent session ended."   endedAt: DateTime
-  "The time the agent session was dismissed."   dismissedAt: DateTime
-  "The user who dismissed the agent session."   dismissedBy: User
+  "The agent session's unique URL slug."   slugId: String!
+  "The current status of the agent session, such as pending, active, awaiting input, complete, error, or stale."   status: AgentSessionStatus!
+  "The time the agent session transitioned to active status and began work. Null if the session has not yet started."   startedAt: DateTime
+  "The time the agent session completed. Null if the session is still in progress or was dismissed before completion."   endedAt: DateTime
+  "The time a user dismissed this agent session. When dismissed, the agent is removed as delegate from the associated issue. Null if the session has not been dismissed."   dismissedAt: DateTime
+  "The user who dismissed the agent session. Automatically set when dismissedAt is updated. Null if the session has not been dismissed."   dismissedBy: User
   "Activities associated with this agent session."   activities(filter: AgentActivityFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): AgentActivityConnection!
   "The URL of an external agent-hosted page associated with this session."   externalLink: String @deprecated(reason: "Use externalUrls instead.")
-  "A summary of the activities in this session."   summary: String
+  "A human-readable summary of the work performed in this session. Null if no summary has been generated yet."   summary: String
   "Metadata about the external source that created this agent session."   sourceMetadata: JSON
-  "A dynamically updated list of the agent's execution strategy."   plan: JSON
-  "Serialized JSON representing the contexts this session is related to, for direct chat sessions."   context: JSON!
+  "A dynamically updated plan describing the agent's execution strategy, including steps to be taken and their current status. Updated as the agent progresses through its work. Null if no plan has been set."   plan: JSON
+  "The entity contexts this session is related to, such as issues or projects referenced in direct chat sessions. Used to provide contextual awareness to the agent."   context: JSON!
   "[DEPRECATED] The type of the agent session."   type: AgentSessionType @deprecated(reason: "This field is slated for removal.")
-  "Agent session URL."   url: String
+  "The URL to the agent session page in the Linear app. Null for direct chat sessions without an associated issue."   url: String
   "[Internal] Pull requests associated with this agent session."   pullRequests(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): AgentSessionToPullRequestConnection!
   "External links associated with this session."   externalLinks: [AgentSessionExternalLink!]!
   "URLs of external resources associated with this session."   externalUrls: JSON! @deprecated(reason: "Use externalLinks instead.")
@@ -4466,7 +4864,7 @@ type AgentSessionPayload {
   "The agent session that was created or updated."   agentSession: AgentSession!
 }
 
-"Join table between agent sessions and pull requests." type AgentSessionToPullRequest implements Node {
+"A link between an agent session and a pull request created or associated during that session. This join entity tracks which pull requests were produced by or connected to a coding agent's work session, and handles backfilling links when pull requests are synced after the agent has already recorded the URL." type AgentSessionToPullRequest implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -4488,143 +4886,538 @@ type AgentSessionToPullRequestEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"AI prompt rules for a team." type AiPromptRules implements Node {
+"[Internal] A conversation between a user and the Linear AI assistant. Each conversation tracks the full thread state, context references (issues, projects, documents, etc.), and conversation parts (prompts, text responses, tool calls, widgets). Conversations can originate from direct chat, issue comments, Slack threads, Microsoft Teams, or automated workflows." type AiConversation implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The user who last updated the AI prompt rules."   updatedBy: User
+  "The user who the conversation belongs to."   user: User
+  "The entity contexts this conversation is related to, such as issues, projects, or documents that provide context for the AI assistant."   context: JSONObject!
+  "A summary of the conversation."   summary: String
+  "The conversation's unique URL slug."   slugId: String!
+  "[Internal] The workflow definition that created this conversation."   workflowDefinition: WorkflowDefinition
+  "The source from which this conversation was initiated, such as direct chat, an issue comment, a Slack thread, Microsoft Teams, or a workflow automation."   initialSource: AiConversationInitialSource!
+  "The current processing status of the conversation, indicating whether the AI is actively generating a response or has completed its turn."   status: AiConversationStatus!
+  "The time when the user marked the conversation as read. Null if the user hasn't read the conversation."   readAt: DateTime
+  "The ordered sequence of conversation parts (prompts, text responses, reasoning steps, tool calls, and widgets) that make up this conversation's visible history."   parts: [AiConversationPart!]
+  "The iteration ID when this conversation is part of an agentic workflow. Used to track multi-step workflow executions. Null for non-workflow conversations."   iterationId: String
+  "[Internal] The log ID of the AI response."   evalLogId: String
 }
 
-"Public information of the OAuth application." type Application {
-  "OAuth application's ID."   id: String!
-  "OAuth application's client ID."   clientId: String!
-  "Application name."   name: String!
-  "Information about the application."   description: String
-  "Name of the developer."   developer: String!
-  "Url of the developer (homepage or docs)."   developerUrl: String!
-  "Image of the application."   imageUrl: String
+type AiConversationCodeIntelligenceToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationCodeIntelligenceToolCallArgs
 }
 
-"Contains requested archived model objects." type ArchiveResponse {
-  "A JSON serialized collection of model objects loaded from the archive"   archive: String!
-  "The total number of entities in the archive."   totalCount: Float!
-  "The version of the remote database. Incremented by 1 for each migration run on the database."   databaseVersion: Float!
-  "Whether the dependencies for the model objects are included in the archive."   includesDependencies: [String!]!
+type AiConversationCodeIntelligenceToolCallArgs {
+  question: String!
 }
 
-type AsksChannelConnectPayload {
-  "The identifier of the last sync operation."   lastSyncId: Float!
-  "The integration that was created or updated."   integration: Integration
-  "Whether the operation was successful."   success: Boolean!
-  "The new Asks Slack channel mapping for the connected channel."   mapping: SlackChannelNameMapping!
-  "Whether the bot needs to be manually added to the channel."   addBot: Boolean!
+type AiConversationCreateEntityToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationCreateEntityToolCallArgs
 }
 
-"A web page for an Asks web form." type AsksWebPage implements Node {
-  "The unique identifier of the entity."   id: ID!
-  "The time at which the entity was created."   createdAt: DateTime!
-  """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
-    been updated after creation."""
-  updatedAt: DateTime!
-  "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The organization that the Asks web page belongs to."   organization: Organization!
-  "The Asks web settings this page belongs to."   asksWebSettings: AsksWebSettings!
-  "The user who created the Asks web page."   creator: User
-  "The title of the page."   title: String!
-  "The description of the page."   description: String
-  "The page's unique URL slug."   slugId: String!
-  "The auto-reply message for issue created. If not set, the default reply will be used."   issueCreatedAutoReply: String
-  "Whether the auto-reply for issue created is enabled."   issueCreatedAutoReplyEnabled: Boolean!
-  "The auto-reply message for issue completed. If not set, the default reply will be used."   issueCompletedAutoReply: String
-  "Whether the auto-reply for issue completed is enabled."   issueCompletedAutoReplyEnabled: Boolean!
-  "The auto-reply message for issue canceled. If not set, the default reply will be used."   issueCanceledAutoReply: String
-  "Whether the auto-reply for issue canceled is enabled."   issueCanceledAutoReplyEnabled: Boolean!
+type AiConversationCreateEntityToolCallArgs {
+  type: String!
+  count: Float
 }
 
-type AsksWebPagePayload {
-  "The identifier of the last sync operation."   lastSyncId: Float!
-  "The Asks web page that was created or updated."   asksWebPage: AsksWebPage!
-  "Whether the operation was successful."   success: Boolean!
+type AiConversationDeleteEntityToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationDeleteEntityToolCallArgs
 }
 
-"Settings for an Asks web form." type AsksWebSettings implements Node {
-  "The unique identifier of the entity."   id: ID!
-  "The time at which the entity was created."   createdAt: DateTime!
-  """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
-    been updated after creation."""
-  updatedAt: DateTime!
-  "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The organization that the Asks web settings are associated with."   organization: Organization!
-  "The user who created the Asks web settings."   creator: User
-  "The custom domain for the Asks web form. If null, the default Linear-hosted domain will be used."   domain: String
-  "The email intake address associated with these Asks web settings."   emailIntakeAddress: EmailIntakeAddress
-  "The identity provider for SAML authentication on this Asks web form."   identityProvider: IdentityProvider
+type AiConversationDeleteEntityToolCallArgs {
+  entity: AiConversationSearchEntitiesToolCallResultEntities!
 }
 
-type AsksWebSettingsPayload {
-  "The identifier of the last sync operation."   lastSyncId: Float!
-  "The Asks web settings that were created or updated."   asksWebSettings: AsksWebSettings!
-  "Whether the operation was successful."   success: Boolean!
+type AiConversationEntityCardWidget implements AiConversationBaseWidget {
+  "The name of the widget."   name: AiConversationWidgetName!
+  "The arguments of the widget."   rawArgs: JSON
+  "Display information for the widget, including ProseMirror and Markdown representations."   displayInfo: AiConversationWidgetDisplayInfo
+  "The arguments to the widget."   args: AiConversationEntityCardWidgetArgs
 }
 
-"Issue attachment (e.g. support ticket, pull request)." type Attachment implements Node {
-  "The unique identifier of the entity."   id: ID!
-  "The time at which the entity was created."   createdAt: DateTime!
-  """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
-    been updated after creation."""
-  updatedAt: DateTime!
-  "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "Content for the title line in the Linear attachment widget."   title: String!
-  "Content for the subtitle line in the Linear attachment widget."   subtitle: String
-  "Location of the attachment which is also used as an identifier."   url: String!
-  "The creator of the attachment."   creator: User
-  "The non-Linear user who created the attachment."   externalUserCreator: ExternalUser
-  "Custom metadata related to the attachment."   metadata: JSONObject!
-  "Information about the source which created the attachment."   source: JSONObject
-  "An accessor helper to source.type, defines the source type of the attachment."   sourceType: String
-  "Indicates if attachments for the same source application should be grouped in the Linear UI."   groupBySource: Boolean!
-  "The issue this attachment was originally created on. Will be undefined if the attachment hasn't been moved."   originalIssue: Issue
-  "The issue this attachment belongs to."   issue: Issue!
-  "The body data of the attachment, if any."   bodyData: String
+type AiConversationEntityCardWidgetArgs {
+  "[Internal] The entity type"   type: AiConversationEntityCardWidgetArgsType!
+  "The UUID of the entity to display"   id: String!
+  "@deprecated Optional note to display about the entity"   note: String @deprecated(reason: "Optional note to display about the entity")
+  "The action performed on the entity (leave empty if just found)"   action: AiConversationEntityCardWidgetArgsAction
 }
 
-type AttachmentConnection {
-  edges: [AttachmentEdge!]!
-  nodes: [Attachment!]!
-  pageInfo: PageInfo!
+type AiConversationEntityListWidget implements AiConversationBaseWidget {
+  "The name of the widget."   name: AiConversationWidgetName!
+  "The arguments of the widget."   rawArgs: JSON
+  "Display information for the widget, including ProseMirror and Markdown representations."   displayInfo: AiConversationWidgetDisplayInfo
+  "The arguments to the widget."   args: AiConversationEntityListWidgetArgs
 }
 
-type AttachmentEdge {
-  node: Attachment!
-  "Used in `before` and `after` args"   cursor: String!
+type AiConversationEntityListWidgetArgs {
+  "Total number of entities in the list"   count: Float
+  entities: [AiConversationEntityListWidgetArgsEntities!]!
+  "The action performed on the entities (leave empty if just found)"   action: AiConversationEntityListWidgetArgsAction
 }
 
-type AttachmentPayload {
-  "The identifier of the last sync operation."   lastSyncId: Float!
-  "The issue attachment that was created."   attachment: Attachment!
-  "Whether the operation was successful."   success: Boolean!
+type AiConversationEntityListWidgetArgsEntities {
+  "[Internal] The entity type"   type: AiConversationEntityListWidgetArgsEntitiesType!
+  "Entity UUID"   id: String!
+  "@deprecated Optional note to display about the entity"   note: String @deprecated(reason: "Optional note to display about the entity")
 }
 
-type AttachmentSourcesPayload {
-  "A unique list of all source types used in this workspace."   sources: JSONObject!
+type AiConversationGetMicrosoftTeamsConversationHistoryToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
 }
 
-"Workspace audit log entry object." type AuditEntry implements Node {
-  "The unique identifier of the entity."   id: ID!
-  "The time at which the entity was created."   createdAt: DateTime!
-  """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
-    been updated after creation."""
-  updatedAt: DateTime!
-  "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
+type AiConversationGetPullRequestDiffToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationGetPullRequestDiffToolCallArgs
+}
+
+type AiConversationGetPullRequestDiffToolCallArgs {
+  entity: AiConversationSearchEntitiesToolCallResultEntities!
+}
+
+type AiConversationGetPullRequestFileToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationGetPullRequestFileToolCallArgs
+}
+
+type AiConversationGetPullRequestFileToolCallArgs {
+  entity: AiConversationSearchEntitiesToolCallResultEntities!
+  path: String!
+}
+
+type AiConversationGetSlackConversationHistoryToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+}
+
+type AiConversationHandoffToCodingSessionToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationHandoffToCodingSessionToolCallArgs
+}
+
+type AiConversationHandoffToCodingSessionToolCallArgs {
+  entity: AiConversationSearchEntitiesToolCallResultEntities!
+  instructions: String
+}
+
+type AiConversationInvokeMcpToolToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationInvokeMcpToolToolCallArgs
+}
+
+type AiConversationInvokeMcpToolToolCallArgs {
+  server: AiConversationInvokeMcpToolToolCallArgsServer!
+  tool: AiConversationInvokeMcpToolToolCallArgsTool!
+}
+
+type AiConversationInvokeMcpToolToolCallArgsServer {
+  integrationId: String!
+  name: String!
+  title: String
+}
+
+type AiConversationInvokeMcpToolToolCallArgsTool {
+  name: String!
+  title: String
+}
+
+type AiConversationNavigateToPageToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationNavigateToPageToolCallArgs
+  "The result of the tool call."   result: AiConversationNavigateToPageToolCallResult
+}
+
+type AiConversationNavigateToPageToolCallArgs {
+  entityType: String
+  identifier: String
+}
+
+type AiConversationNavigateToPageToolCallResult {
+  url: String!
+  newTab: Boolean
+}
+
+"Metadata about a part in an AI conversation." type AiConversationPartMetadata {
+  "The turn ID of the part."   turnId: String!
+  "The eval log ID of the part."   evalLogId: String
+  "The time when the part started, as an ISO 8601 string."   startedAt: String
+  "The time when the part ended, as an ISO 8601 string."   endedAt: String
+  "The phase during which the part was generated."   phase: AiConversationPartPhase
+  "AI feedback state for this part."   feedback: JSONObject
+}
+
+"A prompt part in an AI conversation." type AiConversationPromptPart implements AiConversationBasePart {
+  "The ID of the part."   id: String!
+  "The type of the part."   type: AiConversationPartType!
+  "The metadata of the part."   metadata: AiConversationPartMetadata!
+  "The data of the prompt part."   bodyData: JSONObject!
+  "The Markdown body of the prompt part."   body: String!
+  "The user who created the prompt part."   user: User
+}
+
+type AiConversationQueryActivityToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationQueryActivityToolCallArgs
+}
+
+type AiConversationQueryActivityToolCallArgs {
+  entities: [AiConversationSearchEntitiesToolCallResultEntities!]
+}
+
+type AiConversationQueryUpdatesToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationQueryUpdatesToolCallArgs
+}
+
+type AiConversationQueryUpdatesToolCallArgs {
+  updateType: AiConversationQueryUpdatesToolCallArgsUpdateType!
+  entity: AiConversationSearchEntitiesToolCallResultEntities
+}
+
+type AiConversationQueryViewToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationQueryViewToolCallArgs
+}
+
+type AiConversationQueryViewToolCallArgs {
+  view: AiConversationQueryViewToolCallArgsView!
+  mode: AiConversationQueryViewToolCallArgsMode!
+  filter: String
+}
+
+type AiConversationQueryViewToolCallArgsView {
   type: String!
-  "The organization the audit log belongs to."   organization: Organization
+  group: AiConversationSearchEntitiesToolCallResultEntities
+  predefinedView: String
+}
+
+"A reasoning part in an AI conversation." type AiConversationReasoningPart implements AiConversationBasePart {
+  "The ID of the part."   id: String!
+  "The type of the part."   type: AiConversationPartType!
+  "The metadata of the part."   metadata: AiConversationPartMetadata!
+  "The title of the reasoning part."   title: String
+  "The data of the reasoning part."   bodyData: JSONObject!
+  "The Markdown body of the reasoning part."   body: String!
+}
+
+type AiConversationResearchToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationResearchToolCallArgs
+  "The result of the tool call."   result: AiConversationResearchToolCallResult
+}
+
+type AiConversationResearchToolCallArgs {
+  context: String!
+  query: String!
+  subjects: [AiConversationSearchEntitiesToolCallResultEntities!]
+}
+
+type AiConversationResearchToolCallResult {
+  progressId: String
+}
+
+type AiConversationRestoreEntityToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationRestoreEntityToolCallArgs
+}
+
+type AiConversationRestoreEntityToolCallArgs {
+  entity: AiConversationSearchEntitiesToolCallResultEntities!
+}
+
+type AiConversationRetrieveEntitiesToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationRetrieveEntitiesToolCallArgs
+}
+
+type AiConversationRetrieveEntitiesToolCallArgs {
+  entities: [AiConversationSearchEntitiesToolCallResultEntities!]!
+}
+
+type AiConversationSearchDocumentationToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+}
+
+type AiConversationSearchEntitiesToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationSearchEntitiesToolCallArgs
+  "The result of the tool call."   result: AiConversationSearchEntitiesToolCallResult
+}
+
+type AiConversationSearchEntitiesToolCallArgs {
+  type: String
+  queries: [String!]!
+}
+
+type AiConversationSearchEntitiesToolCallResult {
+  entities: [AiConversationSearchEntitiesToolCallResultEntities!]!
+}
+
+type AiConversationSearchEntitiesToolCallResultEntities {
+  type: String!
+  id: String!
+}
+
+type AiConversationSuggestValuesToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationSuggestValuesToolCallArgs
+}
+
+type AiConversationSuggestValuesToolCallArgs {
+  field: String!
+  query: String
+}
+
+"A text part in an AI conversation." type AiConversationTextPart implements AiConversationBasePart {
+  "The ID of the part."   id: String!
+  "The type of the part."   type: AiConversationPartType!
+  "The metadata of the part."   metadata: AiConversationPartMetadata!
+  "The data of the text part."   bodyData: JSONObject!
+  "The Markdown body of the text part."   body: String!
+}
+
+"A tool call part in an AI conversation." type AiConversationToolCallPart implements AiConversationBasePart {
+  "The ID of the part."   id: String!
+  "The type of the part."   type: AiConversationPartType!
+  "The metadata of the part."   metadata: AiConversationPartMetadata!
+  "The tool call part."   toolCall: AiConversationToolCall!
+}
+
+type AiConversationToolDisplayInfo {
+  icon: String!
+  activeLabel: String!
+  inactiveLabel: String!
+  detail: String
+  result: String
+}
+
+type AiConversationTranscribeMediaToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+}
+
+type AiConversationTranscribeVideoToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+}
+
+type AiConversationUpdateEntityToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationUpdateEntityToolCallArgs
+}
+
+type AiConversationUpdateEntityToolCallArgs {
+  entity: AiConversationSearchEntitiesToolCallResultEntities
+  entities: [AiConversationSearchEntitiesToolCallResultEntities!]
+}
+
+type AiConversationWebSearchToolCall implements AiConversationBaseToolCall {
+  "The name of the tool that was called."   name: AiConversationTool!
+  displayInfo: AiConversationToolDisplayInfo!
+  "The arguments of the tool call."   rawArgs: JSON
+  "The result of the tool call."   rawResult: JSON
+  "The arguments to the tool call."   args: AiConversationWebSearchToolCallArgs
+}
+
+type AiConversationWebSearchToolCallArgs {
+  query: String
+  url: String
+}
+
+type AiConversationWidgetDisplayInfo {
+  "The ProseMirror data representation of the widget content."   bodyData: JSONObject!
+  "The Markdown representation of the widget content."   body: String!
+}
+
+"A widget part in an AI conversation." type AiConversationWidgetPart implements AiConversationBasePart {
+  "The ID of the part."   id: String!
+  "The type of the part."   type: AiConversationPartType!
+  "The metadata of the part."   metadata: AiConversationPartMetadata!
+  "The widget."   widget: AiConversationWidget!
+}
+
+"[Internal] Tracks the progress and state of an AI prompt workflow execution. Each progress record is associated with an issue or comment and contains the workflow type, current status, metadata about the execution, and optionally the conversation messages exchanged during the workflow. Progress records can form a hierarchy via parent-child relationships for multi-step workflows." type AiPromptProgress implements Node {
+  "The unique identifier of the entity."   id: ID!
+  "The time at which the entity was created."   createdAt: DateTime!
+  """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
+    been updated after creation."""
+  updatedAt: DateTime!
+  "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
+  "[Internal] The type of AI prompt workflow."   type: AiPromptType!
+  "[Internal] The status of the prompt workflow."   status: AiPromptProgressStatus!
+  "[Internal] The metadata for the prompt workflow."   metadata: JSONObject!
+  "[Internal] The log ID for the prompt workflow, if available."   logId: String
+}
+
+type AiPromptProgressConnection {
+  edges: [AiPromptProgressEdge!]!
+  nodes: [AiPromptProgress!]!
+  pageInfo: PageInfo!
+}
+
+type AiPromptProgressEdge {
+  node: AiPromptProgress!
+  "Used in `before` and `after` args"   cursor: String!
+}
+
+"Custom rules that guide AI behavior for a specific scope. Rules can be defined at the workspace level, team level, integration level, or user level, and are applied hierarchically (workspace rules first, then parent team rules, then team rules). Rules contain structured content that instructs the AI assistant on how to handle specific types of prompts, such as coding agent guidance or triage intelligence configuration." type AiPromptRules implements Node {
+  "The unique identifier of the entity."   id: ID!
+  "The time at which the entity was created."   createdAt: DateTime!
+  """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
+    been updated after creation."""
+  updatedAt: DateTime!
+  "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
+  "The user who last updated the AI prompt rules."   updatedBy: User
+}
+
+"Public-facing information about an OAuth application. Contains only the fields that are safe to display to users during the authorization flow, excluding sensitive data like client secrets and internal configuration." type Application {
+  "OAuth application's ID."   id: String!
+  "OAuth application's client ID."   clientId: String!
+  "Application name."   name: String!
+  "Information about the application."   description: String
+  "Name of the developer."   developer: String!
+  "URL of the developer's website, homepage, or documentation."   developerUrl: String!
+  "Image of the application."   imageUrl: String
+}
+
+"Contains requested archived model objects." type ArchiveResponse {
+  "A JSON serialized collection of model objects loaded from the archive"   archive: String!
+  "The total number of entities in the archive."   totalCount: Float!
+  "The version of the remote database. Incremented by 1 for each migration run on the database."   databaseVersion: Float!
+  "Whether the dependencies for the model objects are included in the archive."   includesDependencies: [String!]!
+}
+
+type AsksChannelConnectPayload {
+  "The identifier of the last sync operation."   lastSyncId: Float!
+  "The integration that was created or updated."   integration: Integration
+  "Whether the operation was successful."   success: Boolean!
+  "The new Asks Slack channel mapping for the connected channel."   mapping: SlackChannelNameMapping!
+  "Whether the bot needs to be manually added to the channel."   addBot: Boolean!
+}
+
+"An attachment linking external content to an issue. Attachments represent connections to external resources such as GitHub pull requests, Slack messages, Zendesk tickets, Figma files, Sentry issues, Intercom conversations, and plain URLs. Each attachment has a title and subtitle displayed in the Linear UI, a URL serving as both the link destination and unique identifier per issue, and optional metadata specific to the source integration." type Attachment implements Node {
+  "The unique identifier of the entity."   id: ID!
+  "The time at which the entity was created."   createdAt: DateTime!
+  """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
+    been updated after creation."""
+  updatedAt: DateTime!
+  "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
+  "Content for the title line in the Linear attachment widget."   title: String!
+  "Content for the subtitle line in the Linear attachment widget."   subtitle: String
+  "The URL of the external resource this attachment links to. Also serves as a unique identifier for the attachment within an issue; no two attachments on the same issue can share the same URL."   url: String!
+  "The creator of the attachment."   creator: User
+  "The non-Linear user who created the attachment."   externalUserCreator: ExternalUser
+  "Integration-specific metadata for this attachment. The schema varies by source type and may include fields such as pull request status, review counts, commit information, ticket status, or other data from the external system."   metadata: JSONObject!
+  "Information about the source which created the attachment."   source: JSONObject
+  "The source type of the attachment, derived from the source metadata. Returns the integration type (e.g., 'github', 'slack', 'zendesk') or 'unknown' if no source is set."   sourceType: String
+  "Whether attachments from the same source application should be visually grouped together in the Linear issue detail view."   groupBySource: Boolean!
+  "The issue this attachment was originally created on. Null if the attachment hasn't been moved."   originalIssue: Issue
+  "The issue this attachment belongs to."   issue: Issue!
+  "The body data of the attachment, if any."   bodyData: String
+}
+
+type AttachmentConnection {
+  edges: [AttachmentEdge!]!
+  nodes: [Attachment!]!
+  pageInfo: PageInfo!
+}
+
+type AttachmentEdge {
+  node: Attachment!
+  "Used in `before` and `after` args"   cursor: String!
+}
+
+"The result of an attachment mutation." type AttachmentPayload {
+  "The identifier of the last sync operation."   lastSyncId: Float!
+  "The issue attachment that was created."   attachment: Attachment!
+  "Whether the operation was successful."   success: Boolean!
+}
+
+"The result of an attachment sources query." type AttachmentSourcesPayload {
+  "A unique list of all source types used in this workspace."   sources: JSONObject!
+}
+
+"A workspace audit log entry recording a security or compliance-relevant action. Audit entries capture who performed an action, when, from what IP address and country, and include type-specific metadata. The audit log is partitioned by time for performance and is accessible only to workspace administrators. Examples of audited actions include user authentication events, permission changes, data exports, and workspace setting modifications." type AuditEntry implements Node {
+  "The unique identifier of the entity."   id: ID!
+  "The time at which the entity was created."   createdAt: DateTime!
+  """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
+    been updated after creation."""
+  updatedAt: DateTime!
+  "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
+  "The type of audited action (e.g., user authentication, permission change, data export, setting modification)."   type: String!
+  "The workspace the audit log belongs to."   organization: Organization
   "The user that caused the audit entry to be created."   actor: User
   "The ID of the user that caused the audit entry to be created."   actorId: String
-  "IP from actor when entry was recorded."   ip: String
-  "Country code of request resulting to audit entry."   countryCode: String
+  "The IP address of the actor at the time the audited action was performed. Null if the IP was not captured."   ip: String
+  "The ISO 3166-1 alpha-2 country code derived from the request IP address. Null if geo-location could not be determined."   countryCode: String
   "Additional metadata related to the audit entry."   metadata: JSONObject
   "Additional information related to the request which performed the action."   requestInformation: JSONObject
 }
@@ -4673,10 +5466,12 @@ type AuditEntryType {
   "The feature release channel the organization belongs to."   releaseChannel: ReleaseChannel!
   "Whether SAML authentication is enabled for organization."   samlEnabled: Boolean!
   "[INTERNAL] SAML settings"   samlSettings: JSONObject
-  "Allowed authentication providers, empty array means all are allowed"   allowedAuthServices: [String!]!
+  "Allowed authentication providers, empty array means all are allowed"   allowedAuthServices: [String!]! @deprecated(reason: "Use authSettings.allowedAuthServices instead.")
+  "Authentication settings for the organization."   authSettings: JSONObject!
   "Whether SCIM provisioning is enabled for organization."   scimEnabled: Boolean!
   "The email domain or URL key for the organization."   serviceId: String!
   "The region the organization is hosted in."   region: String!
+  "An approximate count of users, updated once per day."   approximateUserCount: Float!
   "Whether to hide other organizations for new users signing up with email domains claimed by this organization."   hideNonPrimaryOrganizations: Boolean!
   userCount: Float
 }
@@ -4708,7 +5503,7 @@ type AuthResolverResponse {
   "[INTERNAL] Identity provider the user is managed by."   identityProvider: AuthIdentityProvider
 }
 
-"Authentication session information." type AuthenticationSessionResponse {
+"Information about an active authentication session, including the device, location, and timestamps for when it was created and last used." type AuthenticationSessionResponse {
   "The time at which the entity was created."   createdAt: DateTime!
   id: String!
   "Type of application used to authenticate."   type: AuthenticationSessionType!
@@ -4727,44 +5522,72 @@ type AuthResolverResponse {
   "Operating system used for the session"   operatingSystem: String
   "Client used for the session"   client: String
   "Name of the session, derived from the client and operating system"   name: String!
-  "Identifies the session used to make the request."   isCurrentSession: Boolean!
+  "Detailed name of the session including version information, derived from the user agent."   detailedName: String!
+  "Whether this session is the one used to make the current API request."   isCurrentSession: Boolean!
 }
 
-"A comment associated with an issue." type Comment implements Node {
+"[Internal] Detailed information about the coding agent sandbox environment associated with an agent session, including cloud infrastructure URLs for debugging and monitoring." type CodingAgentSandboxEntry {
+  "The sandbox identifier."   id: String!
+  "The user who initiated the session."   creatorId: String
+  "The URL of the running sandbox environment. Null when the sandbox is hibernated or destroyed."   sandboxUrl: String
+  "URL to the sandbox execution logs in Modal. Null if the sandbox has no URL or is not running on Modal."   sandboxLogsUrl: String
+  "The Claude Agent SDK session ID used for resuming multi-turn conversations with the sandbox worker."   workerConversationId: String
+  "GitHub repository in owner/repo format."   repository: String!
+  "The Git branch name created for this sandbox session. Null if a branch has not yet been assigned."   branchName: String
+  "The Git ref (branch, tag, or commit) that was checked out as the base for this sandbox. Defaults to the repository's default branch."   baseRef: String
+  "The time at which the sandbox was created."   createdAt: DateTime!
+  "The time at which the sandbox first became active. Null if not yet started."   startedAt: DateTime
+  "The time at which the session reached a terminal state. Null if still active."   endedAt: DateTime
+}
+
+"[Internal] Coding agent sandbox details for an agent session." type CodingAgentSandboxPayload {
+  "The agent session identifier."   agentSessionId: String!
+  "All sandbox containers for this session, oldest first."   sandboxes: [CodingAgentSandboxEntry!]!
+  "Datadog logs URL covering all sandboxes in the session."   datadogLogsUrl: String
+  "Temporal URL to view workflows for this session."   temporalWorkflowsUrl: String
+}
+
+"A comment associated with an issue, project update, initiative update, document content, post, project, or initiative. Comments support rich text (ProseMirror), emoji reactions, and threaded replies via parentId. Comments can be created by workspace users or by external users through integrations (e.g., Slack, Intercom). Each comment belongs to exactly one parent entity." type Comment implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The comment content in markdown format."   body: String!
-  "The issue that the comment is associated with."   issue: Issue
-  "The ID of the issue that the comment is associated with."   issueId: String
-  "The document content that the comment is associated with."   documentContent: DocumentContent
-  "The ID of the document content that the comment is associated with."   documentContentId: String
-  "The project update that the comment is associated with."   projectUpdate: ProjectUpdate
-  "The ID of the project update that the comment is associated with."   projectUpdateId: String
-  "The initiative update that the comment is associated with."   initiativeUpdate: InitiativeUpdate
-  "The ID of the initiative update that the comment is associated with."   initiativeUpdateId: String
-  "The post that the comment is associated with."   post: Post
-  "The parent comment under which the current comment is nested."   parent: Comment
-  "The ID of the parent comment under which the current comment is nested."   parentId: String
-  "The user that resolved the thread."   resolvingUser: User
-  "The time the resolvingUser resolved the thread."   resolvedAt: DateTime
-  "The comment that resolved the thread."   resolvingComment: Comment
-  "The ID of the comment that resolved the thread."   resolvingCommentId: String
-  "The user who wrote the comment."   user: User
-  "The external user who wrote the comment."   externalUser: ExternalUser
-  "The time user edited the comment."   editedAt: DateTime
-  "[Internal] The comment content as a Prosemirror document."   bodyData: String!
-  "The text that this comment references. Only defined for inline comments."   quotedText: String
-  "Emoji reaction summary, grouped by emoji type."   reactionData: JSONObject!
-  "[Internal] A generated summary of the comment thread."   threadSummary: JSONObject
+  "The comment content in markdown format. This is a derived representation of the canonical bodyData ProseMirror content."   body: String!
+  "The issue that the comment is associated with. Null if the comment belongs to a different parent entity type."   issue: Issue
+  "The ID of the issue that the comment is associated with. Null if the comment belongs to a different parent entity type."   issueId: String
+  "The document content that the comment is associated with. Null if the comment belongs to a different parent entity type. Used for inline comments on documents."   documentContent: DocumentContent
+  "The ID of the document content that the comment is associated with. Null if the comment belongs to a different parent entity type."   documentContentId: String
+  "The project update that the comment is associated with. Null if the comment belongs to a different parent entity type."   projectUpdate: ProjectUpdate
+  "The ID of the project update that the comment is associated with. Null if the comment belongs to a different parent entity type."   projectUpdateId: String
+  "The initiative update that the comment is associated with. Null if the comment belongs to a different parent entity type."   initiativeUpdate: InitiativeUpdate
+  "The ID of the initiative update that the comment is associated with. Null if the comment belongs to a different parent entity type."   initiativeUpdateId: String
+  "The post that the comment is associated with. Null if the comment belongs to a different parent entity type."   post: Post
+  "[Internal] The project that the comment is associated with. Used for project-level discussion threads. Null if the comment belongs to a different parent entity type."   project: Project
+  "[Internal] The ID of the project that the comment is associated with. Null if the comment belongs to a different parent entity type."   projectId: String
+  "[Internal] The initiative that the comment is associated with. Null if the comment belongs to a different parent entity type."   initiative: Initiative
+  "[Internal] The ID of the initiative that the comment is associated with. Null if the comment belongs to a different parent entity type."   initiativeId: String
+  "The parent comment under which the current comment is nested. Null for top-level comments that are not replies."   parent: Comment
+  "The ID of the parent comment under which the current comment is nested. Null for top-level comments."   parentId: String
+  "The user that resolved the comment thread. Null if the thread has not been resolved or if this is not a top-level comment."   resolvingUser: User
+  "The time when the comment thread was resolved. Null if the thread is unresolved."   resolvedAt: DateTime
+  "The child comment that resolved this thread. Only set on top-level (parent) comments. Null if the thread is unresolved."   resolvingComment: Comment
+  "The ID of the child comment that resolved this thread. Null if the thread is unresolved."   resolvingCommentId: String
+  "The user who wrote the comment. Null for comments created by integrations or bots without a user association."   user: User
+  "The external user who wrote the comment, when the comment was created through an integration such as Slack or Intercom. Null for comments created by workspace users."   externalUser: ExternalUser
+  "The time the comment was last edited by its author. Null if the comment has not been edited since creation."   editedAt: DateTime
+  "[Internal] The comment content as a ProseMirror document. This is the canonical rich-text representation of the comment body."   bodyData: String!
+  "The text that this comment references, used for inline comments on documents or issue descriptions. Null for standard comments that do not quote specific text."   quotedText: String
+  "Emoji reaction summary for this comment, grouped by emoji type. Each entry contains the emoji name, count, and the IDs of users who reacted."   reactionData: JSONObject!
+  "[Internal] An AI-generated summary of the comment thread. Null if no summary has been generated or if this is not a top-level comment."   threadSummary: JSONObject
   "[Internal] Whether the comment is an artificial placeholder for an agent session thread created without a comment mention."   isArtificialAgentSessionRoot: Boolean!
   "Comment's URL."   url: String!
   "The children of the comment."   children(filter: CommentFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CommentConnection!
   "Agent session associated with this comment."   agentSession: AgentSession
   "[Internal] Agent sessions associated with this comment."   agentSessions(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): AgentSessionConnection!
+  "[Internal] Agent sessions spawned from this comment."   spawnedAgentSessions(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): AgentSessionConnection!
+  "[Internal] AI prompt progresses associated with this comment."   aiPromptProgresses(filter: AiPromptProgressFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): AiPromptProgressConnection!
   "Issues created from this comment."   createdIssues(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
   "The bot that created the comment."   botActor: ActorBot
   "[Internal] The user on whose behalf the comment was created, e.g. when the Linear assistant creates a comment for a user."   onBehalfOf: User
@@ -4785,57 +5608,57 @@ type CommentEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type CommentPayload {
+"The result of a comment mutation." type CommentPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The comment that was created or updated."   comment: Comment!
   "Whether the operation was successful."   success: Boolean!
 }
 
-type ContactPayload {
+"Return type for contact mutations." type ContactPayload {
   "Whether the operation was successful."   success: Boolean!
 }
 
-type CreateCsvExportReportPayload {
+"The payload returned by the createCsvExportReport mutation." type CreateCsvExportReportPayload {
   "Whether the operation was successful."   success: Boolean!
 }
 
-type CreateOrJoinOrganizationResponse {
-  organization: AuthOrganization!
-  user: AuthUser!
+"[INTERNAL] Response from creating or joining a workspace." type CreateOrJoinOrganizationResponse {
+  "The workspace that was created or joined."   organization: AuthOrganization!
+  "The user who created or joined the workspace."   user: AuthUser!
 }
 
-"A custom view that has been saved by a user." type CustomView implements Node {
+"A custom view built from a saved filter, sort, and grouping configuration. Views can be personal (visible only to the owner) or shared with the entire workspace. They define which issues, projects, initiatives, or feed items are displayed and how they are organized. Views can optionally be scoped to a team, project, or initiative." type CustomView implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The name of the custom view."   name: String!
+  "The name of the custom view, displayed in the sidebar and navigation."   name: String!
   "The description of the custom view."   description: String
-  "The icon of the custom view."   icon: String
-  "The color of the icon of the custom view."   color: String
-  "The organization of the custom view."   organization: Organization!
-  "The user who created the custom view."   creator: User!
-  "The user who owns the custom view."   owner: User!
-  "The user who last updated the custom view."   updatedBy: User
-  "The filters applied to issues in the custom view."   filters: JSONObject! @deprecated(reason: "Will be replaced by `filterData` in a future update")
-  "The filter applied to issues in the custom view."   filterData: JSONObject!
-  "The filter applied to projects in the custom view."   projectFilterData: JSONObject
-  "The filter applied to initiatives in the custom view."   initiativeFilterData: JSONObject
-  "The filter applied to feed items in the custom view."   feedItemFilterData: JSONObject
-  "Whether the custom view is shared with everyone in the organization."   shared: Boolean!
-  "The custom view's unique URL slug."   slugId: String!
-  "The model name of the custom view."   modelName: String!
-  "[INTERNAL] The facet associated with the custom view."   facet: Facet
-  "The team associated with the custom view."   team: Team
-  "Projects associated with the custom view."   projects(includeSubTeams: Boolean = true, filter: ProjectFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [ProjectSortInput!]): ProjectConnection!
-  "Issues associated with the custom view."   issues(includeSubTeams: Boolean = false, filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [IssueSortInput!]): IssueConnection!
-  "Feed items associated with the custom view."   updates(includeSubTeams: Boolean = false, filter: FeedItemFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): FeedItemConnection!
-  "The current users view preferences for this custom view."   userViewPreferences: ViewPreferences
-  "The organizations default view preferences for this custom view."   organizationViewPreferences: ViewPreferences
-  "The calculated view preferences values for this custom view."   viewPreferencesValues: ViewPreferencesValues
-  "Initiatives associated with the custom view."   initiatives(filter: InitiativeFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): InitiativeConnection!
+  "The icon of the custom view. Can be an emoji or a decorative icon identifier."   icon: String
+  "The hex color code of the custom view icon."   color: String
+  "The workspace of the custom view."   organization: Organization!
+  "The user who originally created the custom view."   creator: User!
+  "The user who owns the custom view. For personal views, only the owner can see and edit the view."   owner: User!
+  "The user who last updated the custom view. Null if the updater's account has been deleted."   updatedBy: User
+  "The legacy serialized filters applied to issues in the custom view."   filters: JSONObject! @deprecated(reason: "Will be replaced by `filterData` in a future update")
+  "The structured filter applied to issues in the custom view. Used when the view's modelName is \"Issue\"."   filterData: JSONObject!
+  "The filter applied to projects in the custom view. When set, this view displays projects instead of issues."   projectFilterData: JSONObject
+  "The filter applied to initiatives in the custom view. When set, this view displays initiatives instead of issues."   initiativeFilterData: JSONObject
+  "The filter applied to feed items in the custom view. When set, this view displays feed items (updates) instead of issues."   feedItemFilterData: JSONObject
+  "Whether the custom view is shared with everyone in the organization. Shared views appear in the workspace sidebar for all members. Personal (non-shared) views are only visible to their owner."   shared: Boolean!
+  "The custom view's unique URL slug, used to construct human-readable URLs. Automatically generated on creation."   slugId: String!
+  "The entity type this view displays. Determined by which filter is set: \"Project\" if projectFilterData is set, \"Initiative\" if initiativeFilterData is set, \"FeedItem\" if feedItemFilterData is set, or \"Issue\" by default."   modelName: String!
+  "[INTERNAL] The facet that links this custom view to its parent entity (project, initiative, team page, etc.). Null if the view is not attached to any parent via a facet."   facet: Facet
+  "The team that the custom view is scoped to. Null if the view is workspace-wide or scoped to a project/initiative instead."   team: Team
+  "Projects matching the custom view's project filter. Returns an empty connection if the view's modelName is not \"Project\"."   projects(includeSubTeams: Boolean = true, filter: ProjectFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [ProjectSortInput!]): ProjectConnection!
+  "Issues matching the custom view's issue filter. Returns an empty connection if the view's modelName is not \"Issue\"."   issues(includeSubTeams: Boolean = false, filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [IssueSortInput!]): IssueConnection!
+  "Feed items (updates) matching the custom view's feed item filter. Returns an empty connection if the view's modelName is not \"FeedItem\"."   updates(includeSubTeams: Boolean = false, filter: FeedItemFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): FeedItemConnection!
+  "The current user's personal view preferences for this custom view, if they have set any."   userViewPreferences: ViewPreferences
+  "The workspace-level default view preferences for this custom view, if any have been set."   organizationViewPreferences: ViewPreferences
+  "The computed view preferences values for this custom view, merging organization defaults with user overrides and system defaults. Use this for the effective display settings rather than reading raw preferences directly."   viewPreferencesValues: ViewPreferencesValues
+  "Initiatives matching the custom view's initiative filter. Returns an empty connection if the view's modelName is not \"Initiative\"."   initiatives(filter: InitiativeFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): InitiativeConnection!
 }
 
 type CustomViewConnection {
@@ -4849,66 +5672,67 @@ type CustomViewEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type CustomViewHasSubscribersPayload {
+"The result of a custom view subscribers check." type CustomViewHasSubscribersPayload {
   "Whether the custom view has subscribers."   hasSubscribers: Boolean!
 }
 
-"A custom view notification subscription." type CustomViewNotificationSubscription implements NotificationSubscription & Entity & Node {
+"A notification subscription scoped to a specific custom view. The subscriber receives notifications for events matching the custom view's filter criteria." type CustomViewNotificationSubscription implements NotificationSubscription & Entity & Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The user that subscribed to receive notifications."   subscriber: User!
-  "The customer associated with the notification subscription."   customer: Customer
+  "The user who will receive notifications from this subscription."   subscriber: User!
+  "The customer that this notification subscription is scoped to. Null if the subscription targets a different entity type."   customer: Customer
   "The custom view subscribed to."   customView: CustomView!
-  "The contextual cycle view associated with the notification subscription."   cycle: Cycle
-  "The contextual label view associated with the notification subscription."   label: IssueLabel
-  "The contextual project view associated with the notification subscription."   project: Project
-  "The contextual initiative view associated with the notification subscription."   initiative: Initiative
-  "The team associated with the notification subscription."   team: Team
-  "The user view associated with the notification subscription."   user: User
-  "The type of view to which the notification subscription context is associated with."   contextViewType: ContextViewType
-  "The type of user view to which the notification subscription context is associated with."   userContextViewType: UserContextViewType
-  "Whether the subscription is active or not."   active: Boolean!
-  "The type of subscription."   notificationSubscriptionTypes: [String!]!
-}
-
-type CustomViewPayload {
+  "The cycle that this notification subscription is scoped to. Null if the subscription targets a different entity type."   cycle: Cycle
+  "The issue label that this notification subscription is scoped to. Null if the subscription targets a different entity type."   label: IssueLabel
+  "The project that this notification subscription is scoped to. Null if the subscription targets a different entity type."   project: Project
+  "The initiative that this notification subscription is scoped to. Null if the subscription targets a different entity type."   initiative: Initiative
+  "The team that this notification subscription is scoped to. Null if the subscription targets a different entity type."   team: Team
+  "The user that this notification subscription is scoped to, for user-specific view subscriptions. Null if the subscription targets a different entity type."   user: User
+  "The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type."   contextViewType: ContextViewType
+  "The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type."   userContextViewType: UserContextViewType
+  "Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists."   active: Boolean!
+  "The notification event types that this subscription will deliver to the subscriber."   notificationSubscriptionTypes: [String!]!
+}
+
+"The result of a custom view mutation." type CustomViewPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The custom view that was created or updated."   customView: CustomView!
   "Whether the operation was successful."   success: Boolean!
 }
 
-type CustomViewSuggestionPayload {
+"The result of a custom view suggestion query." type CustomViewSuggestionPayload {
   "The suggested view name."   name: String
   "The suggested view description."   description: String
   "The suggested view icon."   icon: String
 }
 
-"A customer whose needs will be tied to issues or projects." type Customer implements Node {
+"A customer organization tracked in Linear's customer management system. Customers represent external companies or organizations whose product requests and feedback are captured as customer needs, which can be linked to issues and projects. Customers can be associated with domains, external system IDs, Slack channels, and managed by integrations such as Intercom or Salesforce." type Customer implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The customer's name."   name: String!
-  "The customer's logo URL."   logoUrl: String
-  "The domains associated with this customer."   domains: [String!]!
-  "The ids of the customers in external systems."   externalIds: [String!]!
-  "The ID of the Slack channel used to interact with the customer."   slackChannelId: String
-  "The user who owns the customer."   owner: User
-  "The current status of the customer."   status: CustomerStatus!
-  "The annual revenue generated by the customer."   revenue: Int
-  "The size of the customer."   size: Float
-  "The tier of the customer."   tier: CustomerTier
-  "The approximate number of needs of the customer."   approximateNeedCount: Float!
-  "The customer's unique URL slug."   slugId: String!
-  "The ID of the main source, when a customer has multiple sources. Must be one of externalIds."   mainSourceId: String
-  "The integration that manages the Customer."   integration: Integration
-  "URL of the customer in Linear."   url: String!
+  "The display name of the customer organization."   name: String!
+  "URL of the customer's logo image. Null if no logo has been uploaded."   logoUrl: String
+  "The email domains associated with this customer (e.g., 'acme.com'). Used to automatically match incoming requests to this customer. Public email domains (e.g., gmail.com) are not allowed. Domains must be unique across all customers in the workspace."   domains: [String!]!
+  "Identifiers for this customer in external systems (e.g., CRM IDs from Intercom, Salesforce, or HubSpot). Used for matching customers during integration syncs and upsert operations. External IDs must be unique across customers in the workspace."   externalIds: [String!]!
+  "The ID of the Slack channel linked to this customer for communication. Null if no Slack channel has been associated. Must be unique across all customers in the workspace."   slackChannelId: String
+  "The workspace member assigned as the owner of this customer. Null if no owner has been assigned. App users cannot be set as customer owners."   owner: User
+  "The current lifecycle status of the customer. Defaults to the first status by position when a customer is created without an explicit status."   status: CustomerStatus!
+  "The annual revenue generated by this customer. Null if revenue data has not been provided. May be synced from an external data source such as a CRM integration."   revenue: Int
+  "The number of employees or seats at the customer organization. Null if size data has not been provided. May be synced from an external data source such as a CRM integration."   size: Float
+  "The tier or segment assigned to this customer for prioritization (e.g., Enterprise, Pro, Free). Null if no tier has been assigned."   tier: CustomerTier
+  "The approximate count of customer needs (requests) associated with this customer. This is a denormalized counter and may not reflect the exact count at all times."   approximateNeedCount: Float!
+  "A unique, human-readable URL slug for the customer. Automatically generated and used in customer page URLs."   slugId: String!
+  "The primary external source ID when a customer has data from multiple external systems. Must be one of the values in the externalIds array. Null if the customer has zero or one external source."   mainSourceId: String
+  "The list of customer needs (product requests and feedback) associated with this customer."   needs: [CustomerNeed!]!
+  "The integration that manages this customer's data (e.g., Intercom, Salesforce). Null if the customer is not managed by any data source integration."   integration: Integration
+  "The URL of the customer's page in the Linear application."   url: String!
 }
 
 type CustomerConnection {
@@ -4922,25 +5746,25 @@ type CustomerEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"A customer need, expressed through a reference to an issue, project, or comment." type CustomerNeed implements Node {
+"A customer need represents a specific product request or piece of feedback from a customer. Customer needs serve as the bridge between customer feedback and engineering work by linking a customer to an issue or project, optionally with a comment or attachment providing additional context. Needs can be created manually, from integrations, or from intake sources like email." type CustomerNeed implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The customer that this need is attached to."   customer: Customer
-  "The issue this need is referencing."   issue: Issue
-  "The project this need is referencing."   project: Project
-  "The comment this need is referencing."   comment: Comment
-  "The attachment this need is referencing."   attachment: Attachment
-  "The project attachment this need is referencing."   projectAttachment: ProjectAttachment
+  "The customer organization this need belongs to. Null if the need has not yet been associated with a customer."   customer: Customer
+  "The issue this need is linked to. Either issueId or projectId must be set. When set, the need's projectId is denormalized from the issue's project."   issue: Issue
+  "The project this need is linked to. For issue-based needs, this is denormalized from the issue's project. For project-only needs, this is set directly."   project: Project
+  "An optional comment providing additional context for this need. Null if the need was not created from or associated with a specific comment."   comment: Comment
+  "The issue attachment linked to this need. Populated when the need originates from an intake source (e.g., Slack, Intercom) or when a URL is manually provided. Provides a link back to the original source of the customer feedback. Mutually exclusive with projectAttachment."   attachment: Attachment
+  "The project attachment linked to this need. Populated when the need originates from an intake source or when a URL is manually provided for a project-level need. Provides a link back to the original source of the customer feedback. Mutually exclusive with attachment."   projectAttachment: ProjectAttachment
   "Whether the customer need is important or not. 0 = Not important, 1 = Important."   priority: Float!
-  "The need content in markdown format."   body: String
-  "[Internal] The content of the need as a Prosemirror document."   bodyData: String
-  "The creator of the customer need."   creator: User
-  "The issue this customer need was originally created on. Will be undefined if the customer need hasn't been moved."   originalIssue: Issue
-  "The URL of the underlying attachment, if any"   url: String
+  "The body content of the need in Markdown format. Used to capture manual input about needs that cannot be directly tied to an attachment. Null if the need's content comes from an attached source."   body: String
+  "[Internal] The body content of the need as a Prosemirror document JSON string. This is the structured representation of the body field, used for rich text rendering in the editor."   bodyData: String
+  "The user who manually created this customer need. Null for needs created automatically by integrations or intake sources."   creator: User
+  "The issue this customer need was originally created on, before being moved to a different issue or project. Null if the customer need has not been moved from its original location."   originalIssue: Issue
+  "The URL of the source attachment linked to this need, if any. Returns the URL from either the issue attachment or project attachment. Null if the need has no attached source."   url: String
 }
 
 "A generic payload return from entity archive mutations." type CustomerNeedArchivePayload implements ArchivePayload {
@@ -4960,23 +5784,21 @@ type CustomerNeedEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"A customer need related notification." type CustomerNeedNotification implements Notification & Entity & Node {
+"A notification related to a customer need (request), such as creation, resolution, or being marked as important." type CustomerNeedNotification implements Notification & Entity & Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "Notification type."   type: String!
-  "The user that caused the notification."   actor: User
-  "The external user that caused the notification."   externalUserActor: ExternalUser
-  "The user that received the notification."   user: User!
-  "The time at when the user marked the notification as read. Null, if the the user hasn't read the notification"   readAt: DateTime
-  """The time at when an email reminder for this notification was sent to the user. Null, if no email
-    reminder has been sent."""
-  emailedAt: DateTime
-  "The time until a notification will be snoozed. After that it will appear in the inbox again."   snoozedUntilAt: DateTime
-  "The time at which a notification was unsnoozed.."   unsnoozedAt: DateTime
+  "Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated."   type: String!
+  "The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event."   actor: User
+  "The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member."   externalUserActor: ExternalUser
+  "The recipient user of this notification."   user: User!
+  "The time at which the user marked the notification as read. Null if the notification is unread."   readAt: DateTime
+  "The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent."   emailedAt: DateTime
+  "The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed."   snoozedUntilAt: DateTime
+  "The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed."   unsnoozedAt: DateTime
   "The category of the notification."   category: NotificationCategory!
   "[Internal] URL to the target of the notification."   url: String!
   "[Internal] Inbox URL for the notification."   inboxUrl: String!
@@ -4998,36 +5820,34 @@ type CustomerNeedEdge {
   "The customer need related to the notification."   customerNeed: CustomerNeed!
 }
 
-type CustomerNeedPayload {
+"Return type for customer need mutations." type CustomerNeedPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "The customer need that was created or updated."   need: CustomerNeed!
+  "The customer need entity that was created or updated by the mutation."   need: CustomerNeed!
   "Whether the operation was successful."   success: Boolean!
 }
 
-type CustomerNeedUpdatePayload {
+"Return type for customer need update mutations, including any related needs that were also updated." type CustomerNeedUpdatePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "The customer need that was created or updated."   need: CustomerNeed!
+  "The customer need entity that was created or updated by the mutation."   need: CustomerNeed!
   "Whether the operation was successful."   success: Boolean!
-  "The related customer needs that were updated."   updatedRelatedNeeds: [CustomerNeed!]!
+  "Additional customer needs from the same customer on the same issue/project that were updated when applyPriorityToRelatedNeeds was set."   updatedRelatedNeeds: [CustomerNeed!]!
 }
 
-"A customer related notification." type CustomerNotification implements Notification & Entity & Node {
+"A notification related to a customer, such as being added as the customer owner." type CustomerNotification implements Notification & Entity & Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "Notification type."   type: String!
-  "The user that caused the notification."   actor: User
-  "The external user that caused the notification."   externalUserActor: ExternalUser
-  "The user that received the notification."   user: User!
-  "The time at when the user marked the notification as read. Null, if the the user hasn't read the notification"   readAt: DateTime
-  """The time at when an email reminder for this notification was sent to the user. Null, if no email
-    reminder has been sent."""
-  emailedAt: DateTime
-  "The time until a notification will be snoozed. After that it will appear in the inbox again."   snoozedUntilAt: DateTime
-  "The time at which a notification was unsnoozed.."   unsnoozedAt: DateTime
+  "Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated."   type: String!
+  "The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event."   actor: User
+  "The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member."   externalUserActor: ExternalUser
+  "The recipient user of this notification."   user: User!
+  "The time at which the user marked the notification as read. Null if the notification is unread."   readAt: DateTime
+  "The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent."   emailedAt: DateTime
+  "The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed."   snoozedUntilAt: DateTime
+  "The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed."   unsnoozedAt: DateTime
   "The category of the notification."   category: NotificationCategory!
   "[Internal] URL to the target of the notification."   url: String!
   "[Internal] Inbox URL for the notification."   inboxUrl: String!
@@ -5047,47 +5867,47 @@ type CustomerNeedUpdatePayload {
   "The customer related to the notification."   customer: Customer!
 }
 
-"A customer notification subscription." type CustomerNotificationSubscription implements NotificationSubscription & Entity & Node {
+"A notification subscription scoped to a specific customer. The subscriber receives notifications for events related to this customer, such as new customer needs or ownership changes." type CustomerNotificationSubscription implements NotificationSubscription & Entity & Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The user that subscribed to receive notifications."   subscriber: User!
+  "The user who will receive notifications from this subscription."   subscriber: User!
   "The customer subscribed to."   customer: Customer!
-  "The contextual custom view associated with the notification subscription."   customView: CustomView
-  "The contextual cycle view associated with the notification subscription."   cycle: Cycle
-  "The contextual label view associated with the notification subscription."   label: IssueLabel
-  "The contextual project view associated with the notification subscription."   project: Project
-  "The contextual initiative view associated with the notification subscription."   initiative: Initiative
-  "The team associated with the notification subscription."   team: Team
-  "The user view associated with the notification subscription."   user: User
-  "The type of view to which the notification subscription context is associated with."   contextViewType: ContextViewType
-  "The type of user view to which the notification subscription context is associated with."   userContextViewType: UserContextViewType
-  "Whether the subscription is active or not."   active: Boolean!
-  "The type of subscription."   notificationSubscriptionTypes: [String!]!
-}
-
-type CustomerPayload {
+  "The custom view that this notification subscription is scoped to. Null if the subscription targets a different entity type."   customView: CustomView
+  "The cycle that this notification subscription is scoped to. Null if the subscription targets a different entity type."   cycle: Cycle
+  "The issue label that this notification subscription is scoped to. Null if the subscription targets a different entity type."   label: IssueLabel
+  "The project that this notification subscription is scoped to. Null if the subscription targets a different entity type."   project: Project
+  "The initiative that this notification subscription is scoped to. Null if the subscription targets a different entity type."   initiative: Initiative
+  "The team that this notification subscription is scoped to. Null if the subscription targets a different entity type."   team: Team
+  "The user that this notification subscription is scoped to, for user-specific view subscriptions. Null if the subscription targets a different entity type."   user: User
+  "The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type."   contextViewType: ContextViewType
+  "The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type."   userContextViewType: UserContextViewType
+  "Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists."   active: Boolean!
+  "The notification event types that this subscription will deliver to the subscriber."   notificationSubscriptionTypes: [String!]!
+}
+
+"Return type for customer mutations." type CustomerPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "The customer that was created or updated."   customer: Customer!
+  "The customer entity that was created or updated by the mutation."   customer: Customer!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"A customer status." type CustomerStatus implements Node {
+"A workspace-defined lifecycle status for customers (e.g., Active, Churned, Trial). Customer statuses are ordered by position and displayed with a color in the UI. Every workspace has at least one status, and a default status is assigned to new customers when none is specified." type CustomerStatus implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The name of the status."   name: String!
-  "The UI color of the status as a HEX string."   color: String!
-  "Description of the status."   description: String
-  "The position of the status in the workspace's customers flow."   position: Float!
-  "The display name of the status."   displayName: String!
-  "The type of the customer status."   type: CustomerStatusType @deprecated(reason: "Customer statuses are no longer grouped by type.")
+  "The internal name of the status. Used as the default display name if no displayName is explicitly set."   name: String!
+  "The color of the status indicator in the UI, as a HEX string (e.g., '#ff0000')."   color: String!
+  "An optional description explaining what this status represents in the customer lifecycle."   description: String
+  "The sort position of the status in the workspace's customer lifecycle flow. Lower values appear first. Collisions are automatically resolved by redistributing positions."   position: Float!
+  "The user-facing display name of the status shown in the UI. Defaults to the internal name if not explicitly set."   displayName: String!
+  "[Deprecated] The type of the customer status. Always returns null as statuses are no longer grouped by type."   type: CustomerStatusType @deprecated(reason: "Customer statuses are no longer grouped by type.")
 }
 
 type CustomerStatusConnection {
@@ -5101,24 +5921,24 @@ type CustomerStatusEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type CustomerStatusPayload {
+"Return type for customer status mutations." type CustomerStatusPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "The customer status that was created or updated."   status: CustomerStatus!
+  "The customer status entity that was created or updated by the mutation."   status: CustomerStatus!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"A customer tier." type CustomerTier implements Node {
+"A workspace-defined tier or segment for categorizing customers (e.g., Enterprise, Pro, Free). Customer tiers are used for prioritization and filtering, are ordered by position, and displayed with a color in the UI. Tier names are unique within a workspace." type CustomerTier implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The name of the tier."   name: String!
-  "The UI color of the tier as a HEX string."   color: String!
-  "Description of the tier."   description: String
-  "The position of the tier in the workspace's customers flow."   position: Float!
-  "The display name of the tier."   displayName: String!
+  "The internal name of the tier. Must be unique within the workspace. Used as the default display name if no displayName is explicitly set."   name: String!
+  "The color of the tier indicator in the UI, as a HEX string (e.g., '#ff0000')."   color: String!
+  "An optional description explaining what this tier represents and its intended use for customer segmentation."   description: String
+  "The sort position of the tier in the workspace's customer tier ordering. Lower values appear first. Collisions are automatically resolved by redistributing positions."   position: Float!
+  "The user-facing display name of the tier shown in the UI. Defaults to the internal name if not explicitly set."   displayName: String!
 }
 
 type CustomerTierConnection {
@@ -5132,43 +5952,43 @@ type CustomerTierEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type CustomerTierPayload {
+"Return type for customer tier mutations." type CustomerTierPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "The customer tier that was created or updated."   tier: CustomerTier!
+  "The customer tier entity that was created or updated by the mutation."   tier: CustomerTier!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"A set of issues to be resolved in a specified amount of time." type Cycle implements Node {
+"A time-boxed iteration (similar to a sprint) used for planning and tracking work. Cycles belong to a team and have defined start and end dates. Issues are assigned to cycles for time-based planning, and progress is tracked via completed, in-progress, and total scope. Cycles are automatically completed when their end date passes, and uncompleted issues can be carried over to the next cycle." type Cycle implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The number of the cycle."   number: Float!
-  "The custom name of the cycle."   name: String
-  "The cycle's description."   description: String
-  "The start time of the cycle."   startsAt: DateTime!
-  "The end time of the cycle."   endsAt: DateTime!
-  "The completion time of the cycle. If null, the cycle hasn't been completed."   completedAt: DateTime
-  "The time at which the cycle was automatically archived by the auto pruning process."   autoArchivedAt: DateTime
-  "The total number of issues in the cycle after each day."   issueCountHistory: [Float!]!
-  "The number of completed issues in the cycle after each day."   completedIssueCountHistory: [Float!]!
-  "The total number of estimation points after each day."   scopeHistory: [Float!]!
-  "The number of completed estimation points after each day."   completedScopeHistory: [Float!]!
-  "The number of in progress estimation points after each day."   inProgressScopeHistory: [Float!]!
-  "The team that the cycle is associated with."   team: Team!
-  "[Internal] The progress history of the cycle."   progressHistory: JSONObject!
-  "[Internal] The current progress of the cycle."   currentProgress: JSONObject!
-  "The cycle inherited from."   inheritedFrom: Cycle
-  "Whether the cycle is currently active."   isActive: Boolean!
-  "Whether the cycle is in the future."   isFuture: Boolean!
-  "Whether the cycle is in the past."   isPast: Boolean!
-  "Issues associated with the cycle."   issues(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
-  "Issues that weren't completed when the cycle was closed."   uncompletedIssuesUponClose(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
-  "The overall progress of the cycle. This is the (completed estimate points + 0.25 * in progress estimate points) / total estimate points."   progress: Float!
-  "Whether the cycle is the next cycle for the team."   isNext: Boolean!
-  "Whether the cycle is the previous cycle for the team."   isPrevious: Boolean!
+  "The auto-incrementing number of the cycle, unique within its team. This value is assigned automatically by the database and cannot be set on creation."   number: Float!
+  "The custom name of the cycle. If not set, the cycle is displayed using its number (e.g., \"Cycle 5\")."   name: String
+  "The description of the cycle."   description: String
+  "The start date and time of the cycle."   startsAt: DateTime!
+  "The end date and time of the cycle. When a cycle is completed prematurely, this is updated to match the completion time. When cycles are disabled, both endsAt and completedAt are set to the current time."   endsAt: DateTime!
+  "The completion time of the cycle. If null, the cycle has not been completed yet. A cycle is completed either when its end date passes or when it is manually completed early."   completedAt: DateTime
+  "The time at which the cycle was automatically archived by the auto-pruning process. Null if the cycle has not been auto-archived."   autoArchivedAt: DateTime
+  "The total number of issues in the cycle after each day. Each entry represents a snapshot at the end of that day, forming the basis for burndown charts."   issueCountHistory: [Float!]!
+  "The number of completed issues in the cycle after each day. Each entry corresponds to the same day index as issueCountHistory."   completedIssueCountHistory: [Float!]!
+  "The total number of estimation points (scope) in the cycle after each day. Used for scope-based burndown charts."   scopeHistory: [Float!]!
+  "The number of completed estimation points after each day. Used together with scopeHistory for burndown charts."   completedScopeHistory: [Float!]!
+  "The number of in-progress estimation points after each day. Tracks work that has been started but not yet completed."   inProgressScopeHistory: [Float!]!
+  "The team that the cycle belongs to. Each cycle is scoped to exactly one team."   team: Team!
+  "[Internal] The detailed progress history of the cycle, including per-status breakdowns over time."   progressHistory: JSONObject!
+  "[Internal] The current progress snapshot of the cycle, broken down by issue status categories."   currentProgress: JSONObject!
+  "The parent cycle this cycle was inherited from. When a parent team creates cycles, sub-teams automatically receive corresponding inherited cycles."   inheritedFrom: Cycle
+  "Whether the cycle is currently active. A cycle is active if the current time is between its start and end dates and it has not been completed."   isActive: Boolean!
+  "Whether the cycle has not yet started. True if the cycle's start date is in the future."   isFuture: Boolean!
+  "Whether the cycle's end date has passed."   isPast: Boolean!
+  "Issues that are currently assigned to this cycle."   issues(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
+  "Issues that were still open (not completed) when the cycle was closed. These issues may have been moved to the next cycle."   uncompletedIssuesUponClose(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
+  "The overall progress of the cycle as a number between 0 and 1. Calculated as (completed estimate points + 0.25 * in-progress estimate points) / total estimate points. Returns 0 if no estimate points exist."   progress: Float!
+  "Whether this cycle is the next upcoming (not yet started) cycle for the team."   isNext: Boolean!
+  "Whether this cycle is the most recently completed cycle for the team."   isPrevious: Boolean!
   "[Internal] Documents associated with the cycle."   documents(filter: DocumentFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): DocumentConnection!
   "[Internal] Links associated with the cycle."   links(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): EntityExternalLinkConnection!
 }
@@ -5190,56 +6010,55 @@ type CycleEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"A cycle notification subscription." type CycleNotificationSubscription implements NotificationSubscription & Entity & Node {
+"A notification subscription scoped to a specific cycle. The subscriber receives notifications for events related to issues in this cycle." type CycleNotificationSubscription implements NotificationSubscription & Entity & Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The user that subscribed to receive notifications."   subscriber: User!
-  "The customer associated with the notification subscription."   customer: Customer
-  "The contextual custom view associated with the notification subscription."   customView: CustomView
+  "The user who will receive notifications from this subscription."   subscriber: User!
+  "The customer that this notification subscription is scoped to. Null if the subscription targets a different entity type."   customer: Customer
+  "The custom view that this notification subscription is scoped to. Null if the subscription targets a different entity type."   customView: CustomView
   "The cycle subscribed to."   cycle: Cycle!
-  "The contextual label view associated with the notification subscription."   label: IssueLabel
-  "The contextual project view associated with the notification subscription."   project: Project
-  "The contextual initiative view associated with the notification subscription."   initiative: Initiative
-  "The team associated with the notification subscription."   team: Team
-  "The user view associated with the notification subscription."   user: User
-  "The type of view to which the notification subscription context is associated with."   contextViewType: ContextViewType
-  "The type of user view to which the notification subscription context is associated with."   userContextViewType: UserContextViewType
-  "Whether the subscription is active or not."   active: Boolean!
-  "The type of subscription."   notificationSubscriptionTypes: [String!]!
-}
-
-type CyclePayload {
+  "The issue label that this notification subscription is scoped to. Null if the subscription targets a different entity type."   label: IssueLabel
+  "The project that this notification subscription is scoped to. Null if the subscription targets a different entity type."   project: Project
+  "The initiative that this notification subscription is scoped to. Null if the subscription targets a different entity type."   initiative: Initiative
+  "The team that this notification subscription is scoped to. Null if the subscription targets a different entity type."   team: Team
+  "The user that this notification subscription is scoped to, for user-specific view subscriptions. Null if the subscription targets a different entity type."   user: User
+  "The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type."   contextViewType: ContextViewType
+  "The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type."   userContextViewType: UserContextViewType
+  "Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists."   active: Boolean!
+  "The notification event types that this subscription will deliver to the subscriber."   notificationSubscriptionTypes: [String!]!
+}
+
+"The payload returned by cycle mutations." type CyclePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "The Cycle that was created or updated."   cycle: Cycle
+  "The cycle that was created or updated."   cycle: Cycle
   "Whether the operation was successful."   success: Boolean!
 }
 
-"[Internal] A dashboard, usually a collection of widgets to display several insights at once." type Dashboard implements Node {
+"[Internal] A configurable dashboard composed of widgets that display analytics, metrics, and insights. Dashboards can be personal or shared with the workspace, and optionally scoped to one or more teams. Each dashboard contains a set of widget configurations that define what data is visualized." type Dashboard implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The dashboard's unique URL slug."   slugId: String!
+  "The dashboard's unique URL slug, used to construct human-readable URLs. Automatically generated on creation."   slugId: String!
   "The name of the dashboard."   name: String!
   "The description of the dashboard."   description: String
-  "The icon of the dashboard."   icon: String
-  "The color of the icon of the dashboard."   color: String
-  "The sort order of the dashboard within the organization or its team."   sortOrder: Float!
-  "Whether the dashboard is shared with everyone in the organization."   shared: Boolean!
-  "The organization of the dashboard."   organization: Organization!
-  "The user who created the dashboard."   creator: User
-  "The user who last updated the dashboard."   updatedBy: User
-  "The owner of the dashboard."   owner: User
-  "The filter applied to all dashboard widgets showing issues data."   issueFilter: JSONObject
-  "The filter applied to all dashboard widgets showing projects data."   projectFilter: JSONObject
-  "The widgets on the dashboard."   widgets: JSONObject!
-  "The team associated with the dashboard."   team: Team
+  "The icon of the dashboard. Can be an emoji or a decorative icon identifier."   icon: String
+  "The hex color code of the dashboard icon."   color: String
+  "The sort order of the dashboard within the workspace or its team. Lower values appear first."   sortOrder: Float!
+  "Whether the dashboard is shared with everyone in the workspace. Shared dashboards are visible to all members; unshared dashboards are only visible to the owner."   shared: Boolean!
+  "The organization that the dashboard belongs to."   organization: Organization!
+  "The user who created the dashboard. Null if the creator's account has been deleted."   creator: User
+  "The user who last updated the dashboard. Null if no user has updated it or the updater's account has been deleted."   updatedBy: User
+  "The owner of the dashboard. For personal dashboards, only the owner can view them. Null if the owner's account has been deleted."   owner: User
+  "A global issue filter applied to all dashboard widgets that display issue data. Individual widgets may apply additional filters on top of this."   issueFilter: JSONObject
+  "A global project filter applied to all dashboard widgets that display project data. Individual widgets may apply additional filters on top of this."   projectFilter: JSONObject
+  "The widget configuration for the dashboard, defining the layout grid of rows and the widgets within each row, including their type, size, and data settings."   widgets: JSONObject!
 }
 
 "A generic payload return from entity deletion mutations." type DeletePayload implements ArchivePayload {
@@ -5248,32 +6067,33 @@ type CyclePayload {
   "The identifier of the deleted entity."   entityId: String!
 }
 
-"A document that can be attached to different entities." type Document implements Node {
+"A rich-text document that lives within a project, initiative, team, issue, release, or cycle. Documents support collaborative editing via ProseMirror/Yjs and store their content in a separate DocumentContent entity. Each document is associated with exactly one parent entity." type Document implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The document title."   title: String!
-  "The icon of the document."   icon: String
-  "The color of the icon."   color: String
-  "The user who created the document."   creator: User
-  "The user who last updated the document."   updatedBy: User
-  "The project that the document is associated with."   project: Project
-  "The initiative that the document is associated with."   initiative: Initiative
-  "[Internal] The team that the document is associated with."   team: Team
-  "The issue that the document is associated with."   issue: Issue
-  "[Internal] The release that the document is associated with."   release: Release
-  "[Internal] The cycle that the document is associated with."   cycle: Cycle
-  "The document's unique URL slug."   slugId: String!
-  "The last template that was applied to this document."   lastAppliedTemplate: Template
-  "The time at which the document was hidden. Null if the entity has not been hidden."   hiddenAt: DateTime
-  "A flag that indicates whether the document is in the trash bin."   trashed: Boolean
-  "The order of the item in the resources list."   sortOrder: Float!
+  "The title of the document. An empty string indicates an untitled document."   title: String!
+  "[Internal] A one-sentence AI-generated summary of the document content. Null if no summary has been generated."   summary: String
+  "The icon of the document, either a decorative icon type or an emoji string. Null if no icon has been set."   icon: String
+  "The hex color of the document icon. Null if no custom color has been set."   color: String
+  "The user who created the document. Null if the creator's account has been deleted."   creator: User
+  "The user who last updated the document. Null if the user's account has been deleted."   updatedBy: User
+  "The project that the document is associated with. Null if the document belongs to a different parent entity type."   project: Project
+  "The initiative that the document is associated with. Null if the document belongs to a different parent entity type."   initiative: Initiative
+  "[Internal] The team that the document is associated with. Null if the document belongs to a different parent entity type."   team: Team
+  "The issue that the document is associated with. Null if the document belongs to a different parent entity type."   issue: Issue
+  "[Internal] The release that the document is associated with. Null if the document belongs to a different parent entity type."   release: Release
+  "[Internal] The cycle that the document is associated with. Null if the document belongs to a different parent entity type."   cycle: Cycle
+  "The document's unique URL slug, used to construct human-readable URLs."   slugId: String!
+  "The last template that was applied to this document. Null if no template has been applied."   lastAppliedTemplate: Template
+  "The time at which the document was hidden from the default view. Null if the document has not been hidden."   hiddenAt: DateTime
+  "A flag that indicates whether the document is in the trash bin. Trashed documents are archived and can be restored."   trashed: Boolean
+  "The sort order of the document in its parent entity's resources list. This order is shared with other resource types such as external links."   sortOrder: Float!
   "Comments associated with the document."   comments(filter: CommentFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CommentConnection!
-  "The documents content in markdown format."   content: String
-  "[Internal] The documents content as YJS state."   contentState: String
+  "The document's content in markdown format."   content: String
+  "[Internal] The document's content as a base64-encoded Yjs state update."   contentState: String
   "The ID of the document content associated with the document."   documentContentId: String
   "The canonical url for the document."   url: String!
 }
@@ -5290,50 +6110,38 @@ type DocumentConnection {
   pageInfo: PageInfo!
 }
 
-"A document content for a project." type DocumentContent implements Node {
+"The rich-text content body of a document, issue, project, initiative, project milestone, pull request, release note, AI prompt rules, or welcome message. Content is stored as a base64-encoded Yjs state and can be converted to Markdown or ProseMirror JSON. Each DocumentContent belongs to exactly one parent entity and supports real-time collaborative editing." type DocumentContent implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The document content in markdown format."   content: String
-  "The document content state as a base64 encoded string."   contentState: String
-  "The issue that the content is associated with."   issue: Issue
-  "[Internal] The pull request that the content is associated with."   pullRequest: PullRequest
-  "The project that the content is associated with."   project: Project
-  "The initiative that the content is associated with."   initiative: Initiative
-  "The project milestone that the content is associated with."   projectMilestone: ProjectMilestone
-  "The document that the content is associated with."   document: Document
-  "The AI prompt rules that the content is associated with."   aiPromptRules: AiPromptRules
-  "The welcome message that the content is associated with."   welcomeMessage: WelcomeMessage
-  "The time at which the document content was restored from a previous version."   restoredAt: DateTime
-  "Comments associated with the document content."   comments(filter: CommentFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CommentConnection!
-  "[ALPHA] The histories of the document content."   history(filter: DocumentContentHistoryFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): DocumentContentHistoryConnection!
-}
-
-"A document content history for a document." type DocumentContentHistory implements Node {
+  "The document content in markdown format. This is a derived representation of the canonical Yjs content state."   content: String
+  "The document content state as a base64-encoded Yjs state update. This is the canonical representation of the document content used for collaborative editing."   contentState: String
+  "The issue that the content is associated with. Null if the content belongs to a different parent entity type."   issue: Issue
+  "[Internal] The pull request that the content is associated with. Null if the content belongs to a different parent entity type."   pullRequest: PullRequest
+  "The project that the content is associated with. Null if the content belongs to a different parent entity type."   project: Project
+  "The initiative that the content is associated with. Null if the content belongs to a different parent entity type."   initiative: Initiative
+  "The project milestone that the content is associated with. Null if the content belongs to a different parent entity type."   projectMilestone: ProjectMilestone
+  "The document that the content is associated with. Null if the content belongs to a different parent entity type."   document: Document
+  "The AI prompt rules that the content is associated with. Null if the content belongs to a different parent entity type."   aiPromptRules: AiPromptRules
+  "The welcome message that the content is associated with. Null if the content belongs to a different parent entity type."   welcomeMessage: WelcomeMessage
+  "The time at which the document content was restored from a previous version in the content history. Null if the content has never been restored."   restoredAt: DateTime
+}
+
+"A draft revision of document content, pending user review. Each user can have at most one draft per document content. Drafts are seeded from the live document state and stored as base64-encoded Yjs state updates, allowing independent editing without affecting the published document until the user explicitly applies their changes." type DocumentContentDraft implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The document content that this history item is associated with."   documentContent: DocumentContent!
-  "[Internal] The document content as a Prosemirror document."   contentData: JSONObject
-  "IDs of actors whose edits went into this history item."   actorIds: [String!]!
-  "The timestamp associated with the DocumentContent when it was originally saved."   contentDataSnapshotAt: DateTime!
-}
-
-type DocumentContentHistoryConnection {
-  edges: [DocumentContentHistoryEdge!]!
-  nodes: [DocumentContentHistory!]!
-  pageInfo: PageInfo!
-}
-
-type DocumentContentHistoryEdge {
-  node: DocumentContentHistory!
-  "Used in `before` and `after` args"   cursor: String!
+  "The document content that this draft is a revision of."   documentContent: DocumentContent!
+  "The identifier of the document content that this draft is a revision of."   documentContentId: String!
+  "The draft content state as a base64-encoded Yjs state update. This represents the user's in-progress edits that have not yet been applied to the live document."   contentState: String!
+  "The user who created or owns this draft."   user: User!
+  "The identifier of the user who owns this draft."   userId: String!
 }
 
 type DocumentContentHistoryPayload {
@@ -5342,11 +6150,12 @@ type DocumentContentHistoryPayload {
 }
 
 type DocumentContentHistoryType {
-  "The UUID of the document content history entry."   id: String!
-  "The date when the document content history entry was created."   createdAt: DateTime!
-  "The date when the document content history snapshot was taken. This can be different than createdAt since the content is captured from its state at the previously known updatedAt timestamp in the case of an update. On document create, these timestamps can be the same."   contentDataSnapshotAt: DateTime!
-  "[Internal] The document content as Prosemirror document."   contentData: JSON
-  "The ID of the author of the change."   actorIds: [String!]
+  "The unique identifier of the document content history entry."   id: String!
+  "The date when this document content history entry record was created."   createdAt: DateTime!
+  "The timestamp of the document content state when this snapshot was captured. This can differ from createdAt because the content is captured from its state at the previously known updatedAt timestamp in the case of an update. On document creation, these timestamps can be identical."   contentDataSnapshotAt: DateTime!
+  "[Internal] The document content as a ProseMirror document at the time this history entry was captured."   contentData: JSON
+  "IDs of users whose edits are included in this history entry."   actorIds: [String!]
+  "Metadata associated with the history entry, including content diffs and AI-generated change summaries."   metadata: JSON
 }
 
 type DocumentEdge {
@@ -5354,7 +6163,7 @@ type DocumentEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"A document related notification." type DocumentNotification implements Notification & Entity & Node {
+"A notification related to a document, such as comments, mentions, content changes, or document lifecycle events." type DocumentNotification implements Notification & Entity & Node {
   "Related comment ID. Null if the notification is not related to a comment."   commentId: String
   "Related parent comment ID. Null if the notification is not related to a comment."   parentCommentId: String
   "Name of the reaction emoji related to the notification."   reactionEmoji: String
@@ -5364,16 +6173,14 @@ type DocumentEdge {
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "Notification type."   type: String!
-  "The user that caused the notification."   actor: User
-  "The external user that caused the notification."   externalUserActor: ExternalUser
-  "The user that received the notification."   user: User!
-  "The time at when the user marked the notification as read. Null, if the the user hasn't read the notification"   readAt: DateTime
-  """The time at when an email reminder for this notification was sent to the user. Null, if no email
-    reminder has been sent."""
-  emailedAt: DateTime
-  "The time until a notification will be snoozed. After that it will appear in the inbox again."   snoozedUntilAt: DateTime
-  "The time at which a notification was unsnoozed.."   unsnoozedAt: DateTime
+  "Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated."   type: String!
+  "The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event."   actor: User
+  "The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member."   externalUserActor: ExternalUser
+  "The recipient user of this notification."   user: User!
+  "The time at which the user marked the notification as read. Null if the notification is unread."   readAt: DateTime
+  "The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent."   emailedAt: DateTime
+  "The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed."   snoozedUntilAt: DateTime
+  "The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed."   unsnoozedAt: DateTime
   "The category of the notification."   category: NotificationCategory!
   "[Internal] URL to the target of the notification."   url: String!
   "[Internal] Inbox URL for the notification."   inboxUrl: String!
@@ -5392,7 +6199,7 @@ type DocumentEdge {
   "Related document ID."   documentId: String!
 }
 
-type DocumentPayload {
+"The result of a document mutation." type DocumentPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The document that was created or updated."   document: Document!
   "Whether the operation was successful."   success: Boolean!
@@ -5402,8 +6209,8 @@ type DocumentSearchPayload {
   edges: [DocumentSearchResultEdge!]!
   nodes: [DocumentSearchResult!]!
   pageInfo: PageInfo!
-  "Archived entities matching the search term along with all their dependencies."   archivePayload: ArchiveResponse!
-  "Total number of results for query without filters applied."   totalCount: Float!
+  "Archived entities matching the search term along with all their dependencies, serialized for the client sync engine."   archivePayload: ArchiveResponse!
+  "Total number of matching results before pagination is applied."   totalCount: Float!
 }
 
 type DocumentSearchResult implements Node {
@@ -5413,25 +6220,26 @@ type DocumentSearchResult implements Node {
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The document title."   title: String!
-  "The icon of the document."   icon: String
-  "The color of the icon."   color: String
-  "The user who created the document."   creator: User
-  "The user who last updated the document."   updatedBy: User
-  "The project that the document is associated with."   project: Project
-  "The initiative that the document is associated with."   initiative: Initiative
-  "[Internal] The team that the document is associated with."   team: Team
-  "The issue that the document is associated with."   issue: Issue
-  "[Internal] The release that the document is associated with."   release: Release
-  "[Internal] The cycle that the document is associated with."   cycle: Cycle
-  "The document's unique URL slug."   slugId: String!
-  "The last template that was applied to this document."   lastAppliedTemplate: Template
-  "The time at which the document was hidden. Null if the entity has not been hidden."   hiddenAt: DateTime
-  "A flag that indicates whether the document is in the trash bin."   trashed: Boolean
-  "The order of the item in the resources list."   sortOrder: Float!
+  "The title of the document. An empty string indicates an untitled document."   title: String!
+  "[Internal] A one-sentence AI-generated summary of the document content. Null if no summary has been generated."   summary: String
+  "The icon of the document, either a decorative icon type or an emoji string. Null if no icon has been set."   icon: String
+  "The hex color of the document icon. Null if no custom color has been set."   color: String
+  "The user who created the document. Null if the creator's account has been deleted."   creator: User
+  "The user who last updated the document. Null if the user's account has been deleted."   updatedBy: User
+  "The project that the document is associated with. Null if the document belongs to a different parent entity type."   project: Project
+  "The initiative that the document is associated with. Null if the document belongs to a different parent entity type."   initiative: Initiative
+  "[Internal] The team that the document is associated with. Null if the document belongs to a different parent entity type."   team: Team
+  "The issue that the document is associated with. Null if the document belongs to a different parent entity type."   issue: Issue
+  "[Internal] The release that the document is associated with. Null if the document belongs to a different parent entity type."   release: Release
+  "[Internal] The cycle that the document is associated with. Null if the document belongs to a different parent entity type."   cycle: Cycle
+  "The document's unique URL slug, used to construct human-readable URLs."   slugId: String!
+  "The last template that was applied to this document. Null if no template has been applied."   lastAppliedTemplate: Template
+  "The time at which the document was hidden from the default view. Null if the document has not been hidden."   hiddenAt: DateTime
+  "A flag that indicates whether the document is in the trash bin. Trashed documents are archived and can be restored."   trashed: Boolean
+  "The sort order of the document in its parent entity's resources list. This order is shared with other resource types such as external links."   sortOrder: Float!
   "Comments associated with the document."   comments(filter: CommentFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CommentConnection!
-  "The documents content in markdown format."   content: String
-  "[Internal] The documents content as YJS state."   contentState: String
+  "The document's content in markdown format."   content: String
+  "[Internal] The document's content as a base64-encoded Yjs state update."   contentState: String
   "The ID of the document content associated with the document."   documentContentId: String
   "The canonical url for the document."   url: String!
   "Metadata related to search result."   metadata: JSONObject!
@@ -5442,28 +6250,28 @@ type DocumentSearchResultEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"A general purpose draft. Used for comments, project updates, etc." type Draft implements Node {
+"A general-purpose draft for unsaved content. Drafts store in-progress text for comments, project updates, initiative updates, posts, pull request comments, and customer needs. Each draft belongs to a user and is associated with exactly one parent entity. Drafts are automatically deleted when the user publishes the corresponding comment or update." type Draft implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The text content as a Prosemirror document."   bodyData: JSON!
-  "Additional properties for the draft."   data: JSONObject
+  "The draft text content as a ProseMirror document."   bodyData: JSON!
+  "Additional properties for the draft, such as generation metadata for AI-generated drafts, health status for project updates, or post titles."   data: JSONObject
   "Whether the draft was autogenerated for the user."   isAutogenerated: Boolean! @deprecated(reason: "Use 'data.generationMetadata' instead")
   "[INTERNAL] Whether the draft was ported from a local draft."   wasLocalDraft: Boolean!
   "The user who created the draft."   user: User!
-  "The issue for which this is a draft comment."   issue: Issue
-  "The project for which this is a draft project update."   project: Project
-  "The project update for which this is a draft comment."   projectUpdate: ProjectUpdate
-  "The initiative for which this is a draft initiative update."   initiative: Initiative
-  "The initiative update for which this is a draft comment."   initiativeUpdate: InitiativeUpdate
-  "The post for which this is a draft comment."   post: Post
-  "The comment for which this is a draft comment reply."   parentComment: Comment
-  "The customer need that this draft is referencing."   customerNeed: CustomerNeed
+  "The issue for which this is a draft comment. Null if the draft belongs to a different parent entity type."   issue: Issue
+  "The project for which this is a draft comment or project update. Null if the draft belongs to a different parent entity type."   project: Project
+  "The project update for which this is a draft comment. Null if the draft belongs to a different parent entity type."   projectUpdate: ProjectUpdate
+  "The initiative for which this is a draft comment or initiative update. Null if the draft belongs to a different parent entity type."   initiative: Initiative
+  "The initiative update for which this is a draft comment. Null if the draft belongs to a different parent entity type."   initiativeUpdate: InitiativeUpdate
+  "The post for which this is a draft comment. Null if the draft belongs to a different parent entity type."   post: Post
+  "The parent comment for which this is a draft reply. Null if the draft is a top-level comment or belongs to a different parent entity type."   parentComment: Comment
+  "The customer need that this draft is referencing. Null if the draft belongs to a different parent entity type."   customerNeed: CustomerNeed
   "[INTERNAL] Allows for multiple drafts per entity (currently constrained to Pull Requests)."   anchor: String
-  "The team for which this is a draft post."   team: Team
+  "The team for which this is a draft post. Null if the draft belongs to a different parent entity type."   team: Team
 }
 
 type DraftConnection {
@@ -5477,14 +6285,14 @@ type DraftEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"An email address that can be used for submitting issues." type EmailIntakeAddress implements Node {
+"An email address that creates Linear issues when emails are sent to it. Email intake addresses can be scoped to a specific team or issue template, and support configurable auto-reply messages for issue creation, completion, and cancellation events. They can also be configured for the Asks web form feature, enabling external users to submit requests via email." type EmailIntakeAddress implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "Unique email address user name (before @) used for incoming email."   address: String!
+  "The unique local part (before the @) of the intake email address, used to route incoming emails to the correct intake handler."   address: String!
   "The type of the email address."   type: EmailIntakeAddressType!
   "The email address used to forward emails to the intake address."   forwardingEmailAddress: String
   "The name to be used for outgoing emails."   senderName: String
@@ -5493,25 +6301,26 @@ type DraftEdge {
   "Whether the commenter's name is included in the email replies."   useUserNamesInReplies: Boolean!
   "The template that the email address is associated with."   template: Template
   "The team that the email address is associated with."   team: Team
-  "The organization that the email address is associated with."   organization: Organization!
+  "The workspace that the email address is associated with."   organization: Organization!
   "The SES domain identity that the email address is associated with."   sesDomainIdentity: SesDomainIdentity
   "The user who created the email intake address."   creator: User
-  "Whether issues created from that email address will be turned into customer requests."   customerRequestsEnabled: Boolean!
+  "Whether issues created from emails sent to this address are automatically converted into customer requests, linking the sender as a customer contact."   customerRequestsEnabled: Boolean!
   "The auto-reply message for issue created. If not set, the default reply will be used."   issueCreatedAutoReply: String
   "Whether the auto-reply for issue created is enabled."   issueCreatedAutoReplyEnabled: Boolean!
   "Whether the auto-reply for issue completed is enabled."   issueCompletedAutoReplyEnabled: Boolean!
   "The auto-reply message for issue completed. If not set, the default reply will be used."   issueCompletedAutoReply: String
   "Whether the auto-reply for issue canceled is enabled."   issueCanceledAutoReplyEnabled: Boolean!
   "The auto-reply message for issue canceled. If not set, the default reply will be used."   issueCanceledAutoReply: String
+  "Whether to reopen completed or canceled issues when a substantive email reply is received."   reopenOnReply: Boolean!
 }
 
-type EmailIntakeAddressPayload {
+"The result of an email intake address mutation." type EmailIntakeAddressPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The email address that was created or updated."   emailIntakeAddress: EmailIntakeAddress!
   "Whether the operation was successful."   success: Boolean!
 }
 
-type EmailUnsubscribePayload {
+"The result of an email unsubscribe mutation." type EmailUnsubscribePayload {
   "Whether the operation was successful."   success: Boolean!
 }
 
@@ -5520,18 +6329,18 @@ type EmailUserAccountAuthChallengeResponse {
   "Supported challenge for this user account. Can be either verificationCode or password."   authType: String!
 }
 
-"A custom emoji." type Emoji implements Node {
+"A custom emoji defined in the workspace. Custom emojis are uploaded by users and can be used in reactions and other places where standard emojis are supported. Each emoji has a unique name within the workspace." type Emoji implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The emoji's name."   name: String!
-  "The emoji image URL."   url: String!
-  "The source of the emoji."   source: String!
+  "The unique name of the custom emoji within the workspace."   name: String!
+  "The URL of the uploaded image for this custom emoji."   url: String!
+  "The source of the emoji, indicating how it was created (e.g., uploaded by a user or imported)."   source: String!
   "The user who created the emoji."   creator: User
-  "The organization that the emoji belongs to."   organization: Organization!
+  "The workspace that the emoji belongs to."   organization: Organization!
 }
 
 type EmojiConnection {
@@ -5545,13 +6354,13 @@ type EmojiEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type EmojiPayload {
+"The result of a custom emoji mutation." type EmojiPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The emoji that was created."   emoji: Emoji!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"An external link for an entity like initiative, etc..." type EntityExternalLink implements Node {
+"An external link attached to a Linear entity such as an initiative, project, team, release, or cycle. External links provide a way to reference related resources outside of Linear (e.g., documentation, design files, dashboards) directly from the entity's resources section. Each link has a URL, display label, and sort order within its parent entity." type EntityExternalLink implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -5560,7 +6369,7 @@ type EmojiPayload {
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The link's URL."   url: String!
   "The link's label."   label: String!
-  "The order of the item in the resources list."   sortOrder: Float!
+  "The sort order of this link within the parent entity's resources list. Links are sorted together with documents and other resources attached to the entity."   sortOrder: Float!
   "The user who created the link."   creator: User!
   "The initiative that the link is associated with."   initiative: Initiative
 }
@@ -5576,16 +6385,20 @@ type EntityExternalLinkEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type EntityExternalLinkPayload {
+"The result of an entity external link mutation." type EntityExternalLinkPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The link that was created or updated."   entityExternalLink: EntityExternalLink!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"Information about an external entity." type ExternalEntityInfo {
-  "The id of the external entity."   id: String!
-  "The name of the service this entity is synced with."   service: ExternalSyncService!
-  "Metadata about the external entity."   metadata: ExternalEntityInfoMetadata
+type EventTrackingPayload {
+  "Whether the operation was successful."   success: Boolean!
+}
+
+"Information about an entity in an external system that is linked to a Linear entity. Provides the external ID, the service it belongs to, and optional service-specific metadata." type ExternalEntityInfo {
+  "The unique identifier of the entity in the external system (e.g., the Jira issue ID, GitHub issue node ID, or Slack message timestamp)."   id: String!
+  "The external service that this entity belongs to (e.g., jira, github, slack)."   service: ExternalSyncService!
+  "Service-specific metadata about the external entity. The concrete type depends on the service (e.g., Jira issue key, GitHub repo and issue number, Slack channel info). Null for entity types that do not have additional metadata."   metadata: ExternalEntityInfoMetadata
 }
 
 "Metadata about the external GitHub entity." type ExternalEntityInfoGithubMetadata {
@@ -5607,7 +6420,7 @@ type EntityExternalLinkPayload {
   "The URL of the Slack message."   messageUrl: String
 }
 
-"An external authenticated (e.g., through Slack) user which doesn't have a Linear account, but can create and update entities in Linear from the external system that authenticated them." type ExternalUser implements Node {
+"An external user who interacts with Linear through an integrated external service (such as Slack, Jira, GitHub, GitLab, Salesforce, or Microsoft Teams) but does not have a Linear account. External users can create issues, post comments, and add reactions from their respective platforms. They are identified by service-specific user IDs and may optionally have an email address. External users are scoped to a single workspace." type ExternalUser implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -5615,11 +6428,11 @@ type EntityExternalLinkPayload {
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The external user's full name."   name: String!
-  "The external user's display name. Unique within each organization. Can match the display name of an actual user."   displayName: String!
+  "The external user's display name. Unique within each workspace. Can match the display name of an actual user."   displayName: String!
   "The external user's email address."   email: String
-  "An URL to the external user's avatar image."   avatarUrl: String
-  "Organization the external user belongs to."   organization: Organization!
-  "The last time the external user was seen interacting with Linear."   lastSeen: DateTime
+  "A URL to the external user's avatar image. Null if no avatar is available from the external service."   avatarUrl: String
+  "The workspace that the external user belongs to."   organization: Organization!
+  "The last time the external user was seen interacting with Linear through their external service. Defaults to the creation time and is updated on subsequent interactions."   lastSeen: DateTime
 }
 
 type ExternalUserConnection {
@@ -5633,21 +6446,21 @@ type ExternalUserEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"A facet. Facets are joins between entities. A facet can tie a custom view to a project, or a a project to a roadmap for example." type Facet implements Node {
+"A facet representing a join between entities. Facets connect a custom view to an owning entity such as a project, initiative, team page, workspace page, or user feed. They control the order of views within their parent via the sortOrder field. Exactly one source entity and one target entity must be set." type Facet implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The sort order of the facet."   sortOrder: Float!
-  "The owning organization."   sourceOrganization: Organization
-  "The owning team."   sourceTeam: Team
-  "The owning project."   sourceProject: Project
-  "The owning initiative."   sourceInitiative: Initiative
-  "The owning feed user."   sourceFeedUser: User
-  "The owning page."   sourcePage: FacetPageSource
-  "The targeted custom view."   targetCustomView: CustomView
+  "The sort order of the facet within its owning entity scope. Lower values appear first. Sort order is scoped by the source entity (e.g., all facets on a project are sorted independently from facets on an initiative)."   sortOrder: Float!
+  "The owning organization. Set for workspace-level facets that are not scoped to a specific team, project, or initiative."   sourceOrganization: Organization
+  "The owning team. Set when this facet represents a view on a team-level page."   sourceTeam: Team
+  "The owning project. Set when this facet represents a view tab on a project."   sourceProject: Project
+  "The owning initiative. Set when this facet represents a view tab on an initiative."   sourceInitiative: Initiative
+  "The user whose feed this facet belongs to. Set when this facet represents a view in a user's personal feed."   sourceFeedUser: User
+  "The fixed page type (e.g., projects, issues) that this facet is displayed on. Used together with sourceOrganizationId or sourceTeamId to place a view on a specific page at the workspace or team level."   sourcePage: FacetPageSource
+  "The custom view that this facet points to. Each facet targets exactly one custom view, establishing a one-to-one relationship."   targetCustomView: CustomView
 }
 
 type FacetConnection {
@@ -5661,21 +6474,21 @@ type FacetEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"User favorites presented in the sidebar." type Favorite implements Node {
+"A user's bookmarked item that appears in their sidebar for quick access. Favorites can reference various entity types including issues, projects, cycles, views, documents, initiatives, labels, users, customers, dashboards, and pull requests. Favorites can be organized into folders and ordered by the user. Each favorite is owned by a single user and links to exactly one target entity (or is a folder containing other favorites)." type Favorite implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The type of the favorite."   type: String!
-  "The parent folder of the favorite."   parent: Favorite
+  "The type of entity this favorite references, such as 'issue', 'project', 'cycle', 'customView', 'document', 'folder', etc. Determines which associated entity field is populated."   type: String!
+  "The parent folder of the favorite. Null if the favorite is at the top level of the sidebar. Only favorites of type 'folder' can be parents."   parent: Favorite
   "The name of the folder. Only applies to favorites of type folder."   folderName: String
   "The targeted tab of the project."   projectTab: ProjectTab
-  "The type of favorited predefined view."   predefinedViewType: String
+  "The type of favorited predefined view (e.g., 'allIssues', 'activeCycle', 'backlog', 'triage'). Only populated when the favorite type is 'predefinedView'."   predefinedViewType: String
   "The targeted tab of the initiative."   initiativeTab: InitiativeTab
-  "The owner of the favorite."   owner: User!
-  "The order of the item in the favorites list."   sortOrder: Float!
+  "The user who owns this favorite. Favorites are personal and only visible to their owner."   owner: User!
+  "The position of this item in the user's favorites list. Lower values appear first. Used to maintain user-defined ordering within the sidebar."   sortOrder: Float!
   "Children of the favorite. Only applies to favorites of type folder."   children(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): FavoriteConnection!
   "The favorited issue."   issue: Issue
   "The favorited project."   project: Project
@@ -5712,25 +6525,25 @@ type FavoriteEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type FavoritePayload {
+"Return type for favorite mutations." type FavoritePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "The object that was added as a favorite."   favorite: Favorite!
+  "The favorite that was created or updated."   favorite: Favorite!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"[Internal] An item in a users feed." type FeedItem implements Node {
+"[Internal] An item in a user's activity feed. Feed items represent project updates, initiative updates, or posts that appear in a user's personalized feed based on their team memberships and feed subscriptions. Each feed item references exactly one content entity. Feed items older than 6 months are automatically archived." type FeedItem implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The organization that will see this feed item."   organization: Organization!
-  "The user that will see this feed item."   user: User
-  "The team that will see this feed item."   team: Team
-  "The project update that is in the feed."   projectUpdate: ProjectUpdate
-  "The initiative update that is in the feed."   initiativeUpdate: InitiativeUpdate
-  "The post that is in the feed."   post: Post
+  "The organization this feed item belongs to."   organization: Organization!
+  "The specific user this feed item is targeted to. Null if the feed item is targeted to a team or organization rather than an individual user."   user: User
+  "The team this feed item is associated with. Null if the feed item is not team-scoped."   team: Team
+  "The project update referenced by this feed item. Null if the feed item references a different content type."   projectUpdate: ProjectUpdate
+  "The initiative update referenced by this feed item. Null if the feed item references a different content type."   initiativeUpdate: InitiativeUpdate
+  "The post referenced by this feed item. Null if the feed item references a different content type."   post: Post
 }
 
 type FeedItemConnection {
@@ -5744,10 +6557,10 @@ type FeedItemEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type FetchDataPayload {
-  "The fetched data based on the natural language query."   data: JSONObject
-  "The GraphQL query used to fetch the data."   query: String
-  "The filters used to fetch the data."   filters: JSONObject
+"The result of a data fetch query using natural language." type FetchDataPayload {
+  "The fetched data as a JSON object. The shape depends on the natural language query and the resolved GraphQL query. Null if the query returned no results."   data: JSONObject
+  "The GraphQL query that was generated from the natural language input and executed to produce the data. Useful for debugging or reusing the query directly."   query: String
+  "The filter variables that were generated and applied to the GraphQL query. Null if no filters were needed."   filters: JSONObject
   "Whether the fetch operation was successful."   success: Boolean!
 }
 
@@ -5755,23 +6568,23 @@ type FileUploadDeletePayload {
   "Whether the operation was successful."   success: Boolean!
 }
 
-type FrontAttachmentPayload {
+"The result of a Front attachment mutation." type FrontAttachmentPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The issue attachment that was created."   attachment: Attachment!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"A trigger that updates the issue status according to Git automations." type GitAutomationState implements Node {
+"A Git automation rule that automatically transitions issues to a specified workflow state when a Git event occurs (e.g., when a PR is opened, move the linked issue to 'In Review'). Each rule is scoped to a team and optionally to a specific target branch. When no target branch is specified, the rule acts as the default for all branches. Target-branch-specific rules override the defaults." type GitAutomationState implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The associated workflow state."   state: WorkflowState
-  "The team to which this automation state belongs."   team: Team!
-  "The target branch associated to this automation state."   targetBranch: GitAutomationTargetBranch
-  "The event that triggers the automation."   event: GitAutomationStates!
+  "The workflow state that linked issues will be transitioned to when the Git event fires. Null if this rule is configured to take no action, overriding any default rule for the same event."   state: WorkflowState
+  "The team that this automation rule belongs to. Issues must belong to this team for the automation to apply."   team: Team!
+  "The target branch that this automation rule applies to. When set, this rule only fires for pull requests targeting the specified branch pattern, overriding any default rule for the same event. Null if this is a default rule that applies to all branches."   targetBranch: GitAutomationTargetBranch
+  "The Git event that triggers this automation rule (e.g., branch created, PR opened for review, or PR merged)."   event: GitAutomationStates!
   "[DEPRECATED] The target branch, if null, the automation will be triggered on any branch."   branchPattern: String @deprecated(reason: "Use targetBranch instead.")
 }
 
@@ -5786,26 +6599,26 @@ type GitAutomationStateEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type GitAutomationStatePayload {
+"The result of a git automation state mutation." type GitAutomationStatePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The automation state that was created or updated."   gitAutomationState: GitAutomationState!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"A Git target branch for which there are automations (GitAutomationState)." type GitAutomationTargetBranch implements Node {
+"A target branch definition used by Git automation rules to scope automations to specific branches. The branch can be specified as an exact name (e.g., 'main') or as a regular expression pattern (e.g., 'release/.*'). Each target branch belongs to a team and can have multiple automation rules associated with it, which override the team's default automation rules when a PR targets a matching branch." type GitAutomationTargetBranch implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The team to which this Git target branch automation belongs."   team: Team!
-  "The target branch pattern."   branchPattern: String!
-  "Whether the branch pattern is a regular expression."   isRegex: Boolean!
-  "Automation states associated with the target branch."   automationStates(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): GitAutomationStateConnection!
+  "The team that this target branch definition belongs to. The branch pattern is unique within a team."   team: Team!
+  "The branch name or pattern to match against pull request target branches. Interpreted as a literal branch name unless isRegex is true, in which case it is treated as a regular expression."   branchPattern: String!
+  "Whether the branch pattern should be interpreted as a regular expression. When false, the pattern is matched as an exact branch name."   isRegex: Boolean!
+  "Git automation rules associated with this target branch. These rules override the team's default automation rules when a pull request targets a branch matching this pattern."   automationStates(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): GitAutomationStateConnection!
 }
 
-type GitAutomationTargetBranchPayload {
+"The result of a git automation target branch mutation." type GitAutomationTargetBranchPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The Git target branch automation that was created or updated."   targetBranch: GitAutomationTargetBranch!
   "Whether the operation was successful."   success: Boolean!
@@ -5850,7 +6663,7 @@ type GitLabTestConnectionPayload {
   "Response headers from GitLab for debugging (JSON stringified)."   errorResponseHeaders: String
 }
 
-"An identity provider." type IdentityProvider implements Node {
+"A SAML/SSO or web forms identity provider configuration for a workspace. Identity providers enable single sign-on authentication via SAML 2.0 and can optionally support SCIM for automated user provisioning and group-based role mapping. Each workspace can have a default general-purpose identity provider and additional web forms identity providers for Asks web authentication." type IdentityProvider implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -5859,7 +6672,7 @@ type GitLabTestConnectionPayload {
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "Whether the identity provider is the default identity provider migrated from organization level settings."   defaultMigrated: Boolean!
   "The type of identity provider."   type: IdentityProviderType!
-  "Whether SAML authentication is enabled for organization."   samlEnabled: Boolean!
+  "Whether SAML authentication is enabled for the workspace."   samlEnabled: Boolean!
   "Sign in endpoint URL for the identity provider."   ssoEndpoint: String
   "Binding method for authentication call. Can be either `post` (default) or `redirect`."   ssoBinding: String
   "The algorithm of the Signing Certificate. Can be one of `sha1`, `sha256` (default), or `sha512`."   ssoSignAlgo: String
@@ -5867,7 +6680,7 @@ type GitLabTestConnectionPayload {
   "The issuer's custom entity ID."   issuerEntityId: String
   "The service provider (Linear) custom entity ID. Defaults to https://auth.linear.app/sso"   spEntityId: String
   "The SAML priority used to pick default workspace in SAML SP initiated flow, when same domain is claimed for SAML by multiple workspaces. Lower priority value means higher preference."   priority: Float
-  "Whether SCIM provisioning is enabled for organization."   scimEnabled: Boolean!
+  "Whether SCIM provisioning is enabled for the workspace."   scimEnabled: Boolean!
   "[INTERNAL] SCIM owners group push settings."   ownersGroupPush: JSONObject
   "[INTERNAL] SCIM admins group push settings."   adminsGroupPush: JSONObject
   "[INTERNAL] SCIM guests group push settings."   guestsGroupPush: JSONObject
@@ -5880,7 +6693,7 @@ type ImageUploadFromUrlPayload {
   "Whether the operation was successful."   success: Boolean!
 }
 
-"An initiative to group projects." type Initiative implements Node {
+"An initiative is a high-level strategic grouping of projects toward a business goal. Initiatives can contain multiple projects, have their own status updates and health tracking, and can be organized hierarchically with parent-child relationships." type Initiative implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -5894,23 +6707,23 @@ type ImageUploadFromUrlPayload {
   "The hour at which to prompt for updates."   updateRemindersHour: Float
   "The name of the initiative."   name: String!
   "The description of the initiative."   description: String
-  "The organization of the initiative."   organization: Organization!
+  "The workspace of the initiative."   organization: Organization!
   "The user who created the initiative."   creator: User
-  "The user who owns the initiative."   owner: User
-  "The initiative's unique URL slug."   slugId: String!
-  "The sort order of the initiative within the organization."   sortOrder: Float!
+  "The user who owns the initiative. The owner is typically responsible for posting status updates and driving the initiative to completion. Null if no owner is assigned."   owner: User
+  "The initiative's unique URL slug, used to construct human-readable URLs."   slugId: String!
+  "The sort order of the initiative within the workspace."   sortOrder: Float!
   "The initiative's color."   color: String
-  "The icon of the initiative."   icon: String
+  "The icon of the initiative. Can be an emoji or a decorative icon type."   icon: String
   "A flag that indicates whether the initiative is in the trash bin."   trashed: Boolean
-  "[Internal] Facets associated with the initiative."   facets: [Facet!]!
-  "The estimated completion date of the initiative."   targetDate: TimelessDate
-  "The resolution of the initiative's estimated completion date."   targetDateResolution: DateResolutionType
-  "The status of the initiative. One of Planned, Active, Completed"   status: InitiativeStatus!
-  "The last initiative update posted for this initiative."   lastUpdate: InitiativeUpdate
-  "The health of the initiative."   health: InitiativeUpdateHealthType
-  "The time at which the initiative health was updated."   healthUpdatedAt: DateTime
-  "The time at which the initiative was moved into active status."   startedAt: DateTime
-  "The time at which the initiative was moved into completed status."   completedAt: DateTime
+  "[Internal] Facets associated with the initiative, used for filtering and categorization."   facets: [Facet!]!
+  "The estimated completion date of the initiative. Null if no target date is set."   targetDate: TimelessDate
+  "The resolution of the initiative's estimated completion date, indicating whether it refers to a specific day, week, month, quarter, or year."   targetDateResolution: DateResolutionType
+  "The lifecycle status of the initiative. One of Planned, Active, Completed."   status: InitiativeStatus!
+  "The most recent status update posted for this initiative. Null if no updates have been posted."   lastUpdate: InitiativeUpdate
+  "The overall health of the initiative, derived from the most recent initiative update. Possible values are onTrack, atRisk, or offTrack. Null if no health has been reported."   health: InitiativeUpdateHealthType
+  "The time at which the initiative health was last updated, typically when a new initiative update is posted. Null if health has never been set."   healthUpdatedAt: DateTime
+  "The time at which the initiative was moved into Active status. Null if the initiative has not been activated."   startedAt: DateTime
+  "The time at which the initiative was moved into Completed status. Null if the initiative has not been completed."   completedAt: DateTime
   "Initiative URL."   url: String!
   "Projects associated with the initiative."   projects(includeSubInitiatives: Boolean, filter: ProjectFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [ProjectSortInput!]): ProjectConnection!
   "Links associated with the initiative."   links(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): EntityExternalLinkConnection!
@@ -5942,7 +6755,7 @@ type InitiativeEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"A initiative history containing relevant change events." type InitiativeHistory implements Node {
+"A history record associated with an initiative. Tracks changes to initiative properties such as name, status, owner, target date, icon, color, and parent-child relationships over time." type InitiativeHistory implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -5950,7 +6763,7 @@ type InitiativeEdge {
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The events that happened while recording that history."   entries: JSONObject!
-  "The initiative that the history is associated with."   initiative: Initiative!
+  "The initiative that this history record belongs to."   initiative: Initiative!
 }
 
 type InitiativeHistoryConnection {
@@ -5964,7 +6777,7 @@ type InitiativeHistoryEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"An initiative related notification." type InitiativeNotification implements Notification & Entity & Node {
+"A notification related to an initiative, such as being added as owner, initiative updates, comments, or mentions." type InitiativeNotification implements Notification & Entity & Node {
   "Related comment ID. Null if the notification is not related to a comment."   commentId: String
   "Related parent comment ID. Null if the notification is not related to a comment."   parentCommentId: String
   "Name of the reaction emoji related to the notification."   reactionEmoji: String
@@ -5974,16 +6787,14 @@ type InitiativeHistoryEdge {
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "Notification type."   type: String!
-  "The user that caused the notification."   actor: User
-  "The external user that caused the notification."   externalUserActor: ExternalUser
-  "The user that received the notification."   user: User!
-  "The time at when the user marked the notification as read. Null, if the the user hasn't read the notification"   readAt: DateTime
-  """The time at when an email reminder for this notification was sent to the user. Null, if no email
-    reminder has been sent."""
-  emailedAt: DateTime
-  "The time until a notification will be snoozed. After that it will appear in the inbox again."   snoozedUntilAt: DateTime
-  "The time at which a notification was unsnoozed.."   unsnoozedAt: DateTime
+  "Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated."   type: String!
+  "The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event."   actor: User
+  "The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member."   externalUserActor: ExternalUser
+  "The recipient user of this notification."   user: User!
+  "The time at which the user marked the notification as read. Null if the notification is unread."   readAt: DateTime
+  "The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent."   emailedAt: DateTime
+  "The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed."   snoozedUntilAt: DateTime
+  "The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed."   unsnoozedAt: DateTime
   "The category of the notification."   category: NotificationCategory!
   "[Internal] URL to the target of the notification."   url: String!
   "[Internal] Inbox URL for the notification."   inboxUrl: String!
@@ -6008,26 +6819,26 @@ type InitiativeHistoryEdge {
   "The parent comment related to the notification, if a notification is a reply comment notification."   parentComment: Comment
 }
 
-"An initiative notification subscription." type InitiativeNotificationSubscription implements NotificationSubscription & Entity & Node {
+"A notification subscription scoped to a specific initiative. The subscriber receives notifications for events related to this initiative, such as updates, comments, and ownership changes." type InitiativeNotificationSubscription implements NotificationSubscription & Entity & Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The user that subscribed to receive notifications."   subscriber: User!
-  "The customer associated with the notification subscription."   customer: Customer
-  "The contextual custom view associated with the notification subscription."   customView: CustomView
-  "The contextual cycle view associated with the notification subscription."   cycle: Cycle
-  "The contextual label view associated with the notification subscription."   label: IssueLabel
-  "The contextual project view associated with the notification subscription."   project: Project
+  "The user who will receive notifications from this subscription."   subscriber: User!
+  "The customer that this notification subscription is scoped to. Null if the subscription targets a different entity type."   customer: Customer
+  "The custom view that this notification subscription is scoped to. Null if the subscription targets a different entity type."   customView: CustomView
+  "The cycle that this notification subscription is scoped to. Null if the subscription targets a different entity type."   cycle: Cycle
+  "The issue label that this notification subscription is scoped to. Null if the subscription targets a different entity type."   label: IssueLabel
+  "The project that this notification subscription is scoped to. Null if the subscription targets a different entity type."   project: Project
   "The initiative subscribed to."   initiative: Initiative!
-  "The team associated with the notification subscription."   team: Team
-  "The user view associated with the notification subscription."   user: User
-  "The type of view to which the notification subscription context is associated with."   contextViewType: ContextViewType
-  "The type of user view to which the notification subscription context is associated with."   userContextViewType: UserContextViewType
-  "Whether the subscription is active or not."   active: Boolean!
-  "The type of subscription."   notificationSubscriptionTypes: [String!]!
+  "The team that this notification subscription is scoped to. Null if the subscription targets a different entity type."   team: Team
+  "The user that this notification subscription is scoped to, for user-specific view subscriptions. Null if the subscription targets a different entity type."   user: User
+  "The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type."   contextViewType: ContextViewType
+  "The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type."   userContextViewType: UserContextViewType
+  "Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists."   active: Boolean!
+  "The notification event types that this subscription will deliver to the subscriber."   notificationSubscriptionTypes: [String!]!
 }
 
 "The payload returned by the initiative mutations." type InitiativePayload {
@@ -6036,17 +6847,17 @@ type InitiativeHistoryEdge {
   "Whether the operation was successful."   success: Boolean!
 }
 
-"A relation representing the dependency between two initiatives." type InitiativeRelation implements Node {
+"A parent-child relation between two initiatives, forming a hierarchy. The initiative field is the parent and relatedInitiative is the child. Cycles and excessive nesting depth are prevented." type InitiativeRelation implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The parent initiative."   initiative: Initiative!
-  "The child initiative."   relatedInitiative: Initiative!
-  "The last user who created or modified the relation."   user: User
-  "The sort order of the relation within the initiative."   sortOrder: Float!
+  "The parent initiative in this hierarchical relation."   initiative: Initiative!
+  "The child initiative in this hierarchical relation."   relatedInitiative: Initiative!
+  "The user who last created or modified the relation. Null if the user has been deleted."   user: User
+  "The sort order of the child initiative within its parent initiative."   sortOrder: Float!
 }
 
 type InitiativeRelationConnection {
@@ -6060,13 +6871,13 @@ type InitiativeRelationEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type InitiativeRelationPayload {
+"The result of an initiative relation mutation." type InitiativeRelationPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The initiative relation that was created or updated."   initiativeRelation: InitiativeRelation!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"Join table between projects and initiatives." type InitiativeToProject implements Node {
+"The join entity linking a project to an initiative. A project can only appear once in an initiative hierarchy -- it cannot be on both an initiative and one of its ancestor or descendant initiatives." type InitiativeToProject implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -6075,7 +6886,7 @@ type InitiativeRelationPayload {
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The project that the initiative is associated with."   project: Project!
   "The initiative that the project is associated with."   initiative: Initiative!
-  "The sort order of the project within the initiative."   sortOrder: String!
+  "The sort order of the project within its parent initiative."   sortOrder: String!
 }
 
 type InitiativeToProjectConnection {
@@ -6089,13 +6900,13 @@ type InitiativeToProjectEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"The result of a initiativeToProject mutation." type InitiativeToProjectPayload {
+"The result of an initiative-to-project mutation." type InitiativeToProjectPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "The initiativeToProject that was created or updated."   initiativeToProject: InitiativeToProject!
+  "The initiative-to-project association that was created or updated."   initiativeToProject: InitiativeToProject!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"An initiative update." type InitiativeUpdate implements Node {
+"A status update posted to an initiative. Initiative updates communicate progress, health, and blockers to stakeholders. Each update captures the initiative's health at the time of writing and includes a rich-text body with the update content." type InitiativeUpdate implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -6107,11 +6918,11 @@ type InitiativeToProjectEdge {
   "Emoji reaction summary, grouped by emoji type."   reactionData: JSONObject!
   "[Internal] The content of the update as a Prosemirror document."   bodyData: String!
   "The update's unique URL slug."   slugId: String!
-  "The initiative that the update is associated with."   initiative: Initiative!
+  "The initiative that this status update was posted to."   initiative: Initiative!
   "The user who wrote the update."   user: User!
-  "The health at the time of the update."   health: InitiativeUpdateHealthType!
-  "[Internal] Serialized JSON representing current state of the initiative properties when posting the initiative update."   infoSnapshot: JSONObject
-  "Whether initiative update diff should be hidden."   isDiffHidden: Boolean!
+  "The health of the initiative at the time this update was posted. Possible values are onTrack, atRisk, or offTrack."   health: InitiativeUpdateHealthType!
+  "[Internal] A snapshot of initiative properties at the time the update was posted, including project statuses, sub-initiative health, and target dates. Used to compute diffs between consecutive updates."   infoSnapshot: JSONObject
+  "Whether the diff between this update and the previous one should be hidden in the UI."   isDiffHidden: Boolean!
   "The URL to the initiative update."   url: String!
   "Whether the initiative update is stale."   isStale: Boolean!
   "The diff between the current update and the previous one."   diff: JSONObject
@@ -6138,26 +6949,26 @@ type InitiativeUpdateEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type InitiativeUpdatePayload {
+"The result of an initiative update mutation." type InitiativeUpdatePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "The initiative update that was created."   initiativeUpdate: InitiativeUpdate!
+  "The initiative update that was created or updated."   initiativeUpdate: InitiativeUpdate!
   "Whether the operation was successful."   success: Boolean!
 }
 
-type InitiativeUpdateReminderPayload {
+"The result of an initiative update reminder mutation." type InitiativeUpdateReminderPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"An integration with an external service." type Integration implements Node {
+"An integration with an external service. Integrations connect Linear to tools like Slack, GitHub, GitLab, Jira, Figma, Sentry, Zendesk, Intercom, Front, PagerDuty, Opsgenie, Google Sheets, Microsoft Teams, Discord, Salesforce, and others. Each integration record represents a single configured connection, scoped to a workspace and optionally to a specific team, project, initiative, or custom view. Personal integrations (e.g., Slack Personal, Jira Personal, GitHub Personal) are scoped to the user who created them." type Integration implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The integration's type."   service: String!
-  "The organization that the integration is associated with."   organization: Organization!
+  "The integration's type, identifying which external service this integration connects to (e.g., 'slack', 'github', 'jira', 'figma'). This determines the shape of the integration's settings and data."   service: String!
+  "The workspace that the integration is associated with."   organization: Organization!
   "The team that the integration is associated with."   team: Team
   "The user that added the integration."   creator: User!
 }
@@ -6184,7 +6995,7 @@ type IntegrationPayload {
   "Whether the operation was successful."   success: Boolean!
 }
 
-type IntegrationRequestPayload {
+"The result of an integration request mutation." type IntegrationRequestPayload {
   "Whether the operation was successful."   success: Boolean!
 }
 
@@ -6193,7 +7004,7 @@ type IntegrationSlackWorkspaceNamePayload {
   "Whether the operation was successful."   success: Boolean!
 }
 
-"Join table between templates and integrations." type IntegrationTemplate implements Node {
+"A connection between a template and an integration. This join entity links Linear issue templates to integrations so that external systems (e.g., Slack Asks channels) can use specific templates when creating issues. Each record optionally includes a foreign entity ID to scope the template to a specific external resource, such as a particular Slack channel." type IntegrationTemplate implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -6202,7 +7013,7 @@ type IntegrationSlackWorkspaceNamePayload {
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The template that the integration is associated with."   template: Template!
   "The integration that the template is associated with."   integration: Integration!
-  "ID of the foreign entity in the external integration this template is for, e.g., Slack channel ID."   foreignEntityId: String
+  "The identifier of the foreign entity in the external service that this template is scoped to. For example, a Slack channel ID indicating which channel should use this template for creating issues. When null, the template applies to the integration as a whole rather than a specific external resource."   foreignEntityId: String
 }
 
 type IntegrationTemplateConnection {
@@ -6216,13 +7027,13 @@ type IntegrationTemplateEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type IntegrationTemplatePayload {
+"The result of an integration template mutation." type IntegrationTemplatePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The IntegrationTemplate that was created or updated."   integrationTemplate: IntegrationTemplate!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"The configuration of all integrations for different entities." type IntegrationsSettings implements Node {
+"The configuration of all integrations for different entities. Controls Slack notification preferences for a specific team, project, initiative, or custom view. Exactly one of teamId, projectId, customViewId, or initiativeId must be set, determining which entity these integration settings apply to." type IntegrationsSettings implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -6236,9 +7047,10 @@ type IntegrationTemplatePayload {
   "Whether to send a Slack message when an issue is added to the custom view."   slackIssueAddedToView: Boolean
   "Whether to send a Slack message when any of the project or team's issues has a change in status."   slackIssueStatusChangedAll: Boolean
   "Whether to send a Slack message when a project update is created."   slackProjectUpdateCreated: Boolean
+  "Whether to send a Microsoft Teams message when a project update is created."   microsoftTeamsProjectUpdateCreated: Boolean
   "Whether to send a new project update to team Slack channels."   slackProjectUpdateCreatedToTeam: Boolean
   "Whether to send a new project update to workspace Slack channel."   slackProjectUpdateCreatedToWorkspace: Boolean
-  "Whether to send a Slack message when a initiate update is created."   slackInitiativeUpdateCreated: Boolean
+  "Whether to send a Slack message when an initiative update is created."   slackInitiativeUpdateCreated: Boolean
   "Whether to send a Slack message when a new issue is added to triage."   slackIssueAddedToTriage: Boolean
   "Whether to send a Slack message when an SLA is at high risk."   slackIssueSlaHighRisk: Boolean
   "Whether to send a Slack message when an SLA is breached."   slackIssueSlaBreached: Boolean
@@ -6253,20 +7065,20 @@ type IntegrationsSettingsPayload {
   "Whether the operation was successful."   success: Boolean!
 }
 
-"An issue." type Issue implements Node {
+"An issue is the core work item in Linear. Issues belong to a team, have a workflow status, can be assigned to users, carry a priority level, and can be organized into projects and cycles. Issues support sub-issues (parent-child hierarchy up to 10 levels deep), labels, due dates, estimates, and SLA tracking. They can also be linked to other issues via relations, attached to releases, and tracked through their full history of changes." type Issue implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The issue's unique number."   number: Float!
-  "The issue's title."   title: String!
-  "The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low."   priority: Float!
-  "The estimate of the complexity of the issue.."   estimate: Float
+  "The issue's unique number, scoped to the issue's team. Together with the team key, this forms the issue's human-readable identifier (e.g., ENG-123)."   number: Float!
+  "The issue's title. This is the primary human-readable summary of the work item."   title: String!
+  "The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low."   priority: Float!
+  "The estimate of the complexity of the issue. The specific scale used depends on the team's estimation configuration (e.g., points, T-shirt sizes). Null if no estimate has been set."   estimate: Float
   "The order of the item in its column on the board."   boardOrder: Float! @deprecated(reason: "Will be removed in near future, please use `sortOrder` instead")
-  "The order of the item in relation to other items in the organization."   sortOrder: Float!
-  "The order of the item in relation to other items in the organization, when ordered by priority."   prioritySortOrder: Float!
+  "The order of the item in relation to other items in the organization. Used for manual sorting in list views."   sortOrder: Float!
+  "The order of the item in relation to other items in the workspace, when ordered by priority."   prioritySortOrder: Float!
   "The time at which the issue was moved into started state."   startedAt: DateTime
   "The time at which the issue was moved into completed state."   completedAt: DateTime
   "The time at which the issue entered triage."   startedTriageAt: DateTime
@@ -6288,25 +7100,26 @@ type IntegrationsSettingsPayload {
   "[Internal] The time at which the most recent suggestions for this issue were generated."   suggestionsGeneratedAt: DateTime
   "[Internal] The activity summary information for this issue."   activitySummary: JSONObject
   "[Internal] AI-generated activity summary for this issue."   summary: Summary
-  "Id of the labels associated with this issue."   labelIds: [String!]!
-  "The team that the issue is associated with."   team: Team!
-  "The cycle that the issue is associated with."   cycle: Cycle
-  "The project that the issue is associated with."   project: Project
-  "The projectMilestone that the issue is associated with."   projectMilestone: ProjectMilestone
+  "Identifiers of the labels associated with this issue. Can be used to query the labels directly."   labelIds: [String!]!
+  "The team that the issue belongs to. Every issue must belong to exactly one team, which determines the available workflow states, labels, and other team-specific configuration."   team: Team!
+  "The cycle that the issue is associated with. Null if the issue is not part of any cycle."   cycle: Cycle
+  "The project that the issue is associated with. Null if the issue is not part of any project."   project: Project
+  "The project milestone that the issue is associated with. Null if the issue is not assigned to a specific milestone within its project."   projectMilestone: ProjectMilestone
   "The last template that was applied to this issue."   lastAppliedTemplate: Template
   "The recurring issue template that created this issue."   recurringIssueTemplate: Template
   "Previous identifiers of the issue if it has been moved between teams."   previousIdentifiers: [String!]!
-  "The user who created the issue."   creator: User
-  "The external user who created the issue."   externalUserCreator: ExternalUser
-  "The user to whom the issue is assigned to."   assignee: User
-  "The agent user that is delegated to work on this issue."   delegate: User
+  "The user who created the issue. Null if the creator's account has been deleted or if the issue was created by an integration or system process."   creator: User
+  "The external user who created the issue. Set when the issue was created via an integration (e.g., Slack, Intercom) on behalf of a non-Linear user. Null if the issue was created by a Linear user."   externalUserCreator: ExternalUser
+  "The user to whom the issue is assigned. Null if the issue is unassigned."   assignee: User
+  "The agent user that is delegated to work on this issue. Set when an AI agent has been assigned to perform work on this issue. Null if no agent is working on the issue."   delegate: User
   "The user who snoozed the issue."   snoozedBy: User
-  "The workflow state that the issue is associated with."   state: WorkflowState!
+  "The workflow state (issue status) that the issue is currently in. Workflow states represent the issue's progress through the team's workflow, such as Triage, Todo, In Progress, Done, or Canceled."   state: WorkflowState!
   "The order of the item in the sub-issue list. Only set if the issue has a parent."   subIssueSortOrder: Float
-  "Emoji reaction summary, grouped by emoji type."   reactionData: JSONObject!
+  "Emoji reaction summary for the issue, grouped by emoji type. Contains the count and reacting user information for each emoji."   reactionData: JSONObject!
   "Label for the priority."   priorityLabel: String!
-  "The comment that this issue was created from."   sourceComment: Comment
+  "The comment that this issue was created from, when an issue is created from an existing comment. Null if the issue was not created from a comment."   sourceComment: Comment
   "Integration type that created this issue, if applicable."   integrationSourceType: IntegrationService
+  "Whether this issue inherits shared access from its parent issue."   inheritsSharedAccess: Boolean!
   "Documents associated with the issue."   documents(filter: DocumentFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): DocumentConnection!
   "The bot that created the issue, if applicable."   botActor: ActorBot
   "The users favorite associated with this issue."   favorite: Favorite
@@ -6319,6 +7132,7 @@ type IntegrationsSettingsPayload {
   "The parent of the issue."   parent: Issue
   "Children of the issue."   children(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
   "Comments associated with the issue."   comments(filter: CommentFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CommentConnection!
+  "[Internal] AI prompt progresses associated with this issue."   aiPromptProgresses(filter: AiPromptProgressFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): AiPromptProgressConnection!
   "History entries associated with the issue."   history(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueHistoryConnection!
   "Labels associated with this issue."   labels(filter: IssueLabelFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueLabelConnection!
   "Relations associated with this issue."   relations(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueRelationConnection!
@@ -6331,6 +7145,7 @@ type IntegrationsSettingsPayload {
   "Reactions associated with the issue."   reactions: [Reaction!]!
   "Customer needs associated with the issue."   needs(filter: CustomerNeedFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CustomerNeedConnection!
   "Customer needs previously associated with the issue before being moved to another issue."   formerNeeds(filter: CustomerNeedFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CustomerNeedConnection!
+  "[ALPHA] Releases associated with the issue."   releases(filter: ReleaseFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ReleaseConnection!
   "The external services the issue is synced with."   syncedWith: [ExternalEntityInfo!]
   "[Internal] Product Intelligence suggestions for the issue."   suggestions(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueSuggestionConnection!
   "[Internal] Incoming product intelligence relation suggestions for the issue."   incomingSuggestions(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueSuggestionConnection!
@@ -6345,7 +7160,7 @@ type IntegrationsSettingsPayload {
   "The archived/unarchived entity. Null if entity was deleted."   entity: Issue
 }
 
-type IssueBatchPayload {
+"The result of a batch issue mutation, containing the updated issues and a success indicator." type IssueBatchPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The issues that were updated."   issues: [Issue!]!
   "Whether the operation was successful."   success: Boolean!
@@ -6357,39 +7172,39 @@ type IssueConnection {
   pageInfo: PageInfo!
 }
 
-"[Internal] A draft issue." type IssueDraft implements Node {
+"[Internal] A draft issue that has not yet been created as a full issue. Drafts allow users to prepare issue details (title, description, labels, assignee, etc.) before committing them. Drafts belong to a team and a creator, and support a parent-child hierarchy similar to issues. A draft can have either a parent draft or a parent issue, but not both." type IssueDraft implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The draft's title."   title: String!
+  "The draft's title. This will become the issue's title when the draft is published."   title: String!
   "The draft's description in markdown format."   description: String
-  "The priority of the draft."   priority: Float!
-  "The estimate of the complexity of the draft."   estimate: Float
+  "The priority of the draft. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low."   priority: Float!
+  "The estimate of the complexity of the draft. Null if no estimate has been set."   estimate: Float
   "The date at which the issue would be due."   dueDate: TimelessDate
-  "The IDs of labels added to the draft."   labelIds: [String!]!
-  "The team associated with the draft."   teamId: String!
-  "The cycle associated with the draft."   cycleId: String
-  "The project associated with the draft."   projectId: String
-  "The project milestone associated with the draft."   projectMilestoneId: String
+  "Identifiers of the labels added to the draft. These labels will be applied to the issue when the draft is published."   labelIds: [String!]!
+  "Identifier of the team associated with the draft. Can be used to query the team directly."   teamId: String!
+  "Identifier of the cycle associated with the draft. Can be used to query the cycle directly. Null if no cycle is assigned."   cycleId: String
+  "Identifier of the project associated with the draft. Can be used to query the project directly. Null if no project is assigned."   projectId: String
+  "Identifier of the project milestone associated with the draft. Can be used to query the project milestone directly. Null if no milestone is assigned."   projectMilestoneId: String
   "The user who created the draft."   creator: User!
-  "The user assigned to the draft."   assigneeId: String
+  "Identifier of the user assigned to the draft. Can be used to query the user directly. Null if the draft is unassigned."   assigneeId: String
   "The agent user delegated to work on the issue being drafted."   delegateId: String
-  "The workflow state associated with the draft."   stateId: String!
-  "The parent draft of the draft."   parent: IssueDraft
+  "Identifier of the workflow state associated with the draft. Can be used to query the workflow state directly. Determines the initial status the issue will have when the draft is published."   stateId: String!
+  "The parent draft of the draft. Set when this draft represents a sub-issue of another draft. Null if this is a top-level draft or has a parent issue instead."   parent: IssueDraft
   "The ID of the parent issue draft, if any."   parentId: String
-  "The ID of the comment that the draft was created from."   sourceCommentId: String
-  "The parent issue of the draft."   parentIssue: Issue
+  "Identifier of the comment that the draft was created from. Set when a draft is created from an existing comment. Null if the draft was not created from a comment."   sourceCommentId: String
+  "The parent issue of the draft. Set when this draft represents a sub-issue that will be created under an existing issue. Null if this is a top-level draft or has a parent draft instead."   parentIssue: Issue
   "The ID of the parent issue, if any."   parentIssueId: String
   "The order of items in the sub-draft list. Only set if the draft has `parent` set."   subIssueSortOrder: Float
   "Label for the priority."   priorityLabel: String!
   "[Internal] The draft's description as a Prosemirror document."   descriptionData: JSON
   "Serialized array of JSONs representing attachments."   attachments: JSONObject
   "Serialized array of JSONs representing customer needs."   needs: JSONObject
+  "Identifiers of the releases associated with the draft. These releases will be linked to the issue when the draft is published."   releaseIds: [String!]!
   "Serialized array of JSONs representing the recurring issue's schedule."   schedule: JSONObject
-  labels(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueLabelConnection!
 }
 
 type IssueDraftConnection {
@@ -6408,12 +7223,12 @@ type IssueEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type IssueFilterSuggestionPayload {
+"The result of an AI-generated issue filter suggestion based on a text prompt." type IssueFilterSuggestionPayload {
   "The json filter that is suggested."   filter: JSONObject
   "The log id of the prompt, that created this filter."   logId: String
 }
 
-"A record of changes to an issue." type IssueHistory implements Node {
+"A record of changes to an issue. Each history entry captures one or more property changes made to an issue within a short grouping window by the same actor. History entries track changes to fields such as title, assignee, status, priority, project, cycle, labels, due date, estimate, parent issue, and more. They also record metadata about what triggered the change (e.g., a user action, workflow automation, triage rule, or integration)." type IssueHistory implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -6421,30 +7236,30 @@ type IssueFilterSuggestionPayload {
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The issue that was changed."   issue: Issue!
-  "The id of user who made these changes. If null, possibly means that the change made by an integration."   actorId: String
+  "Identifier of the user who made these changes. Can be used to query the user directly. Null if the change was made by an integration, automation, or system process."   actorId: String
   "Whether the issue's description was updated."   updatedDescription: Boolean
   "What the title was changed from."   fromTitle: String
   "What the title was changed to."   toTitle: String
-  "The id of user from whom the issue was re-assigned from."   fromAssigneeId: String
-  "The id of user to whom the issue was assigned to."   toAssigneeId: String
+  "Identifier of the user from whom the issue was re-assigned. Can be used to query the user directly. Null if the assignee was not changed or the issue was previously unassigned."   fromAssigneeId: String
+  "Identifier of the user to whom the issue was assigned. Can be used to query the user directly. Null if the assignee was not changed or the issue was unassigned."   toAssigneeId: String
   "What the priority was changed from."   fromPriority: Float
   "What the priority was changed to."   toPriority: Float
-  "The id of team from which the issue was moved from."   fromTeamId: String
-  "The id of team to which the issue was moved to."   toTeamId: String
-  "The id of previous parent of the issue."   fromParentId: String
-  "The id of new parent of the issue."   toParentId: String
-  "The id of previous workflow state of the issue."   fromStateId: String
-  "The id of new workflow state of the issue."   toStateId: String
-  "The id of previous cycle of the issue."   fromCycleId: String
-  "The id of new cycle of the issue."   toCycleId: String
-  "The id of new project created from the issue."   toConvertedProjectId: String
-  "The id of previous project of the issue."   fromProjectId: String
-  "The id of new project of the issue."   toProjectId: String
+  "Identifier of the team from which the issue was moved. Can be used to query the team directly. Null if the team was not changed."   fromTeamId: String
+  "Identifier of the team to which the issue was moved. Can be used to query the team directly. Null if the team was not changed."   toTeamId: String
+  "Identifier of the previous parent issue. Can be used to query the issue directly. Null if the parent was not changed or the issue previously had no parent."   fromParentId: String
+  "Identifier of the new parent issue. Can be used to query the issue directly. Null if the parent was not changed or the issue was removed from its parent."   toParentId: String
+  "Identifier of the previous workflow state (issue status) of the issue. Can be used to query the workflow state directly. Null if the status was not changed."   fromStateId: String
+  "Identifier of the new workflow state (issue status) of the issue. Can be used to query the workflow state directly. Null if the status was not changed."   toStateId: String
+  "Identifier of the previous cycle of the issue. Can be used to query the cycle directly. Null if the cycle was not changed or the issue was not in a cycle."   fromCycleId: String
+  "Identifier of the new cycle of the issue. Can be used to query the cycle directly. Null if the cycle was not changed or the issue was removed from a cycle."   toCycleId: String
+  "Identifier of the new project that was created by converting this issue to a project. Can be used to query the project directly. Null if the issue was not converted to a project."   toConvertedProjectId: String
+  "Identifier of the previous project of the issue. Can be used to query the project directly. Null if the project was not changed or the issue was not in a project."   fromProjectId: String
+  "Identifier of the new project of the issue. Can be used to query the project directly. Null if the project was not changed or the issue was removed from a project."   toProjectId: String
   "What the estimate was changed from."   fromEstimate: Float
   "What the estimate was changed to."   toEstimate: Float
-  "Whether the issue is archived at the time of this history entry."   archived: Boolean
+  "Whether the issue was archived (true) or unarchived (false) in this change. Null if the archive status was not changed."   archived: Boolean
   "Whether the issue was trashed or un-trashed."   trashed: Boolean
-  "The id of linked attachment."   attachmentId: String
+  "Identifier of the attachment that was linked to or unlinked from the issue. Can be used to query the attachment directly. Null if no attachment change occurred."   attachmentId: String
   "ID's of labels that were added."   addedLabelIds: [String!]
   "ID's of labels that were removed."   removedLabelIds: [String!]
   "[ALPHA] ID's of releases that the issue was added to."   addedToReleaseIds: [String!]
@@ -6454,7 +7269,7 @@ type IssueFilterSuggestionPayload {
   "Whether the issue was auto-archived."   autoArchived: Boolean
   "What the due date was changed from."   fromDueDate: TimelessDate
   "What the due date was changed to."   toDueDate: TimelessDate
-  "The id of linked customer need."   customerNeedId: String
+  "[Deprecated] Identifier of the customer need that was linked to the issue. Use customer need related arrays in changes instead."   customerNeedId: String
   "[Internal] Serialized JSON representing changes for certain non-relational properties."   changes: JSONObject
   "The actor that performed the actions. This field may be empty in the case of integrations or automations."   actor: User
   "The actors that performed the actions. This field may be empty in the case of integrations or automations."   actors: [User!] @deprecated(reason: "Use `actor` and `descriptionUpdatedBy` instead.")
@@ -6494,7 +7309,8 @@ type IssueFilterSuggestionPayload {
   "The labels that were removed from the issue."   removedLabels: [IssueLabel!]
   "The releases that the issue was added to."   addedToReleases: [Release!]
   "The releases that the issue was removed from."   removedFromReleases: [Release!]
-  "[INTERNAL] Metadata about the triage rule that made changes to the issue."   triageRuleMetadata: IssueHistoryTriageRuleMetadata
+  "[INTERNAL] Metadata about the triage rule that made changes to the issue."   triageRuleMetadata: IssueHistoryTriageRuleMetadata @deprecated(reason: "Use `workflowMetadata` instead.")
+  "[INTERNAL] Metadata about the workflow that made changes to the issue."   workflowMetadata: IssueHistoryWorkflowMetadata
 }
 
 type IssueHistoryConnection {
@@ -6508,7 +7324,7 @@ type IssueHistoryEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"An error that occurred during triage rule execution." type IssueHistoryTriageRuleError {
+"An error that occurred during triage rule execution, such as a conflicting label assignment or an invalid property value. Contains the error type and optionally the property that caused the failure." type IssueHistoryTriageRuleError {
   "The type of error that occurred."   type: TriageRuleErrorType!
   "The property that caused the error."   property: String
   "Whether the conflict was for the same child label."   conflictForSameChildLabel: Boolean
@@ -6517,59 +7333,64 @@ type IssueHistoryEdge {
   "The conflicting labels."   conflictingLabels: [IssueLabel!]
 }
 
-"Metadata about a triage rule that made changes to an issue." type IssueHistoryTriageRuleMetadata {
+"Metadata about a triage responsibility rule that made changes to an issue, such as auto-assigning an issue when it enters triage. Includes information about any errors that occurred during rule execution." type IssueHistoryTriageRuleMetadata {
   "The error that occurred, if any."   triageRuleError: IssueHistoryTriageRuleError
-  "The triage rule that triggered the issue update."   updatedByTriageRule: WorkflowDefinition
+  "The triage rule that triggered the issue update."   updatedByTriageRule: WorkflowDefinition @deprecated(reason: "Use `IssueHistoryWorkflowMetadata.workflowDefinition` instead.")
+}
+
+"Metadata about a workflow automation that made changes to an issue. Links the issue history entry back to the workflow definition that triggered the change, and optionally to any AI conversation involved in the automation." type IssueHistoryWorkflowMetadata {
+  "The workflow definition that triggered the issue update."   workflowDefinition: WorkflowDefinition
+  "The AI conversation associated with the workflow."   aiConversation: AiConversation
 }
 
-"An import job for data from an external service." type IssueImport implements Node {
+"An import job for data from an external service such as Jira, Asana, GitHub, Shortcut, or other project management tools. Import jobs track the full lifecycle of importing issues, labels, workflow states, and other data into a Linear workspace, including progress, status, error states, and data mapping configuration." type IssueImport implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "New team's name in cases when teamId not set."   teamName: String
-  "The id for the user that started the job."   creatorId: String
-  "The service from which data will be imported."   service: String!
-  "The status for the import job."   status: String!
+  "The name of the new team to be created for the import, when the import is configured to create a new team rather than importing into an existing one. Null if importing into an existing team."   teamName: String
+  "Identifier of the user who started the import job. Can be used to query the user directly. Null if the user has been deleted."   creatorId: String
+  "The external service from which data is being imported (e.g., jira, asana, github, shortcut, linear)."   service: String!
+  "The current status of the import job, indicating its position in the import lifecycle (e.g., not started, in progress, complete, error)."   status: String!
   "The data mapping configuration for the import job."   mapping: JSONObject
   "User readable error message, if one has occurred during the import."   error: String
-  "Current step progress in % (0-100)."   progress: Float
+  "Current step progress as a percentage (0-100). Null if the import has not yet started or progress tracking is not available."   progress: Float
   "File URL for the uploaded CSV for the import, if there is one."   csvFileUrl: String
   "Error code and metadata, if one has occurred during the import."   errorMetadata: JSONObject
   "Metadata related to import service."   serviceMetadata: JSONObject
   "The display name of the import service."   displayName: String!
 }
 
-type IssueImportCheckPayload {
+"The result of checking whether an import from an external service can proceed." type IssueImportCheckPayload {
   "Whether the operation was successful."   success: Boolean!
 }
 
-type IssueImportDeletePayload {
+"The result of deleting an issue import, containing the deleted import job and a success indicator." type IssueImportDeletePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The import job that was deleted."   issueImport: IssueImport
   "Whether the operation was successful."   success: Boolean!
 }
 
-"Whether a custom JQL query is valid or not" type IssueImportJqlCheckPayload {
+"The result of validating a custom JQL query for a Jira import." type IssueImportJqlCheckPayload {
   "Returns true if the JQL query has been validated successfully, false otherwise"   success: Boolean!
-  "Returns an approximate number of issues matching the JQL query, if available"   count: Float
+  "An approximate number of issues matching the JQL query. Null when the query is invalid or the count is unavailable."   count: Float
   "An error message returned by Jira when validating the JQL query."   error: String
 }
 
-type IssueImportPayload {
+"The result of an issue import mutation, containing the import job and a success indicator." type IssueImportPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The import job that was created or updated."   issueImport: IssueImport
   "Whether the operation was successful."   success: Boolean!
 }
 
-"Whether an issue import can be synced at the end of an import or not" type IssueImportSyncCheckPayload {
+"The result of checking whether an issue import can be synced with its source service after import completes." type IssueImportSyncCheckPayload {
   "Returns true if the import can be synced, false otherwise"   canSync: Boolean!
-  "An error message with a root cause of why the import cannot be synced"   error: String
+  "An error message explaining why the import cannot be synced. Null when canSync is true."   error: String
 }
 
-"Labels that can be associated with issues." type IssueLabel implements Node {
+"Labels that can be associated with issues. Labels help categorize and filter issues across a workspace. They can be workspace-level (shared across all teams) or team-scoped. Labels have a color for visual identification and can be organized hierarchically into groups, where a parent label acts as a group containing child labels. Labels may also be inherited from parent teams to sub-teams." type IssueLabel implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -6578,18 +7399,18 @@ type IssueImportPayload {
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The label's name."   name: String!
   "The label's description."   description: String
-  "The label's color as a HEX string."   color: String!
-  "Whether the label is a group."   isGroup: Boolean!
-  "The date when the label was last applied to an issue or project."   lastAppliedAt: DateTime
+  "The label's color as a HEX string (e.g., '#EB5757'). Used for visual identification of the label in the UI."   color: String!
+  "Whether the label is a group. When true, this label acts as a container for child labels and cannot be directly applied to issues or projects. When false, the label can be directly applied."   isGroup: Boolean!
+  "The date when the label was last applied to an issue or project. Null if the label has never been applied."   lastAppliedAt: DateTime
   "[Internal] When the label was retired."   retiredAt: DateTime
   organization: Organization! @deprecated(reason: "Workspace labels are identified by their team being null.")
-  "The team that the label is associated with. If null, the label is associated with the global workspace."   team: Team
+  "The team that the label is scoped to. If null, the label is a workspace-level label available to all teams in the workspace."   team: Team
   "The user who created the label."   creator: User
   "The user who retired the label."   retiredBy: User
   "The parent label."   parent: IssueLabel
-  "The original label inherited from."   inheritedFrom: IssueLabel
+  "The original workspace or parent-team label that this label was inherited from. Null if the label is not inherited."   inheritedFrom: IssueLabel
   "Issues associated with the label."   issues(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
-  "Children of the label."   children(filter: IssueLabelFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueLabelConnection!
+  "Child labels within this label group. Only populated when the label is a group (isGroup is true)."   children(filter: IssueLabelFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueLabelConnection!
 }
 
 type IssueLabelConnection {
@@ -6603,13 +7424,13 @@ type IssueLabelEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type IssueLabelPayload {
+"The result of a label mutation, containing the created or updated label and a success indicator." type IssueLabelPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The label that was created or updated."   issueLabel: IssueLabel!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"An issue related notification." type IssueNotification implements Notification & Entity & Node {
+"A notification related to an issue, such as assignment, comment, mention, status change, or priority change." type IssueNotification implements Notification & Entity & Node {
   "Related comment ID. Null if the notification is not related to a comment."   commentId: String
   "Related parent comment ID. Null if the notification is not related to a comment."   parentCommentId: String
   "Name of the reaction emoji related to the notification."   reactionEmoji: String
@@ -6619,16 +7440,14 @@ type IssueLabelPayload {
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "Notification type."   type: String!
-  "The user that caused the notification."   actor: User
-  "The external user that caused the notification."   externalUserActor: ExternalUser
-  "The user that received the notification."   user: User!
-  "The time at when the user marked the notification as read. Null, if the the user hasn't read the notification"   readAt: DateTime
-  """The time at when an email reminder for this notification was sent to the user. Null, if no email
-    reminder has been sent."""
-  emailedAt: DateTime
-  "The time until a notification will be snoozed. After that it will appear in the inbox again."   snoozedUntilAt: DateTime
-  "The time at which a notification was unsnoozed.."   unsnoozedAt: DateTime
+  "Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated."   type: String!
+  "The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event."   actor: User
+  "The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member."   externalUserActor: ExternalUser
+  "The recipient user of this notification."   user: User!
+  "The time at which the user marked the notification as read. Null if the notification is unread."   readAt: DateTime
+  "The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent."   emailedAt: DateTime
+  "The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed."   snoozedUntilAt: DateTime
+  "The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed."   unsnoozedAt: DateTime
   "The category of the notification."   category: NotificationCategory!
   "[Internal] URL to the target of the notification."   url: String!
   "[Internal] Inbox URL for the notification."   inboxUrl: String!
@@ -6652,27 +7471,27 @@ type IssueLabelPayload {
   "The subscriptions related to the notification."   subscriptions: [NotificationSubscription!]
 }
 
-type IssuePayload {
+"The result of an issue mutation, containing the created or updated issue and a success indicator." type IssuePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The issue that was created or updated."   issue: Issue
   "Whether the operation was successful."   success: Boolean!
 }
 
-type IssuePriorityValue {
+"A mapping of an issue priority value to its human-readable label." type IssuePriorityValue {
   "Priority's number value."   priority: Int!
   "Priority's label."   label: String!
 }
 
-"A relation between two issues." type IssueRelation implements Node {
+"A relation between two issues. Issue relations represent directional relationships such as blocking, being blocked by, relating to, or duplicating another issue. Each relation connects a source issue to a related issue with a specific type describing the nature of the relationship." type IssueRelation implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The relationship of the issue with the related issue."   type: String!
-  "The issue whose relationship is being described."   issue: Issue!
-  "The related issue."   relatedIssue: Issue!
+  "The type of relationship between the source issue and the related issue. Possible values include blocks, duplicate, and related."   type: String!
+  "The source issue whose relationship is being described. This is the issue from which the relation originates."   issue: Issue!
+  "The target issue that the source issue is related to. The relation type describes how the source issue relates to this issue."   relatedIssue: Issue!
 }
 
 type IssueRelationConnection {
@@ -6686,12 +7505,12 @@ type IssueRelationEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"Issue relation history's payload." type IssueRelationHistoryPayload {
-  "The identifier of the related issue."   identifier: String!
-  "The type of the change."   type: String!
+"Payload describing a change to an issue relation, including which issue was involved and the type of change that occurred." type IssueRelationHistoryPayload {
+  "The human-readable identifier of the related issue (e.g., ENG-123)."   identifier: String!
+  "The type of relation change that occurred (e.g., relation added or removed)."   type: String!
 }
 
-type IssueRelationPayload {
+"The result of an issue relation mutation, containing the created or updated issue relation and a success indicator." type IssueRelationPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The issue relation that was created or updated."   issueRelation: IssueRelation!
   "Whether the operation was successful."   success: Boolean!
@@ -6701,8 +7520,8 @@ type IssueSearchPayload {
   edges: [IssueSearchResultEdge!]!
   nodes: [IssueSearchResult!]!
   pageInfo: PageInfo!
-  "Archived entities matching the search term along with all their dependencies."   archivePayload: ArchiveResponse!
-  "Total number of results for query without filters applied."   totalCount: Float!
+  "Archived entities matching the search term along with all their dependencies, serialized for the client sync engine."   archivePayload: ArchiveResponse!
+  "Total number of matching results before pagination is applied."   totalCount: Float!
 }
 
 type IssueSearchResult implements Node {
@@ -6712,13 +7531,13 @@ type IssueSearchResult implements Node {
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The issue's unique number."   number: Float!
-  "The issue's title."   title: String!
-  "The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low."   priority: Float!
-  "The estimate of the complexity of the issue.."   estimate: Float
+  "The issue's unique number, scoped to the issue's team. Together with the team key, this forms the issue's human-readable identifier (e.g., ENG-123)."   number: Float!
+  "The issue's title. This is the primary human-readable summary of the work item."   title: String!
+  "The priority of the issue. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low."   priority: Float!
+  "The estimate of the complexity of the issue. The specific scale used depends on the team's estimation configuration (e.g., points, T-shirt sizes). Null if no estimate has been set."   estimate: Float
   "The order of the item in its column on the board."   boardOrder: Float! @deprecated(reason: "Will be removed in near future, please use `sortOrder` instead")
-  "The order of the item in relation to other items in the organization."   sortOrder: Float!
-  "The order of the item in relation to other items in the organization, when ordered by priority."   prioritySortOrder: Float!
+  "The order of the item in relation to other items in the organization. Used for manual sorting in list views."   sortOrder: Float!
+  "The order of the item in relation to other items in the workspace, when ordered by priority."   prioritySortOrder: Float!
   "The time at which the issue was moved into started state."   startedAt: DateTime
   "The time at which the issue was moved into completed state."   completedAt: DateTime
   "The time at which the issue entered triage."   startedTriageAt: DateTime
@@ -6740,25 +7559,26 @@ type IssueSearchResult implements Node {
   "[Internal] The time at which the most recent suggestions for this issue were generated."   suggestionsGeneratedAt: DateTime
   "[Internal] The activity summary information for this issue."   activitySummary: JSONObject
   "[Internal] AI-generated activity summary for this issue."   summary: Summary
-  "Id of the labels associated with this issue."   labelIds: [String!]!
-  "The team that the issue is associated with."   team: Team!
-  "The cycle that the issue is associated with."   cycle: Cycle
-  "The project that the issue is associated with."   project: Project
-  "The projectMilestone that the issue is associated with."   projectMilestone: ProjectMilestone
+  "Identifiers of the labels associated with this issue. Can be used to query the labels directly."   labelIds: [String!]!
+  "The team that the issue belongs to. Every issue must belong to exactly one team, which determines the available workflow states, labels, and other team-specific configuration."   team: Team!
+  "The cycle that the issue is associated with. Null if the issue is not part of any cycle."   cycle: Cycle
+  "The project that the issue is associated with. Null if the issue is not part of any project."   project: Project
+  "The project milestone that the issue is associated with. Null if the issue is not assigned to a specific milestone within its project."   projectMilestone: ProjectMilestone
   "The last template that was applied to this issue."   lastAppliedTemplate: Template
   "The recurring issue template that created this issue."   recurringIssueTemplate: Template
   "Previous identifiers of the issue if it has been moved between teams."   previousIdentifiers: [String!]!
-  "The user who created the issue."   creator: User
-  "The external user who created the issue."   externalUserCreator: ExternalUser
-  "The user to whom the issue is assigned to."   assignee: User
-  "The agent user that is delegated to work on this issue."   delegate: User
+  "The user who created the issue. Null if the creator's account has been deleted or if the issue was created by an integration or system process."   creator: User
+  "The external user who created the issue. Set when the issue was created via an integration (e.g., Slack, Intercom) on behalf of a non-Linear user. Null if the issue was created by a Linear user."   externalUserCreator: ExternalUser
+  "The user to whom the issue is assigned. Null if the issue is unassigned."   assignee: User
+  "The agent user that is delegated to work on this issue. Set when an AI agent has been assigned to perform work on this issue. Null if no agent is working on the issue."   delegate: User
   "The user who snoozed the issue."   snoozedBy: User
-  "The workflow state that the issue is associated with."   state: WorkflowState!
+  "The workflow state (issue status) that the issue is currently in. Workflow states represent the issue's progress through the team's workflow, such as Triage, Todo, In Progress, Done, or Canceled."   state: WorkflowState!
   "The order of the item in the sub-issue list. Only set if the issue has a parent."   subIssueSortOrder: Float
-  "Emoji reaction summary, grouped by emoji type."   reactionData: JSONObject!
+  "Emoji reaction summary for the issue, grouped by emoji type. Contains the count and reacting user information for each emoji."   reactionData: JSONObject!
   "Label for the priority."   priorityLabel: String!
-  "The comment that this issue was created from."   sourceComment: Comment
+  "The comment that this issue was created from, when an issue is created from an existing comment. Null if the issue was not created from a comment."   sourceComment: Comment
   "Integration type that created this issue, if applicable."   integrationSourceType: IntegrationService
+  "Whether this issue inherits shared access from its parent issue."   inheritsSharedAccess: Boolean!
   "Documents associated with the issue."   documents(filter: DocumentFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): DocumentConnection!
   "The bot that created the issue, if applicable."   botActor: ActorBot
   "The users favorite associated with this issue."   favorite: Favorite
@@ -6771,6 +7591,7 @@ type IssueSearchResult implements Node {
   "The parent of the issue."   parent: Issue
   "Children of the issue."   children(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
   "Comments associated with the issue."   comments(filter: CommentFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CommentConnection!
+  "[Internal] AI prompt progresses associated with this issue."   aiPromptProgresses(filter: AiPromptProgressFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): AiPromptProgressConnection!
   "History entries associated with the issue."   history(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueHistoryConnection!
   "Labels associated with this issue."   labels(filter: IssueLabelFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueLabelConnection!
   "Relations associated with this issue."   relations(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueRelationConnection!
@@ -6783,6 +7604,7 @@ type IssueSearchResult implements Node {
   "Reactions associated with the issue."   reactions: [Reaction!]!
   "Customer needs associated with the issue."   needs(filter: CustomerNeedFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CustomerNeedConnection!
   "Customer needs previously associated with the issue before being moved to another issue."   formerNeeds(filter: CustomerNeedFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CustomerNeedConnection!
+  "[ALPHA] Releases associated with the issue."   releases(filter: ReleaseFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ReleaseConnection!
   "The external services the issue is synced with."   syncedWith: [ExternalEntityInfo!]
   "[Internal] Product Intelligence suggestions for the issue."   suggestions(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueSuggestionConnection!
   "[Internal] Incoming product intelligence relation suggestions for the issue."   incomingSuggestions(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueSuggestionConnection!
@@ -6797,11 +7619,12 @@ type IssueSearchResultEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type IssueSharedAccess {
+"Metadata about an issue's shared access state, including which users the issue is shared with and any field restrictions for shared-only viewers." type IssueSharedAccess {
   "Whether this issue has been shared with users outside the team."   isShared: Boolean!
   "Whether the viewer can access this issue only through issue sharing."   viewerHasOnlySharedAccess: Boolean!
   "The number of users this issue is shared with."   sharedWithCount: Int!
   "Users this issue is shared with."   sharedWithUsers: [User!]!
+  "Issue update fields the viewer cannot modify due to shared-only access."   disallowedIssueFields: [IssueSharedAccessDisallowedField!]!
 }
 
 "A continuous period of time during which an issue remained in a specific workflow state." type IssueStateSpan {
@@ -6823,30 +7646,28 @@ type IssueStateSpanEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type IssueSuggestion implements Node {
+"[Internal] An AI-generated suggestion for an issue. Suggestions can recommend related or similar issues, assignees, labels, teams, or projects. Each suggestion has a type, state (active, accepted, dismissed), and optionally associated metadata with scoring information." type IssueSuggestion implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  issue: Issue!
-  issueId: String!
-  type: IssueSuggestionType!
-  state: IssueSuggestionState!
-  stateChangedAt: DateTime!
-  dismissalReason: String
-  metadata: IssueSuggestionMetadata
-  suggestedIssue: Issue
-  suggestedIssueId: String
-  suggestedTeam: Team
-  suggestedProject: Project
-  suggestedUser: User
-  suggestedUserId: String
-  suggestedLabel: IssueLabel
-  suggestedLabelId: String
-  "The reasons for the suggestion."   reasons: [String!]!
-  "Whether the suggestion should be visible."   isVisible: Boolean!
+  "[Internal] The issue that this suggestion applies to."   issue: Issue!
+  "[Internal] Identifier of the issue that this suggestion applies to. Can be used to query the issue directly."   issueId: String!
+  "[Internal] The type of suggestion, indicating what kind of entity is being suggested (e.g., similarIssue, relatedIssue, assignee, label, team, project)."   type: IssueSuggestionType!
+  "[Internal] The current state of the suggestion: active, accepted, or dismissed."   state: IssueSuggestionState!
+  "[Internal] The date when the suggestion's state was last changed (e.g., from active to accepted or dismissed)."   stateChangedAt: DateTime!
+  "[Internal] The reason the suggestion was dismissed by the user. Null if the suggestion has not been dismissed."   dismissalReason: String
+  "[Internal] Metadata associated with the suggestion, including confidence scores and classification. Null if no metadata is available."   metadata: IssueSuggestionMetadata
+  "[Internal] The suggested issue, when the suggestion type is similarIssue or relatedIssue. Null for other suggestion types."   suggestedIssue: Issue
+  "[Internal] Identifier of the suggested issue. Set when the suggestion type is similarIssue or relatedIssue. Can be used to query the issue directly."   suggestedIssueId: String
+  "[Internal] The suggested team, when the suggestion type is team. Null for other suggestion types."   suggestedTeam: Team
+  "[Internal] The suggested project, when the suggestion type is project. Null for other suggestion types."   suggestedProject: Project
+  "[Internal] The suggested user, when the suggestion type is assignee. Null for other suggestion types."   suggestedUser: User
+  "[Internal] Identifier of the suggested user. Set when the suggestion type is assignee. Can be used to query the user directly."   suggestedUserId: String
+  "[Internal] The suggested label, when the suggestion type is label. Null for other suggestion types."   suggestedLabel: IssueLabel
+  "[Internal] Identifier of the suggested label. Set when the suggestion type is label. Can be used to query the label directly."   suggestedLabelId: String
 }
 
 type IssueSuggestionConnection {
@@ -6860,32 +7681,31 @@ type IssueSuggestionEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type IssueSuggestionMetadata {
-  score: Float
-  classification: String
-  reasons: [String!]
-  evalLogId: String
-  rank: Float
-  variant: String
-  appliedAutomationRuleId: String
+"[Internal] Metadata associated with an issue suggestion, including scoring and classification information." type IssueSuggestionMetadata {
+  "[Internal] The confidence score of the suggestion. Higher values indicate greater confidence. Null if no score was computed."   score: Float
+  "[Internal] The classification category of the suggestion. Null if no classification was assigned."   classification: String
+  "[Internal] The reasons explaining why this suggestion was made. Null if no reasons are available."   reasons: [String!]
+  "[Internal] Identifier of the evaluation log entry associated with this suggestion. Null if no log entry exists."   evalLogId: String
+  "[Internal] The rank of this suggestion relative to other suggestions of the same type. Lower values indicate higher priority. Null if not ranked."   rank: Float
+  "[Internal] The AI prompt variant that generated this suggestion. Null if not applicable."   variant: String
+  "[Internal] Identifier of the automation rule that was applied from this suggestion. Null if no rule was applied."   appliedAutomationRuleId: String
 }
 
-type IssueTitleSuggestionFromCustomerRequestPayload {
+"Return type for AI-generated issue title suggestions based on customer request content." type IssueTitleSuggestionFromCustomerRequestPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "The suggested issue title."   title: String!
-  "[Internal] The log id of the ai response."   logId: String
+  "The AI-suggested issue title based on the customer request content."   title: String!
+  "[Internal] The evaluation log ID of the AI response, for tracing and debugging."   logId: String
 }
 
-"[Internal] Join table between issues and releases." type IssueToRelease implements Node {
+"[Internal] A join entity linking an issue to a release for release tracking. Each record represents an association between a single issue and a single release, along with metadata about the source of the link (e.g., which pull requests connected the issue to the release). Creating or deleting these associations automatically records the change in issue history." type IssueToRelease implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The issue associated with the release."   issue: Issue!
-  "The release associated with the issue."   release: Release!
-  "The pull request that linked this issue to the release."   pullRequest: PullRequest
+  "The issue that is linked to the release."   issue: Issue!
+  "The release that the issue is linked to."   release: Release!
 }
 
 type IssueToReleaseConnection {
@@ -6899,129 +7719,90 @@ type IssueToReleaseEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"[ALPHA] The result of an issueToRelease mutation." type IssueToReleasePayload {
+"[ALPHA] The result of an issue-to-release mutation, containing the created or updated association and a success indicator." type IssueToReleasePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The issueToRelease that was created or updated."   issueToRelease: IssueToRelease!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"A label notification subscription." type LabelNotificationSubscription implements NotificationSubscription & Entity & Node {
+type JiraFetchProjectStatusesPayload {
+  "The identifier of the last sync operation."   lastSyncId: Float!
+  "The integration that was created or updated."   integration: Integration
+  "Whether the operation was successful."   success: Boolean!
+  "The fetched Jira issue statuses (non-Epic)."   issueStatuses: [String!]!
+  "The fetched Jira project statuses (Epic)."   projectStatuses: [String!]!
+}
+
+"A notification subscription scoped to a specific issue label. The subscriber receives notifications for events related to issues with this label." type LabelNotificationSubscription implements NotificationSubscription & Entity & Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The user that subscribed to receive notifications."   subscriber: User!
-  "The customer associated with the notification subscription."   customer: Customer
-  "The contextual custom view associated with the notification subscription."   customView: CustomView
-  "The contextual cycle view associated with the notification subscription."   cycle: Cycle
+  "The user who will receive notifications from this subscription."   subscriber: User!
+  "The customer that this notification subscription is scoped to. Null if the subscription targets a different entity type."   customer: Customer
+  "The custom view that this notification subscription is scoped to. Null if the subscription targets a different entity type."   customView: CustomView
+  "The cycle that this notification subscription is scoped to. Null if the subscription targets a different entity type."   cycle: Cycle
   "The label subscribed to."   label: IssueLabel!
-  "The contextual project view associated with the notification subscription."   project: Project
-  "The contextual initiative view associated with the notification subscription."   initiative: Initiative
-  "The team associated with the notification subscription."   team: Team
-  "The user view associated with the notification subscription."   user: User
-  "The type of view to which the notification subscription context is associated with."   contextViewType: ContextViewType
-  "The type of user view to which the notification subscription context is associated with."   userContextViewType: UserContextViewType
-  "Whether the subscription is active or not."   active: Boolean!
-  "The type of subscription."   notificationSubscriptionTypes: [String!]!
+  "The project that this notification subscription is scoped to. Null if the subscription targets a different entity type."   project: Project
+  "The initiative that this notification subscription is scoped to. Null if the subscription targets a different entity type."   initiative: Initiative
+  "The team that this notification subscription is scoped to. Null if the subscription targets a different entity type."   team: Team
+  "The user that this notification subscription is scoped to, for user-specific view subscriptions. Null if the subscription targets a different entity type."   user: User
+  "The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type."   contextViewType: ContextViewType
+  "The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type."   userContextViewType: UserContextViewType
+  "Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists."   active: Boolean!
+  "The notification event types that this subscription will deliver to the subscriber."   notificationSubscriptionTypes: [String!]!
 }
 
 type LogoutResponse {
   "Whether the operation was successful."   success: Boolean!
 }
 
+type MicrosoftTeamsChannel {
+  "The Microsoft Teams channel id (e.g. `19:abc@thread.tacv2`)."   id: String!
+  "The display name of the channel."   displayName: String!
+  "The membership type of the channel: standard, private, or shared."   membershipType: String!
+}
+
+type MicrosoftTeamsChannelsPayload {
+  "The teams the user belongs to with their channels."   teams: [MicrosoftTeamsTeam!]!
+  "Whether the operation was successful."   success: Boolean!
+}
+
+type MicrosoftTeamsTeam {
+  "The AAD group id of the team."   id: String!
+  "The display name of the team."   displayName: String!
+  "The channels in the team the user can access."   channels: [MicrosoftTeamsChannel!]!
+}
+
 type Mutation {
   "XHR request payload to upload an images, video and other attachments directly to Linear's cloud storage."   fileUpload(metaData: JSON, makePublic: Boolean, size: Int!, contentType: String!, filename: String!): UploadPayload!
   "XHR request payload to upload a file for import, directly to Linear's cloud storage."   importFileUpload(metaData: JSON, size: Int!, contentType: String!, filename: String!): UploadPayload!
   "Upload an image from an URL to Linear."   imageUploadFromUrl(url: String!): ImageUploadFromUrlPayload!
   "[INTERNAL] Permanently delete an uploaded file by asset URL. This should be used as a last resort and will break comments and documents that reference the asset."   fileUploadDangerouslyDelete(assetUrl: String!): FileUploadDeletePayload!
-  "[INTERNAL] Updates the integration."   integrationUpdate(input: IntegrationUpdateInput!, id: String!): IntegrationPayload!
-  "[INTERNAL] Updates the integration settings."   integrationSettingsUpdate(input: IntegrationSettingsInput!, id: String!): IntegrationPayload! @deprecated(reason: "Use integrationUpdate instead.")
-  "Generates a webhook for the GitHub commit integration."   integrationGithubCommitCreate: GitHubCommitIntegrationPayload!
-  "Connects the organization with the GitHub App."   integrationGithubConnect(githubHost: String, codeAccess: Boolean = false, code: String!, installationId: String!): IntegrationPayload!
-  "Connects the organization with the GitHub Import App."   integrationGithubImportConnect(code: String!, installationId: String!): IntegrationPayload!
-  "Refreshes the data for a GitHub import integration."   integrationGithubImportRefresh(id: String!): IntegrationPayload!
-  "Connects the organization with a GitHub Enterprise Server."   integrationGitHubEnterpriseServerConnect(organizationName: String!, githubUrl: String!): GitHubEnterpriseServerPayload!
-  "Connects the organization with a GitLab Access Token."   integrationGitlabConnect(gitlabUrl: String!, accessToken: String!): GitLabIntegrationCreatePayload!
-  "Tests connectivity to a self-hosted GitLab instance and clears auth errors if successful."   integrationGitlabTestConnection(integrationId: String!): GitLabTestConnectionPayload!
-  "Creates an integration api key for Airbyte to connect with Linear."   airbyteIntegrationConnect(input: AirbyteConfigurationInput!): IntegrationPayload!
-  "[Internal] Connects the Google Calendar to the user to this Linear account via OAuth2."   integrationGoogleCalendarPersonalConnect(code: String!): IntegrationPayload!
-  "[INTERNAL] Integrates the organization with LaunchDarkly."   integrationLaunchDarklyConnect(code: String!, projectKey: String!, environment: String!): IntegrationPayload!
-  "[INTERNAL] Integrates your personal account with LaunchDarkly."   integrationLaunchDarklyPersonalConnect(code: String!): IntegrationPayload!
-  "[INTERNAL] Connects the organization with a Jira Personal Access Token."   jiraIntegrationConnect(input: JiraConfigurationInput!): IntegrationPayload!
-  "[INTERNAL] Updates a Jira Integration."   integrationJiraUpdate(input: JiraUpdateInput!): IntegrationPayload!
-  "Connect your Jira account to Linear."   integrationJiraPersonal(code: String, accessToken: String): IntegrationPayload!
-  "Connect your GitHub account to Linear."   integrationGitHubPersonal(codeAccess: Boolean, code: String!): IntegrationPayload!
-  "Integrates the organization with Intercom."   integrationIntercom(domainUrl: String, redirectUri: String!, code: String!): IntegrationPayload!
-  "Disconnects the organization from Intercom."   integrationIntercomDelete: IntegrationPayload!
-  "[INTERNAL] Refreshes the customer data attributes from the specified integration service."   integrationCustomerDataAttributesRefresh(input: IntegrationCustomerDataAttributesRefreshInput!): IntegrationPayload!
-  "[DEPRECATED] Updates settings on the Intercom integration."   integrationIntercomSettingsUpdate(input: IntercomSettingsInput!): IntegrationPayload! @deprecated(reason: "This mutation is deprecated, please use `integrationSettingsUpdate` instead")
-  "Integrates the organization with Discord."   integrationDiscord(redirectUri: String!, code: String!): IntegrationPayload!
-  "[INTERNAL] Integrates the organization with Opsgenie."   integrationOpsgenieConnect(apiKey: String!): IntegrationPayload!
-  "[INTERNAL] Refresh Opsgenie schedule mappings."   integrationOpsgenieRefreshScheduleMappings: IntegrationPayload!
-  "[INTERNAL] Integrates the organization with PagerDuty."   integrationPagerDutyConnect(code: String!, redirectUri: String!): IntegrationPayload!
-  "[INTERNAL] Refresh PagerDuty schedule mappings."   integrationPagerDutyRefreshScheduleMappings: IntegrationPayload!
-  "[Internal] Updates existing Slack integration scopes."   updateIntegrationSlackScopes(integrationId: String!, redirectUri: String!, code: String!): IntegrationPayload!
-  "Integrates the organization with Slack."   integrationSlack(shouldUseV2Auth: Boolean, redirectUri: String!, code: String!): IntegrationPayload!
-  "Integrates the organization with the Slack Asks app."   integrationSlackAsks(redirectUri: String!, code: String!): IntegrationPayload!
-  "Updates the Slack team's name in Linear for an existing Slack or Asks integration."   integrationSlackOrAsksUpdateSlackTeamName(integrationId: String!): IntegrationSlackWorkspaceNamePayload!
-  "Integrates your personal notifications with Slack."   integrationSlackPersonal(redirectUri: String!, code: String!): IntegrationPayload!
-  "Connect a Slack channel to Asks."   integrationAsksConnectChannel(redirectUri: String!, code: String!): AsksChannelConnectPayload!
-  "Slack integration for team notifications."   integrationSlackPost(shouldUseV2Auth: Boolean, redirectUri: String!, teamId: String!, code: String!): SlackChannelConnectPayload!
-  "Slack integration for project notifications."   integrationSlackProjectPost(service: String!, redirectUri: String!, projectId: String!, code: String!): SlackChannelConnectPayload!
-  "[Internal] Slack integration for initiative notifications."   integrationSlackInitiativePost(redirectUri: String!, initiativeId: String!, code: String!): SlackChannelConnectPayload!
-  "Slack integration for custom view notifications."   integrationSlackCustomViewNotifications(redirectUri: String!, customViewId: String!, code: String!): SlackChannelConnectPayload!
-  "Integrates a Slack Asks channel with a Customer."   integrationSlackCustomerChannelLink(redirectUri: String!, customerId: String!, code: String!): SuccessPayload!
-  "Slack integration for organization level project update notifications."   integrationSlackOrgProjectUpdatesPost(redirectUri: String!, code: String!): SlackChannelConnectPayload!
-  "[Internal] Slack integration for organization level initiative update notifications."   integrationSlackOrgInitiativeUpdatesPost(redirectUri: String!, code: String!): SlackChannelConnectPayload!
-  "Imports custom emojis from your Slack workspace."   integrationSlackImportEmojis(redirectUri: String!, code: String!): IntegrationPayload!
-  "Integrates the organization with Figma."   integrationFigma(redirectUri: String!, code: String!): IntegrationPayload!
-  "Integrates the organization with Gong."   integrationGong(redirectUri: String!, code: String!): IntegrationPayload!
-  "[ALPHA] Integrates the organization with Microsoft Teams."   integrationMicrosoftTeams(redirectUri: String!, code: String!): IntegrationPayload!
-  "Integrates the organization with Google Sheets."   integrationGoogleSheets(code: String!): IntegrationPayload!
-  "Manually update Google Sheets data."   refreshGoogleSheetsData(type: String, id: String!): IntegrationPayload!
-  "Integrates the organization with Sentry."   integrationSentryConnect(organizationSlug: String!, code: String!, installationId: String!): IntegrationPayload!
-  "Integrates the organization with Front."   integrationFront(redirectUri: String!, code: String!): IntegrationPayload!
-  "Integrates the organization with Zendesk."   integrationZendesk(subdomain: String!, code: String!, scope: String!, redirectUri: String!): IntegrationPayload!
-  "Enables Loom integration for the organization."   integrationLoom: IntegrationPayload! @deprecated(reason: "Not available.")
-  "Integrates the organization with Salesforce."   integrationSalesforce(code: String!, subdomain: String!, redirectUri: String!): IntegrationPayload!
-  "[INTERNAL] Refreshes the Salesforce integration metadata."   integrationSalesforceMetadataRefresh(id: String!): IntegrationPayload!
-  "[INTERNAL] Connects the user's personal account with an MCP server."   integrationMcpServerPersonalConnect(serverUrl: String!): IntegrationPayload!
-  "[INTERNAL] Connects the workspace with an MCP server."   integrationMcpServerConnect(teamId: String, serverUrl: String!): IntegrationPayload!
-  "Deletes an integration."   integrationDelete(skipInstallationDeletion: Boolean, id: String!): DeletePayload!
-  "Archives an integration."   integrationArchive(id: String!): DeletePayload!
-  "[Internal] Enables Linear Agent Slack workflow access for a Slack or Slack Asks integration."   integrationSlackWorkflowAccessUpdate(enabled: Boolean!, integrationId: String!): IntegrationPayload!
-  "Creates a new initiativeToProject join."   initiativeToProjectCreate(input: InitiativeToProjectCreateInput!): InitiativeToProjectPayload!
-  "Updates a initiativeToProject."   initiativeToProjectUpdate(input: InitiativeToProjectUpdateInput!, id: String!): InitiativeToProjectPayload!
-  "Deletes a initiativeToProject."   initiativeToProjectDelete(id: String!): DeletePayload!
-  "Creates a new comment."   commentCreate(input: CommentCreateInput!): CommentPayload!
-  "Updates a comment."   commentUpdate(skipEditedAt: Boolean, input: CommentUpdateInput!, id: String!): CommentPayload!
-  "Deletes a comment."   commentDelete(id: String!): DeletePayload!
-  "Resolves a comment."   commentResolve(resolvingCommentId: String, id: String!): CommentPayload!
-  "Unresolves a comment."   commentUnresolve(id: String!): CommentPayload!
   "Creates a new state, adding it to the workflow of a team."   workflowStateCreate(input: WorkflowStateCreateInput!): WorkflowStatePayload!
   "Updates a state."   workflowStateUpdate(input: WorkflowStateUpdateInput!, id: String!): WorkflowStatePayload!
   "Archives a state. Only states with issues that have all been archived can be archived."   workflowStateArchive(id: String!): WorkflowStateArchivePayload!
-  "Creates a new webhook."   webhookCreate(input: WebhookCreateInput!): WebhookPayload!
+  "Creates a new webhook subscription for the workspace. Requires specifying a URL, resource types to subscribe to, and either a specific team or all public teams."   webhookCreate(input: WebhookCreateInput!): WebhookPayload!
   "Updates an existing Webhook."   webhookUpdate(input: WebhookUpdateInput!, id: String!): WebhookPayload!
   "Deletes a Webhook."   webhookDelete(id: String!): DeletePayload!
-  "Rotates the signing secret for a Webhook."   webhookRotateSecret(id: String!): WebhookRotateSecretPayload!
-  "Creates a new ViewPreferences object."   viewPreferencesCreate(input: ViewPreferencesCreateInput!): ViewPreferencesPayload!
-  "Updates an existing ViewPreferences object."   viewPreferencesUpdate(input: ViewPreferencesUpdateInput!, id: String!): ViewPreferencesPayload!
-  "Deletes a ViewPreferences."   viewPreferencesDelete(id: String!): DeletePayload!
-  "Updates the user's settings."   userSettingsUpdate(input: UserSettingsUpdateInput!, id: String!): UserSettingsPayload!
-  "Resets user's setting flags."   userSettingsFlagsReset(flags: [UserFlagType!]): UserSettingsFlagsResetPayload!
-  "Updates a user's settings flag."   userFlagUpdate(operation: UserFlagUpdateOperation!, flag: UserFlagType!): UserSettingsFlagPayload!
-  "Subscribes to or unsubscribes from a notification category for a given notification channel for the user"   notificationCategoryChannelSubscriptionUpdate(channel: NotificationChannel!, category: NotificationCategory!, subscribe: Boolean!): UserSettingsPayload!
-  "Updates a user. Only available to organization admins and the user themselves."   userUpdate(input: UserUpdateInput!, id: String!): UserPayload!
+  "Rotates the signing secret for a webhook, generating a new HMAC-SHA256 key and returning it. The old secret is immediately invalidated."   webhookRotateSecret(id: String!): WebhookRotateSecretPayload!
+  "Creates a new view preferences object. If conflicting preferences already exist for the same view type and scope, the existing preferences are replaced."   viewPreferencesCreate(input: ViewPreferencesCreateInput!): ViewPreferencesPayload!
+  "Updates an existing view preferences object. For user-type preferences, only the owning user can update them."   viewPreferencesUpdate(input: ViewPreferencesUpdateInput!, id: String!): ViewPreferencesPayload!
+  "Deletes a view preferences object. If the preferences do not exist, the operation is treated as a successful idempotent deletion."   viewPreferencesDelete(id: String!): DeletePayload!
+  "Updates the authenticated user's settings, including notification preferences, email subscriptions, theme, and other UI preferences."   userSettingsUpdate(input: UserSettingsUpdateInput!, id: String!): UserSettingsPayload!
+  "Resets one or more of the user's setting flags. If no specific flags are provided, all flags are reset."   userSettingsFlagsReset(flags: [UserFlagType!]): UserSettingsFlagsResetPayload!
+  "Updates a specific user settings flag by performing an operation (e.g., increment or clear) on it."   userFlagUpdate(operation: UserFlagUpdateOperation!, flag: UserFlagType!): UserSettingsFlagPayload!
+  "Subscribes to or unsubscribes from a specific notification category for a given notification channel. For example, subscribe to 'issueAssignment' notifications via the 'email' channel."   notificationCategoryChannelSubscriptionUpdate(channel: NotificationChannel!, category: NotificationCategory!, subscribe: Boolean!): UserSettingsPayload!
+  "Updates a user's profile information. Users can update their own profile; workspace admins can update any user's profile. SCIM-managed users may have restricted name changes."   userUpdate(input: UserUpdateInput!, id: String!): UserPayload!
   "Connects the Discord user to this Linear account via OAuth2."   userDiscordConnect(redirectUri: String!, code: String!): UserPayload!
   "Disconnects the external user from this Linear account."   userExternalUserDisconnect(service: String!): UserPayload!
-  "Changes the role of a user."   userChangeRole(role: UserRoleType!, id: String!): UserAdminPayload!
-  "Suspends a user. Can only be called by an admin or owner."   userSuspend(forceBypassScimRestrictions: Boolean, id: String!): UserAdminPayload!
-  "Revokes a user's sessions. Can only be called by an admin or owner."   userRevokeAllSessions(id: String!): UserAdminPayload!
-  "Revokes a specific session for a user. Can only be called by an admin or owner."   userRevokeSession(sessionId: String!, id: String!): UserAdminPayload!
-  "Un-suspends a user. Can only be called by an admin or owner."   userUnsuspend(forceBypassScimRestrictions: Boolean, id: String!): UserAdminPayload!
+  "Changes the workspace role of a user. The requesting user must have a role equal to or higher than the target role. Requires workspace admin permissions."   userChangeRole(role: UserRoleType!, id: String!): UserAdminPayload!
+  "Suspends a user, deactivating their account and revoking access to the workspace. The suspended user's sessions are invalidated. Can only be called by a workspace admin or owner."   userSuspend(forceBypassScimRestrictions: Boolean, id: String!): UserAdminPayload!
+  "Revokes all active sessions for a user, forcing them to re-authenticate. Can only be called by a workspace admin or owner."   userRevokeAllSessions(id: String!): UserAdminPayload!
+  "Revokes a specific authentication session for a user. The admin cannot revoke their own sessions with this mutation. Can only be called by a workspace admin or owner."   userRevokeSession(sessionId: String!, id: String!): UserAdminPayload!
+  "Re-activates a suspended user, restoring their access to the workspace. Can only be called by a workspace admin or owner."   userUnsuspend(forceBypassScimRestrictions: Boolean, id: String!): UserAdminPayload!
   "Unlinks a guest user from their identity provider. Can only be called by an admin when SCIM is enabled."   userUnlinkFromIdentityProvider(id: String!): UserAdminPayload!
   "Creates a new triage responsibility."   triageResponsibilityCreate(input: TriageResponsibilityCreateInput!): TriageResponsibilityPayload!
   "Updates an existing triage responsibility."   triageResponsibilityUpdate(input: TriageResponsibilityUpdateInput!, id: String!): TriageResponsibilityPayload!
@@ -7036,55 +7817,59 @@ type Mutation {
   "Deletes a template."   templateDelete(id: String!): DeletePayload!
   "Creates a new project."   projectCreate(slackChannelName: String, input: ProjectCreateInput!): ProjectPayload!
   "Updates a project."   projectUpdate(input: ProjectUpdateInput!, id: String!): ProjectPayload!
-  "[INTERNAL] Updates all projects currently assigned to to a project status to a new project status."   projectReassignStatus(newProjectStatusId: String!, originalProjectStatusId: String!): SuccessPayload!
-  "Deletes (trashes) a project."   projectDelete(id: String!): ProjectArchivePayload!
+  "[Internal] Creates a Slack channel for an existing project."   projectCreateSlackChannel(integrationId: String, slackChannelName: String!, id: String!): ProjectPayload!
+  "[INTERNAL] Reassigns all projects from one project status to another. Used when archiving or deleting a project status."   projectReassignStatus(newProjectStatusId: String!, originalProjectStatusId: String!): SuccessPayload!
+  "Deletes (trashes) a project. The project can be restored later with projectUnarchive."   projectDelete(id: String!): ProjectArchivePayload!
   "Archives a project."   projectArchive(trash: Boolean, id: String!): ProjectArchivePayload! @deprecated(reason: "Deprecated in favor of projectDelete.")
-  "Unarchives a project."   projectUnarchive(id: String!): ProjectArchivePayload!
+  "Restores a previously trashed or archived project."   projectUnarchive(id: String!): ProjectArchivePayload!
   "Adds a label to a project."   projectAddLabel(labelId: String!, id: String!): ProjectPayload!
   "Removes a label from a project."   projectRemoveLabel(labelId: String!, id: String!): ProjectPayload!
   "Disables external sync on a project."   projectExternalSyncDisable(syncSource: ExternalSyncService!, projectId: String!): ProjectPayload!
-  "Creates a new team. The user who creates the team will automatically be added as a member to the newly created team."   teamCreate(copySettingsFromTeamId: String, input: TeamCreateInput!): TeamPayload!
-  "Updates a team."   teamUpdate(mapping: InheritanceEntityMapping, input: TeamUpdateInput!, id: String!): TeamPayload!
-  "Deletes a team."   teamDelete(id: String!): DeletePayload!
+  "Creates a new team. The user who creates the team will automatically be added as a member and owner of the newly created team. Default workflow states, labels, and other team resources are created alongside the team."   teamCreate(copySettingsFromTeamId: String, input: TeamCreateInput!): TeamPayload!
+  "Updates a team's settings, properties, or configuration. Requires team owner or workspace admin permissions for most changes."   teamUpdate(mapping: InheritanceEntityMapping, input: TeamUpdateInput!, id: String!): TeamPayload!
+  "Archives a team and schedules its data for deletion. Requires team owner or workspace admin permissions."   teamDelete(id: String!): DeletePayload!
   "Unarchives a team and cancels deletion."   teamUnarchive(id: String!): TeamArchivePayload!
-  "Deletes team's cycles data"   teamCyclesDelete(id: String!): TeamPayload!
-  "Creates a new team membership."   teamMembershipCreate(input: TeamMembershipCreateInput!): TeamMembershipPayload!
-  "Updates a team membership."   teamMembershipUpdate(input: TeamMembershipUpdateInput!, id: String!): TeamMembershipPayload!
-  "Deletes a team membership."   teamMembershipDelete(alsoLeaveParentTeams: Boolean, id: String!): DeletePayload!
-  "Deletes a previously used team key."   teamKeyDelete(id: String!): DeletePayload!
-  "Creates a new roadmapToProject join."   roadmapToProjectCreate(input: RoadmapToProjectCreateInput!): RoadmapToProjectPayload!
-  "Updates a roadmapToProject."   roadmapToProjectUpdate(input: RoadmapToProjectUpdateInput!, id: String!): RoadmapToProjectPayload!
-  "Deletes a roadmapToProject."   roadmapToProjectDelete(id: String!): DeletePayload!
+  "Deletes all cycle data for a team, disabling the cycles feature. This removes all cycles and their issue associations."   teamCyclesDelete(id: String!): TeamPayload!
+  "Creates a new team membership, adding a user to a team. Validates that the user is not already a member, the team is not archived or retired, and the requesting user has permission to add members."   teamMembershipCreate(input: TeamMembershipCreateInput!): TeamMembershipPayload!
+  "Updates a team membership, such as changing ownership status or sort order."   teamMembershipUpdate(input: TeamMembershipUpdateInput!, id: String!): TeamMembershipPayload!
+  "Deletes a team membership, removing the user from the team. Users can remove their own membership, or team owners and workspace admins can remove other members."   teamMembershipDelete(alsoLeaveParentTeams: Boolean, id: String!): DeletePayload!
+  "Deletes a previously used team key. The active team key (the team's current key) cannot be deleted."   teamKeyDelete(id: String!): DeletePayload!
+  "[Deprecated] Creates a new roadmap-to-project association. Use InitiativeToProject instead."   roadmapToProjectCreate(input: RoadmapToProjectCreateInput!): RoadmapToProjectPayload!
+  "[Deprecated] Updates a roadmap-to-project association. Use InitiativeToProject instead."   roadmapToProjectUpdate(input: RoadmapToProjectUpdateInput!, id: String!): RoadmapToProjectPayload!
+  "[Deprecated] Deletes a roadmap-to-project association. Use InitiativeToProject instead."   roadmapToProjectDelete(id: String!): DeletePayload!
   "Creates a new roadmap."   roadmapCreate(input: RoadmapCreateInput!): RoadmapPayload! @deprecated(reason: "Roadmaps are deprecated, use initiatives instead.")
   "Updates a roadmap."   roadmapUpdate(input: RoadmapUpdateInput!, id: String!): RoadmapPayload! @deprecated(reason: "Roadmaps are deprecated, use initiatives instead.")
   "Archives a roadmap."   roadmapArchive(id: String!): RoadmapArchivePayload! @deprecated(reason: "Roadmaps are deprecated, use initiatives instead.")
   "Unarchives a roadmap."   roadmapUnarchive(id: String!): RoadmapArchivePayload! @deprecated(reason: "Roadmaps are deprecated, use initiatives instead.")
   "Deletes a roadmap."   roadmapDelete(id: String!): DeletePayload! @deprecated(reason: "Roadmaps are deprecated, use initiatives instead.")
-  "Create CSV export report for the organization."   createCsvExportReport(includePrivateTeamIds: [String!]): CreateCsvExportReportPayload!
-  "[ALPHA] Creates a new release stage."   releaseStageCreate(input: ReleaseStageCreateInput!): ReleaseStagePayload!
-  "[ALPHA] Updates a release stage."   releaseStageUpdate(input: ReleaseStageUpdateInput!, id: String!): ReleaseStagePayload!
-  "[ALPHA] Archives a release stage."   releaseStageArchive(id: String!): ReleaseStageArchivePayload!
+  "Creates a CSV export report for the workspace. The report is generated asynchronously and delivered via email. Requires workspace admin export permission."   createCsvExportReport(includePrivateTeamIds: [String!]): CreateCsvExportReportPayload!
+  "[ALPHA] Creates a new release stage in a pipeline. Non-started stages must use default names and colors, and only one stage of each non-started type is allowed per pipeline. Started stages can optionally be frozen, but at least one non-frozen started stage must remain."   releaseStageCreate(input: ReleaseStageCreateInput!): ReleaseStagePayload!
+  "[ALPHA] Updates an existing release stage. Only started-type stages can be edited. Supports updating name, color, position, and frozen status."   releaseStageUpdate(input: ReleaseStageUpdateInput!, id: String!): ReleaseStagePayload!
+  "[ALPHA] Archives a release stage. Only started-type stages can be archived, and only if they have no active releases and at least one other stage of the same type remains. Cannot archive the last non-frozen started stage."   releaseStageArchive(id: String!): ReleaseStageArchivePayload!
   "[ALPHA] Unarchives a release stage."   releaseStageUnarchive(id: String!): ReleaseStageArchivePayload!
-  "[ALPHA] Syncs release data."   releaseSync(input: ReleaseSyncInput!): ReleasePayload!
-  "[ALPHA] Creates a new release."   releaseCreate(input: ReleaseCreateInput!): ReleasePayload!
-  "[ALPHA] Updates a release."   releaseUpdate(input: ReleaseUpdateInput!, id: String!): ReleasePayload!
+  "[ALPHA] Creates a new release pipeline with default stages. Subject to plan entitlement and quota limits."   releasePipelineCreate(input: ReleasePipelineCreateInput!): ReleasePipelinePayload!
+  "[ALPHA] Updates an existing release pipeline. Supports updating name, slug, type, production flag, path patterns, and team associations. Private teams that the current user cannot access are preserved in the team list."   releasePipelineUpdate(input: ReleasePipelineUpdateInput!, id: String!): ReleasePipelinePayload!
+  "[ALPHA] Archives a release pipeline."   releasePipelineArchive(id: String!): ReleasePipelineArchivePayload!
+  "[ALPHA] Unarchives a release pipeline."   releasePipelineUnarchive(id: String!): ReleasePipelineArchivePayload!
+  "[ALPHA] Permanently deletes a release pipeline and all associated stages and releases."   releasePipelineDelete(id: String!): DeletePayload!
+  "[ALPHA] Syncs release data by resolving issue and pull request references and associating them with a release. For continuous pipelines, creates a new completed release. For scheduled pipelines, finds or creates a started release and accumulates issues into it."   releaseSync(input: ReleaseSyncInput!): ReleasePayload!
+  "[ALPHA] Creates a new release in a pipeline. If no stage is specified, defaults to the first completed stage for continuous pipelines or the first started stage for scheduled pipelines."   releaseCreate(input: ReleaseCreateInput!): ReleasePayload!
+  "[ALPHA] Updates an existing release by ID. Supports updating name, description, version, commit SHA, pipeline, stage, and dates."   releaseUpdate(input: ReleaseUpdateInput!, id: String!): ReleasePayload!
   "[ALPHA] Marks a release as completed. If version is provided, completes that specific release; otherwise completes the most recent started release."   releaseComplete(input: ReleaseCompleteInput!): ReleasePayload!
-  "[ALPHA] Updates a release by pipeline."   releaseUpdateByPipeline(input: ReleaseUpdateByPipelineInput!): ReleasePayload!
-  "[ALPHA] Deletes a release."   releaseDelete(id: String!): DeletePayload!
+  "[ALPHA] Updates a release by pipeline identifier. Finds the release by version or latest started/planned release, and optionally transitions it to a new stage by name."   releaseUpdateByPipeline(input: ReleaseUpdateByPipelineInput!): ReleasePayload!
+  "[ALPHA] Moves a release to the trash bin. Trashed releases are archived and will be permanently deleted after a retention period. If the release is already archived, it is marked as trashed with a fresh archive timestamp."   releaseDelete(id: String!): ReleaseArchivePayload!
   "[ALPHA] Archives a release."   releaseArchive(id: String!): ReleaseArchivePayload!
   "[ALPHA] Unarchives a release."   releaseUnarchive(id: String!): ReleaseArchivePayload!
-  "[ALPHA] Syncs release data using an access key. The pipeline is inferred from the access key."   releaseSyncByAccessKey(input: ReleaseSyncInputBase!): ReleasePayload!
+  "[ALPHA] Syncs release data using an access key for CI/CD integration. The pipeline is automatically inferred from the access key's configured resources, so no pipeline ID is needed in the input."   releaseSyncByAccessKey(input: ReleaseSyncInputBase!): ReleasePayload!
   "[ALPHA] Marks a release as completed using an access key. If version is provided, completes that specific release; otherwise completes the most recent started release. The pipeline is inferred from the access key."   releaseCompleteByAccessKey(input: ReleaseCompleteInputBase!): ReleasePayload!
   "[ALPHA] Updates a release by pipeline using an access key."   releaseUpdateByPipelineByAccessKey(input: ReleaseUpdateByPipelineInputBase!): ReleasePayload!
-  "[ALPHA] Creates a new release pipeline."   releasePipelineCreate(input: ReleasePipelineCreateInput!): ReleasePipelinePayload!
-  "[ALPHA] Updates a release pipeline."   releasePipelineUpdate(input: ReleasePipelineUpdateInput!, id: String!): ReleasePipelinePayload!
-  "[ALPHA] Archives a release pipeline."   releasePipelineArchive(id: String!): ReleasePipelineArchivePayload!
-  "[ALPHA] Unarchives a release pipeline."   releasePipelineUnarchive(id: String!): ReleasePipelineArchivePayload!
-  "[ALPHA] Deletes a release pipeline."   releasePipelineDelete(id: String!): DeletePayload!
+  "[ALPHA] Creates a release note."   releaseNoteCreate(input: ReleaseNoteCreateInput!): ReleaseNotePayload!
+  "[ALPHA] Updates a release note."   releaseNoteUpdate(input: ReleaseNoteUpdateInput!, id: String!): ReleaseNotePayload!
+  "[ALPHA] Deletes a release note."   releaseNoteDelete(id: String!): DeletePayload!
   "Creates a new reaction."   reactionCreate(input: ReactionCreateInput!): ReactionPayload!
   "Deletes a reaction."   reactionDelete(id: String!): DeletePayload!
-  "Creates a push subscription."   pushSubscriptionCreate(input: PushSubscriptionCreateInput!): PushSubscriptionPayload!
-  "Deletes a push subscription."   pushSubscriptionDelete(id: String!): PushSubscriptionPayload!
+  "Creates a push subscription for the authenticated user's current device or browser. If a subscription already exists for the same session, the old one is replaced."   pushSubscriptionCreate(input: PushSubscriptionCreateInput!): PushSubscriptionPayload!
+  "Deletes a push subscription, unregistering the device from receiving push notifications."   pushSubscriptionDelete(id: String!): PushSubscriptionPayload!
   "Creates a new project update."   projectUpdateCreate(input: ProjectUpdateCreateInput!): ProjectUpdatePayload!
   "Updates a project update."   projectUpdateUpdate(input: ProjectUpdateUpdateInput!, id: String!): ProjectUpdatePayload!
   "Archives a project update."   projectUpdateArchive(id: String!): ProjectUpdateArchivePayload!
@@ -7093,7 +7878,7 @@ type Mutation {
   "Create a notification to remind a user about a project update."   createProjectUpdateReminder(userId: String, projectId: String!): ProjectUpdateReminderPayload!
   "Creates a new project status."   projectStatusCreate(input: ProjectStatusCreateInput!): ProjectStatusPayload!
   "Updates a project status."   projectStatusUpdate(input: ProjectStatusUpdateInput!, id: String!): ProjectStatusPayload!
-  "Archives a project status."   projectStatusArchive(id: String!): ProjectStatusArchivePayload!
+  "Archives a project status. The status must not have any active projects assigned to it and must not be the last status of its type."   projectStatusArchive(id: String!): ProjectStatusArchivePayload!
   "Unarchives a project status."   projectStatusUnarchive(id: String!): ProjectStatusArchivePayload!
   "Creates a new project relation."   projectRelationCreate(input: ProjectRelationCreateInput!): ProjectRelationPayload!
   "Updates a project relation."   projectRelationUpdate(input: ProjectRelationUpdateInput!, id: String!): ProjectRelationPayload!
@@ -7105,25 +7890,25 @@ type Mutation {
   "Creates a new project label."   projectLabelCreate(input: ProjectLabelCreateInput!): ProjectLabelPayload!
   "Updates a project label."   projectLabelUpdate(input: ProjectLabelUpdateInput!, id: String!): ProjectLabelPayload!
   "Deletes a project label."   projectLabelDelete(id: String!): DeletePayload!
-  "Retires a project label."   projectLabelRetire(id: String!): ProjectLabelPayload!
-  "Restores a project label."   projectLabelRestore(id: String!): ProjectLabelPayload!
-  "Updates the user's organization."   organizationUpdate(input: OrganizationUpdateInput!): OrganizationPayload!
-  "Get an organization's delete confirmation token."   organizationDeleteChallenge: OrganizationDeletePayload!
-  "Deletes an organization."   organizationDelete(input: DeleteOrganizationInput!): OrganizationDeletePayload!
-  "Cancels the deletion of an organization."   organizationCancelDelete: OrganizationCancelDeletePayload!
-  "Starts a trial for the organization on the specified plan type."   organizationStartTrialForPlan(input: OrganizationStartTrialInput!): OrganizationStartTrialPayload!
-  "[DEPRECATED] Starts a trial for the organization."   organizationStartTrial: OrganizationStartTrialPayload! @deprecated(reason: "Use organizationStartTrialForPlan")
-  "Creates a new organization invite."   organizationInviteCreate(input: OrganizationInviteCreateInput!): OrganizationInvitePayload!
-  "Updates an organization invite."   organizationInviteUpdate(input: OrganizationInviteUpdateInput!, id: String!): OrganizationInvitePayload!
-  "Re-send an organization invite."   resendOrganizationInvite(id: String!): DeletePayload!
-  "Re-send an organization invite tied to an email address."   resendOrganizationInviteByEmail(email: String!): DeletePayload!
-  "Deletes an organization invite."   organizationInviteDelete(id: String!): DeletePayload!
+  "Retires a project label. Retired labels remain on existing projects but cannot be applied to new ones."   projectLabelRetire(id: String!): ProjectLabelPayload!
+  "Restores a previously retired project label, making it available for use on new projects."   projectLabelRestore(id: String!): ProjectLabelPayload!
+  "Updates the user's workspace settings. Different settings require different permission levels; most require the workspaceSettings admin permission."   organizationUpdate(input: OrganizationUpdateInput!): OrganizationPayload!
+  "Requests a deletion confirmation code for the workspace. The code is sent to the requesting user's email and must be used with the organizationDelete mutation to confirm deletion."   organizationDeleteChallenge: OrganizationDeletePayload!
+  "Permanently deletes the workspace and all its data. Requires a valid deletion code obtained from organizationDeleteChallenge. This action is irreversible."   organizationDelete(input: DeleteOrganizationInput!): OrganizationDeletePayload!
+  "Cancels a previously requested workspace deletion, if the workspace has not yet been fully deleted."   organizationCancelDelete: OrganizationCancelDeletePayload!
+  "Starts a trial for the workspace on the specified plan type. The workspace must not already be on a paid plan or in an active trial."   organizationStartTrialForPlan(input: OrganizationStartTrialInput!): OrganizationStartTrialPayload!
+  "[DEPRECATED] Starts a trial for the workspace."   organizationStartTrial: OrganizationStartTrialPayload! @deprecated(reason: "Use organizationStartTrialForPlan")
+  "Creates a new workspace invite and sends an invitation email to the specified address. The invite includes a role assignment and optional team memberships."   organizationInviteCreate(input: OrganizationInviteCreateInput!): OrganizationInvitePayload!
+  "Updates an existing workspace invite, such as changing the teams the invitee will be added to."   organizationInviteUpdate(input: OrganizationInviteUpdateInput!, id: String!): OrganizationInvitePayload!
+  "Re-sends a workspace invitation email for the specified invite ID."   resendOrganizationInvite(id: String!): DeletePayload!
+  "Re-sends a workspace invitation email to the specified email address, if an outstanding invite exists for that address."   resendOrganizationInviteByEmail(email: String!): DeletePayload!
+  "Deletes (archives) a workspace invite, preventing it from being accepted."   organizationInviteDelete(id: String!): DeletePayload!
   "[INTERNAL] Verifies a domain claim."   organizationDomainClaim(id: String!): OrganizationDomainSimplePayload!
-  "[INTERNAL] Verifies a domain to be added to an organization."   organizationDomainVerify(input: OrganizationDomainVerificationInput!): OrganizationDomainPayload!
-  "[INTERNAL] Adds a domain to be allowed for an organization."   organizationDomainCreate(triggerEmailVerification: Boolean, input: OrganizationDomainCreateInput!): OrganizationDomainPayload!
-  "[INTERNAL] Updates an organization domain settings."   organizationDomainUpdate(input: OrganizationDomainUpdateInput!, id: String!): OrganizationDomainPayload!
+  "[INTERNAL] Verifies a domain to be added to a workspace."   organizationDomainVerify(input: OrganizationDomainVerificationInput!): OrganizationDomainPayload!
+  "[INTERNAL] Adds a domain to be allowed for a workspace."   organizationDomainCreate(triggerEmailVerification: Boolean, input: OrganizationDomainCreateInput!): OrganizationDomainPayload!
+  "[INTERNAL] Updates a workspace domain's settings."   organizationDomainUpdate(input: OrganizationDomainUpdateInput!, id: String!): OrganizationDomainPayload!
   "Deletes a domain."   organizationDomainDelete(id: String!): DeletePayload!
-  "Creates a new notification subscription for a cycle, custom view, label, project or team."   notificationSubscriptionCreate(input: NotificationSubscriptionCreateInput!): NotificationSubscriptionPayload!
+  "Creates a new notification subscription for a specific entity. The subscription determines which notification types the authenticated user will receive for the target entity. Exactly one target entity (customer, custom view, cycle, initiative, label, project, team, or user) must be specified."   notificationSubscriptionCreate(input: NotificationSubscriptionCreateInput!): NotificationSubscriptionPayload!
   "Updates a notification subscription."   notificationSubscriptionUpdate(input: NotificationSubscriptionUpdateInput!, id: String!): NotificationSubscriptionPayload!
   "Deletes a notification subscription reference."   notificationSubscriptionDelete(id: String!): DeletePayload! @deprecated(reason: "Update `notificationSubscription.active` to `false` instead.")
   "Updates a notification."   notificationUpdate(input: NotificationUpdateInput!, id: String!): NotificationPayload!
@@ -7134,9 +7919,9 @@ type Mutation {
   "Archives a notification."   notificationArchive(id: String!): NotificationArchivePayload!
   "Archives a notification and all related notifications."   notificationArchiveAll(input: NotificationEntityInput!): NotificationBatchActionPayload!
   "Unarchives a notification."   notificationUnarchive(id: String!): NotificationArchivePayload!
-  "[ALPHA] Creates a new issueToRelease join, adding an issue to a release."   issueToReleaseCreate(input: IssueToReleaseCreateInput!): IssueToReleasePayload!
-  "[ALPHA] Deletes an issueToRelease by issue and release identifiers"   issueToReleaseDeleteByIssueAndRelease(releaseId: String!, issueId: String!): DeletePayload!
-  "[ALPHA] Deletes an issueToRelease by its identifier, removing an issue from a release."   issueToReleaseDelete(id: String!): DeletePayload!
+  "[ALPHA] Creates a new association between an issue and a release, linking the issue to the release for tracking purposes."   issueToReleaseCreate(input: IssueToReleaseCreateInput!): IssueToReleasePayload!
+  "[ALPHA] Deletes an issue-to-release association by looking up the issue and release identifiers, removing the issue from the release."   issueToReleaseDeleteByIssueAndRelease(releaseId: String!, issueId: String!): DeletePayload!
+  "[ALPHA] Deletes an issue-to-release association by its identifier, removing the issue from the release."   issueToReleaseDelete(id: String!): DeletePayload!
   "Creates a new issue."   issueCreate(input: IssueCreateInput!): IssuePayload!
   "Creates a list of issues in one transaction."   issueBatchCreate(input: IssueBatchCreateInput!): IssueBatchPayload!
   "Updates an issue."   issueUpdate(input: IssueUpdateInput!, id: String!): IssuePayload!
@@ -7157,8 +7942,8 @@ type Mutation {
   "Creates a new label."   issueLabelCreate(replaceTeamLabels: Boolean, input: IssueLabelCreateInput!): IssueLabelPayload!
   "Updates a label."   issueLabelUpdate(replaceTeamLabels: Boolean, input: IssueLabelUpdateInput!, id: String!): IssueLabelPayload!
   "Deletes an issue label."   issueLabelDelete(id: String!): DeletePayload!
-  "Retires a label."   issueLabelRetire(id: String!): IssueLabelPayload!
-  "Restores a label."   issueLabelRestore(id: String!): IssueLabelPayload!
+  "Retires a label. Retired labels are still visible but cannot be applied to new issues. Existing issues with the label are not affected."   issueLabelRetire(id: String!): IssueLabelPayload!
+  "Restores a previously retired label, making it available for use again."   issueLabelRestore(id: String!): IssueLabelPayload!
   "Kicks off a GitHub import job."   issueImportCreateGithub(teamId: String, teamName: String, githubRepoIds: [Int!], githubLabels: [String!], instantProcess: Boolean, includeClosedIssues: Boolean): IssueImportPayload!
   "Kicks off a Jira import job."   issueImportCreateJira(teamId: String, teamName: String, jiraToken: String!, jiraProject: String!, jiraEmail: String!, jiraHostname: String!, jql: String, instantProcess: Boolean, includeClosedIssues: Boolean, id: String): IssueImportPayload!
   "Kicks off a Jira import job from a CSV."   issueImportCreateCSVJira(teamId: String, teamName: String, csvUrl: String!, jiraHostname: String, jiraToken: String, jiraEmail: String): IssueImportPayload!
@@ -7168,36 +7953,99 @@ type Mutation {
   "Deletes an import job."   issueImportDelete(issueImportId: String!): IssueImportDeletePayload!
   "Kicks off import processing."   issueImportProcess(mapping: JSONObject!, issueImportId: String!): IssueImportPayload!
   "Updates the mapping for the issue import."   issueImportUpdate(input: IssueImportUpdateInput!, id: String!): IssueImportPayload!
-  "Creates new settings for one or more integrations."   integrationsSettingsCreate(input: IntegrationsSettingsCreateInput!): IntegrationsSettingsPayload!
-  "Updates settings related to integrations for a project or a team."   integrationsSettingsUpdate(input: IntegrationsSettingsUpdateInput!, id: String!): IntegrationsSettingsPayload!
-  "Creates a new integrationTemplate join."   integrationTemplateCreate(input: IntegrationTemplateCreateInput!): IntegrationTemplatePayload!
-  "Deletes a integrationTemplate."   integrationTemplateDelete(id: String!): DeletePayload!
+  "Creates new Slack notification settings for a team, project, initiative, or custom view."   integrationsSettingsCreate(input: IntegrationsSettingsCreateInput!): IntegrationsSettingsPayload!
+  "Updates Slack notification settings for a team, project, initiative, or custom view."   integrationsSettingsUpdate(input: IntegrationsSettingsUpdateInput!, id: String!): IntegrationsSettingsPayload!
+  "Creates a new connection between a template and an integration, optionally scoped to a specific external resource such as a Slack channel."   integrationTemplateCreate(input: IntegrationTemplateCreateInput!): IntegrationTemplatePayload!
+  "Deletes an integration template connection, removing the link between a template and an integration."   integrationTemplateDelete(id: String!): DeletePayload!
+  "[INTERNAL] Updates the integration."   integrationUpdate(input: IntegrationUpdateInput!, id: String!): IntegrationPayload!
+  "[INTERNAL] Updates the integration settings."   integrationSettingsUpdate(input: IntegrationSettingsInput!, id: String!): IntegrationPayload! @deprecated(reason: "Use integrationUpdate instead.")
+  "Generates a webhook for the GitHub commit integration."   integrationGithubCommitCreate: GitHubCommitIntegrationPayload!
+  "Connects the workspace with the GitHub App."   integrationGithubConnect(githubHost: String, codeAccess: Boolean = false, code: String!, installationId: String!): IntegrationPayload!
+  "Connects the workspace with the GitHub Import App."   integrationGithubImportConnect(code: String!, installationId: String!): IntegrationPayload!
+  "Refreshes the data for a GitHub import integration."   integrationGithubImportRefresh(id: String!): IntegrationPayload!
+  "Connects the workspace with a GitHub Enterprise Server."   integrationGitHubEnterpriseServerConnect(organizationName: String!, githubUrl: String!): GitHubEnterpriseServerPayload!
+  "Connects the workspace with a GitLab Access Token."   integrationGitlabConnect(gitlabUrl: String!, accessToken: String!): GitLabIntegrationCreatePayload!
+  "Tests connectivity to a self-hosted GitLab instance and clears auth errors if successful."   integrationGitlabTestConnection(integrationId: String!): GitLabTestConnectionPayload!
+  "Creates an integration api key for Airbyte to connect with Linear."   airbyteIntegrationConnect(input: AirbyteConfigurationInput!): IntegrationPayload!
+  "[Internal] Connects the Google Calendar to the user to this Linear account via OAuth2."   integrationGoogleCalendarPersonalConnect(code: String!): IntegrationPayload!
+  "[INTERNAL] Integrates the workspace with LaunchDarkly."   integrationLaunchDarklyConnect(code: String!, projectKey: String!, environment: String!): IntegrationPayload!
+  "[INTERNAL] Integrates your personal account with LaunchDarkly."   integrationLaunchDarklyPersonalConnect(code: String!): IntegrationPayload!
+  "[INTERNAL] Connects the workspace with a Jira Personal Access Token."   jiraIntegrationConnect(input: JiraConfigurationInput!): IntegrationPayload!
+  "[INTERNAL] Updates a Jira Integration."   integrationJiraUpdate(input: JiraUpdateInput!): IntegrationPayload!
+  "[INTERNAL] Fetches Jira project statuses and stores them in integration settings."   integrationJiraFetchProjectStatuses(input: JiraFetchProjectStatusesInput!): JiraFetchProjectStatusesPayload!
+  "Connect your Jira account to Linear."   integrationJiraPersonal(code: String, accessToken: String): IntegrationPayload!
+  "Connect your GitHub account to Linear."   integrationGitHubPersonal(enterpriseUrl: String, codeAccess: Boolean, code: String!): IntegrationPayload!
+  "Integrates the workspace with Intercom."   integrationIntercom(domainUrl: String, redirectUri: String!, code: String!): IntegrationPayload!
+  "Disconnects the workspace from Intercom."   integrationIntercomDelete: IntegrationPayload!
+  "[INTERNAL] Refreshes the customer data attributes from the specified integration service."   integrationCustomerDataAttributesRefresh(input: IntegrationCustomerDataAttributesRefreshInput!): IntegrationPayload!
+  "[DEPRECATED] Updates settings on the Intercom integration."   integrationIntercomSettingsUpdate(input: IntercomSettingsInput!): IntegrationPayload! @deprecated(reason: "This mutation is deprecated, please use `integrationSettingsUpdate` instead")
+  "Integrates the workspace with Discord."   integrationDiscord(redirectUri: String!, code: String!): IntegrationPayload!
+  "[INTERNAL] Integrates the workspace with Opsgenie."   integrationOpsgenieConnect(apiKey: String!): IntegrationPayload!
+  "[INTERNAL] Refresh Opsgenie schedule mappings."   integrationOpsgenieRefreshScheduleMappings: IntegrationPayload!
+  "[INTERNAL] Integrates the workspace with PagerDuty."   integrationPagerDutyConnect(code: String!, redirectUri: String!): IntegrationPayload!
+  "[INTERNAL] Refresh PagerDuty schedule mappings."   integrationPagerDutyRefreshScheduleMappings: IntegrationPayload!
+  "[Internal] Updates existing Slack and Asks integration scopes."   updateIntegrationSlackScopes(integrationId: String!, redirectUri: String!, code: String!): IntegrationPayload!
+  "Integrates the workspace with Slack."   integrationSlack(shouldUseV2Auth: Boolean, redirectUri: String!, code: String!): IntegrationPayload!
+  "Integrates the workspace with the Slack Asks app."   integrationSlackAsks(redirectUri: String!, code: String!): IntegrationPayload!
+  "Updates the Slack team's name in Linear for an existing Slack or Asks integration."   integrationSlackOrAsksUpdateSlackTeamName(integrationId: String!): IntegrationSlackWorkspaceNamePayload!
+  "Integrates your personal notifications with Slack."   integrationSlackPersonal(redirectUri: String!, code: String!): IntegrationPayload!
+  "Connect a Slack channel to Asks."   integrationAsksConnectChannel(redirectUri: String!, code: String!): AsksChannelConnectPayload!
+  "Slack integration for team notifications."   integrationSlackPost(shouldUseV2Auth: Boolean, redirectUri: String!, teamId: String!, code: String!): SlackChannelConnectPayload!
+  "Slack integration for project notifications."   integrationSlackProjectPost(service: String!, redirectUri: String!, projectId: String!, code: String!): SlackChannelConnectPayload!
+  "[Internal] Slack integration for initiative notifications."   integrationSlackInitiativePost(redirectUri: String!, initiativeId: String!, code: String!): SlackChannelConnectPayload!
+  "Slack integration for custom view notifications."   integrationSlackCustomViewNotifications(redirectUri: String!, customViewId: String!, code: String!): SlackChannelConnectPayload!
+  "Integrates a Slack Asks channel with a Customer."   integrationSlackCustomerChannelLink(redirectUri: String!, customerId: String!, code: String!): SuccessPayload!
+  "Slack integration for workspace-level project update notifications."   integrationSlackOrgProjectUpdatesPost(redirectUri: String!, code: String!): SlackChannelConnectPayload!
+  "[Internal] Slack integration for workspace-level initiative update notifications."   integrationSlackOrgInitiativeUpdatesPost(redirectUri: String!, code: String!): SlackChannelConnectPayload!
+  "Imports custom emojis from your Slack workspace."   integrationSlackImportEmojis(redirectUri: String!, code: String!): IntegrationPayload!
+  "Integrates the workspace with Figma."   integrationFigma(redirectUri: String!, code: String!): IntegrationPayload!
+  "Integrates the workspace with Gong."   integrationGong(redirectUri: String!, code: String!): IntegrationPayload!
+  "Integrates the workspace with Microsoft Teams."   integrationMicrosoftTeams(redirectUri: String!, code: String!): IntegrationPayload!
+  "Connects the user's personal Microsoft account to Linear."   integrationMicrosoftPersonalConnect(redirectUri: String!, code: String!): IntegrationPayload!
+  "[Internal] Connect a project to a Microsoft Teams channel. Find-or-update semantics: creates a microsoftTeamsProjectPost integration row if none exists for the project, or overwrites the existing one's team/channel selection. Requires the connecting user to have linked their personal Microsoft account."   integrationMicrosoftTeamsProjectPost(membershipType: String!, channelName: String!, channelId: String!, teamName: String!, teamId: String!, projectId: String!): IntegrationPayload!
+  "Integrates the workspace with Google Sheets."   integrationGoogleSheets(code: String!): IntegrationPayload!
+  "Manually update Google Sheets data."   refreshGoogleSheetsData(type: String, id: String!): IntegrationPayload!
+  "Integrates the workspace with Sentry."   integrationSentryConnect(organizationSlug: String!, code: String!, installationId: String!): IntegrationPayload!
+  "Integrates the workspace with Front."   integrationFront(redirectUri: String!, code: String!): IntegrationPayload!
+  "Integrates the workspace with Zendesk."   integrationZendesk(subdomain: String!, code: String!, scope: String!, redirectUri: String!): IntegrationPayload!
+  "Enables Loom integration for the workspace."   integrationLoom: IntegrationPayload! @deprecated(reason: "Not available.")
+  "Integrates the workspace with Salesforce."   integrationSalesforce(code: String!, subdomain: String!, redirectUri: String!): IntegrationPayload!
+  "[INTERNAL] Refreshes the Salesforce integration metadata."   integrationSalesforceMetadataRefresh(id: String!): IntegrationPayload!
+  "[INTERNAL] Connects the user's personal account with an MCP server."   integrationMcpServerPersonalConnect(customHeaders: [McpServerCustomHeaderInput!], serverUrl: String!): IntegrationPayload!
+  "[INTERNAL] Connects the workspace with an MCP server."   integrationMcpServerConnect(customHeaders: [McpServerCustomHeaderInput!], workflowDefinitionId: String, teamId: String, serverUrl: String!): IntegrationPayload!
+  "Deletes an integration."   integrationDelete(skipInstallationDeletion: Boolean, id: String!): DeletePayload!
+  "Archives an integration."   integrationArchive(id: String!): DeletePayload!
+  "[Internal] Enables Linear Agent Slack workflow access for a Slack or Slack Asks integration."   integrationSlackWorkflowAccessUpdate(enabled: Boolean!, integrationId: String!): IntegrationPayload!
   "Requests a currently unavailable integration."   integrationRequest(input: IntegrationRequestInput!): IntegrationRequestPayload!
-  "Creates a initiative update."   initiativeUpdateCreate(input: InitiativeUpdateCreateInput!): InitiativeUpdatePayload!
-  "Updates an update."   initiativeUpdateUpdate(input: InitiativeUpdateUpdateInput!, id: String!): InitiativeUpdatePayload!
+  "Creates an initiative update."   initiativeUpdateCreate(input: InitiativeUpdateCreateInput!): InitiativeUpdatePayload!
+  "Updates an initiative update."   initiativeUpdateUpdate(input: InitiativeUpdateUpdateInput!, id: String!): InitiativeUpdatePayload!
   "Archives an initiative update."   initiativeUpdateArchive(id: String!): InitiativeUpdateArchivePayload!
   "Create a notification to remind a user about an initiative update."   createInitiativeUpdateReminder(userId: String, initiativeId: String!): InitiativeUpdateReminderPayload!
   "Unarchives an initiative update."   initiativeUpdateUnarchive(id: String!): InitiativeUpdateArchivePayload!
+  "Associates a project with an initiative. A project can only appear once in an initiative hierarchy."   initiativeToProjectCreate(input: InitiativeToProjectCreateInput!): InitiativeToProjectPayload!
+  "Updates an initiative-to-project association, such as its sort order."   initiativeToProjectUpdate(input: InitiativeToProjectUpdateInput!, id: String!): InitiativeToProjectPayload!
+  "Removes a project from an initiative."   initiativeToProjectDelete(id: String!): DeletePayload!
   "Creates a new initiative."   initiativeCreate(input: InitiativeCreateInput!): InitiativePayload!
-  "Updates a initiative."   initiativeUpdate(input: InitiativeUpdateInput!, id: String!): InitiativePayload!
-  "Archives a initiative."   initiativeArchive(id: String!): InitiativeArchivePayload!
-  "Unarchives a initiative."   initiativeUnarchive(id: String!): InitiativeArchivePayload!
+  "Updates an initiative."   initiativeUpdate(input: InitiativeUpdateInput!, id: String!): InitiativePayload!
+  "Archives an initiative."   initiativeArchive(id: String!): InitiativeArchivePayload!
+  "Unarchives an initiative."   initiativeUnarchive(id: String!): InitiativeArchivePayload!
   "Deletes (trashes) an initiative."   initiativeDelete(id: String!): DeletePayload!
-  "Creates a new initiative relation."   initiativeRelationCreate(input: InitiativeRelationCreateInput!): InitiativeRelationPayload!
-  "Updates an initiative relation."   initiativeRelationUpdate(input: InitiativeRelationUpdateInput!, id: String!): DeletePayload!
+  "Creates a new parent-child relation between two initiatives. The relation cannot create cycles or exceed maximum nesting depth."   initiativeRelationCreate(input: InitiativeRelationCreateInput!): InitiativeRelationPayload!
+  "Updates an initiative relation."   initiativeRelationUpdate(input: InitiativeRelationUpdateInput!, id: String!): InitiativeRelationPayload!
   "Deletes an initiative relation."   initiativeRelationDelete(id: String!): DeletePayload!
-  "Creates a Git target branch automation."   gitAutomationTargetBranchCreate(input: GitAutomationTargetBranchCreateInput!): GitAutomationTargetBranchPayload!
-  "Updates an existing Git target branch automation."   gitAutomationTargetBranchUpdate(input: GitAutomationTargetBranchUpdateInput!, id: String!): GitAutomationTargetBranchPayload!
-  "Archives a Git target branch automation."   gitAutomationTargetBranchDelete(id: String!): DeletePayload!
-  "Creates a new automation state."   gitAutomationStateCreate(input: GitAutomationStateCreateInput!): GitAutomationStatePayload!
-  "Updates an existing state."   gitAutomationStateUpdate(input: GitAutomationStateUpdateInput!, id: String!): GitAutomationStatePayload!
-  "Archives an automation state."   gitAutomationStateDelete(id: String!): DeletePayload!
-  "Creates a new favorite (project, cycle etc)."   favoriteCreate(input: FavoriteCreateInput!): FavoritePayload!
-  "Updates a favorite."   favoriteUpdate(input: FavoriteUpdateInput!, id: String!): FavoritePayload!
-  "Deletes a favorite reference."   favoriteDelete(id: String!): DeletePayload!
-  "Creates a new entity link."   entityExternalLinkCreate(input: EntityExternalLinkCreateInput!): EntityExternalLinkPayload!
-  "Updates an entity link."   entityExternalLinkUpdate(input: EntityExternalLinkUpdateInput!, id: String!): EntityExternalLinkPayload!
-  "Deletes an entity link."   entityExternalLinkDelete(id: String!): DeletePayload!
+  "Creates a new Git target branch definition that scopes automation rules to pull requests targeting a specific branch pattern."   gitAutomationTargetBranchCreate(input: GitAutomationTargetBranchCreateInput!): GitAutomationTargetBranchPayload!
+  "Updates an existing Git target branch definition, including its branch pattern and regex flag."   gitAutomationTargetBranchUpdate(input: GitAutomationTargetBranchUpdateInput!, id: String!): GitAutomationTargetBranchPayload!
+  "Deletes a Git target branch definition and its associated automation rules."   gitAutomationTargetBranchDelete(id: String!): DeletePayload!
+  "Creates a new Git automation rule that maps a Git event to a workflow state transition for a team."   gitAutomationStateCreate(input: GitAutomationStateCreateInput!): GitAutomationStatePayload!
+  "Updates an existing Git automation rule, including its workflow state, target branch, and triggering event."   gitAutomationStateUpdate(input: GitAutomationStateUpdateInput!, id: String!): GitAutomationStatePayload!
+  "Deletes a Git automation rule."   gitAutomationStateDelete(id: String!): DeletePayload!
+  "Creates a new favorite for the authenticated user. Exactly one target entity must be specified. If a favorite for the same entity already exists, the existing favorite is returned (upsert behavior)."   favoriteCreate(input: FavoriteCreateInput!): FavoritePayload!
+  "Updates a favorite's position, parent folder, or folder name."   favoriteUpdate(input: FavoriteUpdateInput!, id: String!): FavoritePayload!
+  "Deletes a favorite, removing it from the user's sidebar. This is an idempotent operation -- deleting a non-existent favorite succeeds silently."   favoriteDelete(id: String!): DeletePayload!
+  "Track an anonymous analytics event."   trackAnonymousEvent(input: EventTrackingInput!): EventTrackingPayload!
+  "Creates a new external link on an initiative, project, team, release, or cycle."   entityExternalLinkCreate(input: EntityExternalLinkCreateInput!): EntityExternalLinkPayload!
+  "Updates an existing entity external link's URL, label, or sort order."   entityExternalLinkUpdate(input: EntityExternalLinkUpdateInput!, id: String!): EntityExternalLinkPayload!
+  "Deletes an entity external link."   entityExternalLinkDelete(id: String!): DeletePayload!
   "Creates a custom emoji."   emojiCreate(input: EmojiCreateInput!): EmojiPayload!
   "Deletes an emoji."   emojiDelete(id: String!): DeletePayload!
   "Unsubscribes the user from one type of email."   emailUnsubscribe(input: EmailUnsubscribeInput!): EmailUnsubscribePayload!
@@ -7207,73 +8055,72 @@ type Mutation {
   "Deletes an email intake address object."   emailIntakeAddressDelete(id: String!): DeletePayload!
   "Creates a new document."   documentCreate(input: DocumentCreateInput!): DocumentPayload!
   "Updates a document."   documentUpdate(input: DocumentUpdateInput!, id: String!): DocumentPayload!
-  "Deletes (trashes) a document."   documentDelete(id: String!): DocumentArchivePayload!
-  "Restores a document."   documentUnarchive(id: String!): DocumentArchivePayload!
+  "Deletes (trashes) a document. The document is marked as trashed and archived, but not permanently removed."   documentDelete(id: String!): DocumentArchivePayload!
+  "Restores a previously trashed document by unarchiving it."   documentUnarchive(id: String!): DocumentArchivePayload!
   "Creates a new cycle."   cycleCreate(input: CycleCreateInput!): CyclePayload!
   "Updates a cycle."   cycleUpdate(input: CycleUpdateInput!, id: String!): CyclePayload!
-  "Archives a cycle."   cycleArchive(id: String!): CycleArchivePayload!
+  "Archives a cycle. All issues currently assigned to the cycle are unlinked from it before archiving."   cycleArchive(id: String!): CycleArchivePayload!
   "Shifts all cycles starts and ends by a certain number of days, starting from the provided cycle onwards."   cycleShiftAll(input: CycleShiftAllInput!): CyclePayload!
-  "Shifts all cycles starts and ends by a certain number of days, starting from the provided cycle onwards."   cycleStartUpcomingCycleToday(id: String!): CyclePayload!
+  "Starts the upcoming cycle as of midnight today. Completes the previous cycle if it has not yet ended. Only the next upcoming (not yet started) cycle for the team can be started."   cycleStartUpcomingCycleToday(id: String!): CyclePayload!
   "Creates a new customer tier."   customerTierCreate(input: CustomerTierCreateInput!): CustomerTierPayload!
   "Updates a customer tier."   customerTierUpdate(input: CustomerTierUpdateInput!, id: String!): CustomerTierPayload!
-  "Deletes a customer tier."   customerTierDelete(id: String!): DeletePayload!
+  "Deletes a customer tier. The tier must not be in use by any customers."   customerTierDelete(id: String!): DeletePayload!
   "Creates a new customer status."   customerStatusCreate(input: CustomerStatusCreateInput!): CustomerStatusPayload!
   "Updates a customer status."   customerStatusUpdate(input: CustomerStatusUpdateInput!, id: String!): CustomerStatusPayload!
-  "Deletes a customer status."   customerStatusDelete(id: String!): DeletePayload!
+  "Deletes a customer status. Cannot delete the last remaining status in a workspace, and the status must not be in use by any customers."   customerStatusDelete(id: String!): DeletePayload!
   "Creates a new customer."   customerCreate(input: CustomerCreateInput!): CustomerPayload!
-  "Updates a customer"   customerUpdate(input: CustomerUpdateInput!, id: String!): CustomerPayload!
+  "Updates an existing customer."   customerUpdate(input: CustomerUpdateInput!, id: String!): CustomerPayload!
   "Deletes a customer."   customerDelete(id: String!): DeletePayload!
-  "Merges two customers."   customerMerge(sourceCustomerId: String!, targetCustomerId: String!): CustomerPayload!
-  "Upserts a customer, creating it if it doesn't exists, updating it otherwise. Matches against an existing customer with `id` or `externalId`"   customerUpsert(input: CustomerUpsertInput!): CustomerPayload!
-  "Unsyncs a managed customer from the its current data source. External IDs mapping to the external source will be cleared."   customerUnsync(id: String!): CustomerPayload!
+  "Merges two customers by transferring all needs from the source customer to the target customer. The source customer is archived after the merge. Domains, external IDs, and metadata are combined on the target customer."   customerMerge(sourceCustomerId: String!, targetCustomerId: String!): CustomerPayload!
+  "Upserts a customer, creating it if no match is found, or updating it otherwise. Matches against existing customers using `id`, `externalId`, `slackChannelId`, or `domains`."   customerUpsert(input: CustomerUpsertInput!): CustomerPayload!
+  "Unsyncs a managed customer from its current data source integration. External IDs mapping to the external source will be cleared, and the customer will no longer be updated by the integration."   customerUnsync(id: String!): CustomerPayload!
   "Creates a new customer need."   customerNeedCreate(input: CustomerNeedCreateInput!): CustomerNeedPayload!
-  "Creates a new customer need out of an attachment"   customerNeedCreateFromAttachment(input: CustomerNeedCreateFromAttachmentInput!): CustomerNeedPayload!
-  "Updates a customer need"   customerNeedUpdate(input: CustomerNeedUpdateInput!, id: String!): CustomerNeedUpdatePayload!
+  "Creates a new customer need from an existing issue attachment. If the attachment already has an archived need, it will be unarchived instead of creating a duplicate."   customerNeedCreateFromAttachment(input: CustomerNeedCreateFromAttachmentInput!): CustomerNeedPayload!
+  "Updates an existing customer need. Supports moving the need to a different issue or project, changing priority, updating the body content, and managing the attached source URL."   customerNeedUpdate(clearAttachment: Boolean, input: CustomerNeedUpdateInput!, id: String!): CustomerNeedUpdatePayload!
   "Deletes a customer need."   customerNeedDelete(keepAttachment: Boolean, id: String!): DeletePayload!
   "Archives a customer need."   customerNeedArchive(id: String!): CustomerNeedArchivePayload!
   "Unarchives a customer need."   customerNeedUnarchive(id: String!): CustomerNeedArchivePayload!
   "Creates a new custom view."   customViewCreate(input: CustomViewCreateInput!): CustomViewPayload!
   "Updates a custom view."   customViewUpdate(input: CustomViewUpdateInput!, id: String!): CustomViewPayload!
   "Deletes a custom view."   customViewDelete(id: String!): DeletePayload!
-  "Saves user message."   contactCreate(input: ContactCreateInput!): ContactPayload!
-  "[INTERNAL] Saves sales pricing inquiry to Front."   contactSalesCreate(input: ContactSalesCreateInput!): ContactPayload!
+  "Creates a support contact message from an authenticated user. The message is saved and forwarded to Intercom for support handling."   contactCreate(input: ContactCreateInput!): ContactPayload!
+  "[INTERNAL] Submits a sales pricing inquiry from the website. Small companies (1-19 employees) are routed to Intercom, while larger companies are routed to HubSpot."   contactSalesCreate(input: ContactSalesCreateInput!): ContactPayload!
+  "Creates a new comment."   commentCreate(input: CommentCreateInput!): CommentPayload!
+  "Updates a comment."   commentUpdate(skipEditedAt: Boolean, input: CommentUpdateInput!, id: String!): CommentPayload!
+  "Deletes a comment."   commentDelete(id: String!): DeletePayload!
+  "Resolves a comment thread. Marks the root comment as resolved by the current user."   commentResolve(resolvingCommentId: String, id: String!): CommentPayload!
+  "Unresolves a previously resolved comment thread. Clears the resolved state on the root comment."   commentUnresolve(id: String!): CommentPayload!
   "Finds or creates a new user account by email and sends an email with token."   emailUserAccountAuthChallenge(input: EmailUserAccountAuthChallengeInput!): EmailUserAccountAuthChallengeResponse!
   "Authenticates a user account via email and authentication token."   emailTokenUserAccountAuth(input: TokenUserAccountAuthInput!): AuthResolverResponse!
   "Authenticates a user account via email and authentication token for SAML."   samlTokenUserAccountAuth(input: TokenUserAccountAuthInput!): AuthResolverResponse!
   "Authenticate user account through Google OAuth. This is the 2nd step of OAuth flow."   googleUserAccountAuth(input: GoogleUserAccountAuthInput!): AuthResolverResponse!
   "[INTERNAL] Starts passkey login process."   passkeyLoginStart(authId: String!): PasskeyLoginStartResponse!
   "[INTERNAL] Finish passkey login process."   passkeyLoginFinish(response: JSONObject!, authId: String!): AuthResolverResponse!
-  "Creates an organization from onboarding."   createOrganizationFromOnboarding(sessionId: String, survey: OnboardingCustomerSurvey, input: CreateOrganizationInput!): CreateOrJoinOrganizationResponse!
-  "Join an organization from onboarding."   joinOrganizationFromOnboarding(input: JoinOrganizationInput!): CreateOrJoinOrganizationResponse!
-  "Leave an organization."   leaveOrganization(organizationId: String!): CreateOrJoinOrganizationResponse!
+  "Creates a new workspace from onboarding."   createOrganizationFromOnboarding(sessionId: String, survey: OnboardingCustomerSurvey, input: CreateOrganizationInput!): CreateOrJoinOrganizationResponse!
+  "Join a workspace from onboarding."   joinOrganizationFromOnboarding(input: JoinOrganizationInput!): CreateOrJoinOrganizationResponse!
+  "Leave a workspace."   leaveOrganization(organizationId: String!): CreateOrJoinOrganizationResponse!
   "Logout the client."   logout(reason: String): LogoutResponse!
   "Logout an individual session with its ID."   logoutSession(sessionId: String!): LogoutResponse!
   "Logout all of user's sessions including the active one."   logoutAllSessions(reason: String): LogoutResponse!
   "Logout all of user's sessions excluding the current one."   logoutOtherSessions(reason: String): LogoutResponse!
-  "Creates a new attachment, or updates existing if the same `url` and `issueId` is used."   attachmentCreate(input: AttachmentCreateInput!): AttachmentPayload!
+  "Creates a new attachment, or updates existing if the same `url` and `issueId` is used. To create an integration-aware attachment, use the integration-specific mutations such as `attachmentLinkZendesk`, `attachmentLinkSlack`, or `attachmentLinkURL` instead."   attachmentCreate(input: AttachmentCreateInput!): AttachmentPayload!
   "Updates an existing issue attachment."   attachmentUpdate(input: AttachmentUpdateInput!, id: String!): AttachmentPayload!
-  "Link any url to an issue."   attachmentLinkURL(createAsUser: String, displayIconUrl: String, title: String, url: String!, issueId: String!, id: String): AttachmentPayload!
-  "Link an existing GitLab MR to an issue."   attachmentLinkGitLabMR(createAsUser: String, displayIconUrl: String, title: String, issueId: String!, id: String, url: String!, projectPathWithNamespace: String!, number: Float!): AttachmentPayload!
-  "Link a GitHub issue to a Linear issue."   attachmentLinkGitHubIssue(createAsUser: String, displayIconUrl: String, title: String, issueId: String!, id: String, url: String!): AttachmentPayload!
-  "Link a GitHub pull request to an issue."   attachmentLinkGitHubPR(createAsUser: String, displayIconUrl: String, title: String, issueId: String!, id: String, url: String!, linkKind: GitLinkKind): AttachmentPayload!
-  "Link an existing Zendesk ticket to an issue."   attachmentLinkZendesk(createAsUser: String, displayIconUrl: String, title: String, ticketId: String!, issueId: String!, id: String, url: String): AttachmentPayload!
-  "Link an existing Discord message to an issue."   attachmentLinkDiscord(createAsUser: String, displayIconUrl: String, title: String, issueId: String!, id: String, channelId: String!, messageId: String!, url: String!): AttachmentPayload!
+  "Link any URL to an issue. If the workspace has a matching integration configured and the URL is recognized (e.g., Zendesk, GitHub, Slack), a rich attachment will be created that enables features like automated status updates. Otherwise, a basic attachment is created."   attachmentLinkURL(createAsUser: String, displayIconUrl: String, title: String, url: String!, issueId: String!, id: String): AttachmentPayload!
+  "Link an existing GitLab MR to an issue. This creates a rich attachment using the workspace's GitLab integration, enabling features like automated status syncing."   attachmentLinkGitLabMR(createAsUser: String, displayIconUrl: String, title: String, issueId: String!, id: String, url: String!, projectPathWithNamespace: String!, number: Float!): AttachmentPayload!
+  "Link a GitHub issue to a Linear issue. This creates a rich attachment using the workspace's GitHub integration, enabling features like automated status syncing."   attachmentLinkGitHubIssue(createAsUser: String, displayIconUrl: String, title: String, issueId: String!, id: String, url: String!): AttachmentPayload!
+  "Link a GitHub pull request to an issue. This creates a rich attachment using the workspace's GitHub integration, enabling features like automated status syncing."   attachmentLinkGitHubPR(createAsUser: String, displayIconUrl: String, title: String, issueId: String!, id: String, url: String!, linkKind: GitLinkKind): AttachmentPayload!
+  "Link an existing Zendesk ticket to an issue. This creates a rich attachment using the workspace's Zendesk integration, enabling features like automated ticket reopening when the Linear issue is completed."   attachmentLinkZendesk(createAsUser: String, displayIconUrl: String, title: String, ticketId: String!, issueId: String!, id: String, url: String): AttachmentPayload!
+  "Link an existing Discord message to an issue. This creates a rich attachment using the workspace's Discord integration."   attachmentLinkDiscord(createAsUser: String, displayIconUrl: String, title: String, issueId: String!, id: String, channelId: String!, messageId: String!, url: String!): AttachmentPayload!
   "Begin syncing the thread for an existing Slack message attachment with a comment thread on its issue."   attachmentSyncToSlack(id: String!): AttachmentPayload!
-  "Link an existing Slack message to an issue."   attachmentLinkSlack(createAsUser: String, displayIconUrl: String, title: String, issueId: String!, url: String!, id: String, syncToCommentThread: Boolean): AttachmentPayload!
-  "Link an existing Front conversation to an issue."   attachmentLinkFront(createAsUser: String, displayIconUrl: String, title: String, conversationId: String!, issueId: String!, id: String): FrontAttachmentPayload!
-  "Link an existing Intercom conversation to an issue."   attachmentLinkIntercom(createAsUser: String, displayIconUrl: String, title: String, conversationId: String!, partId: String, id: String, issueId: String!): AttachmentPayload!
-  "Link an existing Jira issue to an issue."   attachmentLinkJiraIssue(createAsUser: String, displayIconUrl: String, title: String, issueId: String!, jiraIssueId: String!, id: String, url: String): AttachmentPayload!
-  "Link an existing Salesforce case to an issue."   attachmentLinkSalesforce(createAsUser: String, displayIconUrl: String, title: String, issueId: String!, id: String, url: String!): AttachmentPayload!
+  "Link an existing Slack message to an issue. This creates a rich attachment using the workspace's Slack integration."   attachmentLinkSlack(createAsUser: String, displayIconUrl: String, title: String, issueId: String!, url: String!, id: String, syncToCommentThread: Boolean): AttachmentPayload!
+  "Link an existing Front conversation to an issue. This creates a rich attachment using the workspace's Front integration, enabling features like automated conversation updates."   attachmentLinkFront(createAsUser: String, displayIconUrl: String, title: String, conversationId: String!, issueId: String!, id: String): FrontAttachmentPayload!
+  "Link an existing Intercom conversation to an issue. This creates a rich attachment using the workspace's Intercom integration, enabling features like automated conversation updates."   attachmentLinkIntercom(createAsUser: String, displayIconUrl: String, title: String, conversationId: String!, partId: String, id: String, issueId: String!): AttachmentPayload!
+  "Link an existing Jira issue to an issue. This creates a rich attachment using the workspace's Jira integration, enabling features like automated status syncing."   attachmentLinkJiraIssue(createAsUser: String, displayIconUrl: String, title: String, issueId: String!, jiraIssueId: String!, id: String, url: String): AttachmentPayload!
+  "Link an existing Salesforce case to an issue. This creates a rich attachment using the workspace's Salesforce integration."   attachmentLinkSalesforce(createAsUser: String, displayIconUrl: String, title: String, issueId: String!, id: String, url: String!): AttachmentPayload!
   "Deletes an issue attachment."   attachmentDelete(id: String!): DeletePayload!
-  "Creates a new Asks web form settings."   asksWebSettingsCreate(emailIntakeAddress: AsksWebSettingsEmailIntakeAddressInput, input: AsksWebSettingsCreateInput!): AsksWebSettingsPayload!
-  "Updates Asks web form settings."   asksWebSettingsUpdate(emailIntakeAddress: AsksWebSettingsEmailIntakeAddressInput, input: AsksWebSettingsUpdateInput!, id: String!): AsksWebSettingsPayload!
-  "Deletes Asks web form settings."   asksWebSettingsDelete(id: String!): DeletePayload!
-  "Creates a new Asks web page."   asksWebPageCreate(input: AsksWebPageCreateInput!): AsksWebPagePayload!
-  "Updates an Asks web page."   asksWebPageUpdate(input: AsksWebPageUpdateInput!, id: String!): AsksWebPagePayload!
-  "Deletes an Asks web page."   asksWebPageDelete(id: String!): DeletePayload!
-  "Creates a new agent session on a rootcomment."   agentSessionCreateOnComment(input: AgentSessionCreateOnComment!): AgentSessionPayload!
+  "Creates a new agent session on a root comment."   agentSessionCreateOnComment(input: AgentSessionCreateOnComment!): AgentSessionPayload!
   "Creates a new agent session on an issue."   agentSessionCreateOnIssue(input: AgentSessionCreateOnIssue!): AgentSessionPayload!
-  "[Internal] Creates a new agent session on behalf of the current user"   agentSessionCreate(input: AgentSessionCreateInput!): AgentSessionPayload!
+  "[Internal] Creates a new agent session on behalf of the current user"   agentSessionCreate(pullRequestId: String, input: AgentSessionCreateInput!): AgentSessionPayload!
   "Updates the externalUrl of an agent session, which is an agent-hosted page associated with this session."   agentSessionUpdateExternalUrl(input: AgentSessionUpdateExternalUrlInput!, id: String!): AgentSessionPayload!
   "Updates an agent session."   agentSessionUpdate(input: AgentSessionUpdateInput!, id: String!): AgentSessionPayload!
   "Creates an agent activity."   agentActivityCreate(input: AgentActivityCreateInput!): AgentActivityPayload!
@@ -7286,13 +8133,13 @@ type Mutation {
   "The archived/unarchived entity. Null if entity was deleted."   entity: Notification
 }
 
-type NotificationBatchActionPayload {
+"Return type for batch notification mutations that operate on multiple notifications at once." type NotificationBatchActionPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "The notifications that were updated."   notifications: [Notification!]!
+  "The notifications that were updated by the batch operation."   notifications: [Notification!]!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"A user's notification category preferences." type NotificationCategoryPreferences {
+"A user's fully resolved notification category preferences. Each category maps to channel preferences indicating whether mobile, desktop, email, and Slack delivery are enabled." type NotificationCategoryPreferences {
   "The preferences for notifications about assignments."   assignments: NotificationChannelPreferences!
   "The preferences for notifications about status changes."   statusChanges: NotificationChannelPreferences!
   "The preferences for notifications about comments and replies."   commentsAndReplies: NotificationChannelPreferences!
@@ -7310,7 +8157,7 @@ type NotificationBatchActionPayload {
   "The preferences for feed summary notifications."   feed: NotificationChannelPreferences!
 }
 
-"A user's notification channel preferences, indicating if a channel is enabled or not" type NotificationChannelPreferences {
+"A user's resolved notification channel preferences, indicating whether each delivery channel (mobile, desktop, email, Slack) is enabled or disabled." type NotificationChannelPreferences {
   "Whether notifications are currently enabled for mobile."   mobile: Boolean!
   "Whether notifications are currently enabled for desktop."   desktop: Boolean!
   "Whether notifications are currently enabled for email."   email: Boolean!
@@ -7323,22 +8170,22 @@ type NotificationConnection {
   pageInfo: PageInfo!
 }
 
-"A user's notification delivery preferences." type NotificationDeliveryPreferences {
+"A user's notification delivery preferences across channels. Currently only supports mobile channel delivery scheduling." type NotificationDeliveryPreferences {
   "The delivery preferences for the mobile channel."   mobile: NotificationDeliveryPreferencesChannel
 }
 
-"A user's notification delivery preferences." type NotificationDeliveryPreferencesChannel {
+"Delivery preferences for a specific notification channel, including an optional delivery schedule that restricts when notifications are sent." type NotificationDeliveryPreferencesChannel {
   "[DEPRECATED] Whether notifications are enabled for this channel. Use notificationChannelPreferences instead."   notificationsDisabled: Boolean @deprecated(reason: "This field has been replaced by notificationChannelPreferences")
   "The schedule for notifications on this channel."   schedule: NotificationDeliveryPreferencesSchedule
 }
 
-"A user's notification delivery schedule for a particular day." type NotificationDeliveryPreferencesDay {
-  "The time notifications start."   start: String
-  "The time notifications end."   end: String
+"A user's notification delivery window for a specific day of the week. Defines the time range during which notifications will be delivered." type NotificationDeliveryPreferencesDay {
+  "The start time of the notification delivery window in HH:MM military time format (e.g., '09:00'). Must be earlier than 'end'."   start: String
+  "The end time of the notification delivery window in HH:MM military time format (e.g., '18:00'). Must be later than 'start'."   end: String
 }
 
-"A user's notification delivery schedule for a particular day." type NotificationDeliveryPreferencesSchedule {
-  "Whether the schedule is disabled."   disabled: Boolean
+"A user's weekly notification delivery schedule, defining delivery windows for each day of the week. Notifications outside these windows are held and delivered when the window opens." type NotificationDeliveryPreferencesSchedule {
+  "Whether the entire delivery schedule is disabled. When true, notifications are delivered at any time regardless of the per-day settings."   disabled: Boolean
   "Delivery preferences for Sunday."   sunday: NotificationDeliveryPreferencesDay!
   "Delivery preferences for Monday."   monday: NotificationDeliveryPreferencesDay!
   "Delivery preferences for Tuesday."   tuesday: NotificationDeliveryPreferencesDay!
@@ -7353,9 +8200,9 @@ type NotificationEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type NotificationPayload {
+"Return type for notification mutations." type NotificationPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "The notification that was created or updated."   notification: Notification!
+  "The notification that was updated."   notification: Notification!
   "Whether the operation was successful."   success: Boolean!
 }
 
@@ -7370,46 +8217,44 @@ type NotificationSubscriptionEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type NotificationSubscriptionPayload {
+"The result of a notification subscription mutation." type NotificationSubscriptionPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "The notification subscription that was created or updated."   notificationSubscription: NotificationSubscription!
+  "The notification subscription that was created or updated. This controls which notifications the user receives for the associated entity."   notificationSubscription: NotificationSubscription!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"Request to install OAuth clients on organizations and the response to the request." type OauthClientApproval implements Node {
+"A request to install an OAuth client application on a workspace, along with the admin's approval or denial response. When a user attempts to install an OAuth application that requires admin approval, an approval record is created. A workspace admin can then approve or deny the request, optionally providing a reason. The record also tracks any newly requested scopes that were added after the initial approval." type OauthClientApproval implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The uuid of the OAuth client being requested for installation."   oauthClientId: String!
-  "The person who requested installing the OAuth client."   requesterId: String!
-  "The person who responded to the request to install the OAuth client."   responderId: String
-  "The status for the OAuth client approval request."   status: OAuthClientApprovalStatus!
-  "The scopes the app has been approved for."   scopes: [String!]!
-  "The reason the person wants to install this OAuth client."   requestReason: String
-  "The reason the request for the OAuth client approval was denied."   denyReason: String
-  "New scopes that were requested for approval after the initial request."   newlyRequestedScopes: [String!]
+  "The identifier of the OAuth client application being requested for installation in this workspace."   oauthClientId: String!
+  "The identifier of the user who initiated the request to install the OAuth client application."   requesterId: String!
+  "The identifier of the workspace admin who approved or denied the installation request. Null if the request has not yet been responded to."   responderId: String
+  "The current status of the approval request: requested (pending admin review), approved, or denied."   status: OAuthClientApprovalStatus!
+  "The OAuth scopes that the application has been approved to use within this workspace (e.g., 'read', 'write', 'issues:create')."   scopes: [String!]!
+  "An optional message from the requester explaining why they want to install the OAuth application."   requestReason: String
+  "An optional explanation from the admin for why the installation request was denied."   denyReason: String
+  "Additional OAuth scopes requested after the initial approval. These scopes are not yet approved and require a separate admin decision. Null if no additional scopes have been requested. These scopes will never overlap with the already-approved scopes."   newlyRequestedScopes: [String!]
 }
 
-"An oauth client approval related notification." type OauthClientApprovalNotification implements Notification & Entity & Node {
+"A notification related to an OAuth client approval request, sent to workspace admins when an application requests access." type OauthClientApprovalNotification implements Notification & Entity & Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "Notification type."   type: String!
-  "The user that caused the notification."   actor: User
-  "The external user that caused the notification."   externalUserActor: ExternalUser
-  "The user that received the notification."   user: User!
-  "The time at when the user marked the notification as read. Null, if the the user hasn't read the notification"   readAt: DateTime
-  """The time at when an email reminder for this notification was sent to the user. Null, if no email
-    reminder has been sent."""
-  emailedAt: DateTime
-  "The time until a notification will be snoozed. After that it will appear in the inbox again."   snoozedUntilAt: DateTime
-  "The time at which a notification was unsnoozed.."   unsnoozedAt: DateTime
+  "Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated."   type: String!
+  "The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event."   actor: User
+  "The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member."   externalUserActor: ExternalUser
+  "The recipient user of this notification."   user: User!
+  "The time at which the user marked the notification as read. Null if the notification is unread."   readAt: DateTime
+  "The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent."   emailedAt: DateTime
+  "The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed."   snoozedUntilAt: DateTime
+  "The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed."   unsnoozedAt: DateTime
   "The category of the notification."   category: NotificationCategory!
   "[Internal] URL to the target of the notification."   url: String!
   "[Internal] Inbox URL for the notification."   inboxUrl: String!
@@ -7429,75 +8274,83 @@ type NotificationSubscriptionPayload {
   "The OAuth client approval request related to the notification."   oauthClientApproval: OauthClientApproval!
 }
 
-"An organization. Organizations are root-level objects that contain user accounts and teams." type Organization implements Node {
+"A workspace (referred to as Organization in the API). Workspaces are the root-level container for all teams, users, projects, issues, and settings. Every user belongs to at least one workspace, and all data is scoped within a workspace boundary." type Organization implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The organization's name."   name: String!
-  "The organization's unique URL key."   urlKey: String!
-  "The organization's logo URL."   logoUrl: String
-  "Rolling 30-day total upload volume for the organization, in megabytes."   periodUploadVolume: Float!
-  "[Internal] Facets associated with the organization."   facets: [Facet!]!
-  "How git branches are formatted. If null, default formatting will be used."   gitBranchFormat: String
-  "Whether the Git integration linkback messages should be sent to private repositories."   gitLinkbackMessagesEnabled: Boolean!
-  "Whether the Git integration linkback messages should be sent to public repositories."   gitPublicLinkbackMessagesEnabled: Boolean!
-  "Whether issue descriptions should be included in Git integration linkback messages."   gitLinkbackDescriptionsEnabled: Boolean!
-  "Whether the organization is using a roadmap."   roadmapEnabled: Boolean!
-  "The n-weekly frequency at which to prompt for project updates. When not set, reminders are off."   projectUpdateReminderFrequencyInWeeks: Float
-  "The day at which to prompt for project updates."   projectUpdateRemindersDay: Day!
-  "The hour at which to prompt for project updates."   projectUpdateRemindersHour: Float!
-  "The n-weekly frequency at which to prompt for initiative updates. When not set, reminders are off."   initiativeUpdateReminderFrequencyInWeeks: Float
-  "The day at which to prompt for initiative updates."   initiativeUpdateRemindersDay: Day!
-  "The hour at which to prompt for initiative updates."   initiativeUpdateRemindersHour: Float!
-  "The month at which the fiscal year starts. Defaults to January (0)."   fiscalYearStartMonth: Float!
+  "The workspace's name."   name: String!
+  "The workspace's unique URL key, used in URLs to identify the workspace."   urlKey: String!
+  "The URL of the workspace's logo image. Null if no logo has been uploaded."   logoUrl: String
+  "Rolling 30-day total file upload volume for the workspace, measured in megabytes. Used for enforcing upload quotas."   periodUploadVolume: Float!
+  "[Internal] Facets associated with the workspace, used for configuring custom views and filters."   facets: [Facet!]!
+  "The template format for Git branch names created from issues. Supports template variables like {issueIdentifier} and {issueTitle}. If null, the default formatting will be used."   gitBranchFormat: String
+  "Whether the Git integration linkback messages should be posted as comments on pull requests in private repositories."   gitLinkbackMessagesEnabled: Boolean!
+  "Whether the Git integration linkback messages should be posted as comments on pull requests in public repositories."   gitPublicLinkbackMessagesEnabled: Boolean!
+  "Whether issue descriptions should be included in the Git integration linkback messages posted to pull requests."   gitLinkbackDescriptionsEnabled: Boolean!
+  "Whether the roadmap feature is enabled for the workspace."   roadmapEnabled: Boolean!
+  "The frequency in weeks at which to prompt for project updates. When null, project update reminders are disabled. Valid values range from 0 to 8."   projectUpdateReminderFrequencyInWeeks: Float
+  "The day of the week on which project update reminders are sent."   projectUpdateRemindersDay: Day!
+  "The hour of the day (0-23) at which project update reminders are sent."   projectUpdateRemindersHour: Float!
+  "The frequency in weeks at which to prompt for initiative updates. When null, initiative update reminders are disabled. Valid values range from 0 to 8."   initiativeUpdateReminderFrequencyInWeeks: Float
+  "The day of the week on which initiative update reminders are sent."   initiativeUpdateRemindersDay: Day!
+  "The hour of the day (0-23) at which initiative update reminders are sent."   initiativeUpdateRemindersHour: Float!
+  "The zero-indexed month at which the fiscal year starts (0 = January, 11 = December). Defaults to 0 (January)."   fiscalYearStartMonth: Float!
   "[Internal] The list of working days. Sunday is 0, Monday is 1, etc."   workingDays: [Float!]!
-  "Whether SAML authentication is enabled for organization."   samlEnabled: Boolean!
+  "Whether SAML-based single sign-on authentication is enabled for the workspace."   samlEnabled: Boolean!
   "[INTERNAL] SAML settings."   samlSettings: JSONObject
-  "Whether SCIM provisioning is enabled for organization."   scimEnabled: Boolean!
+  "Whether SCIM provisioning is enabled for the workspace, allowing automated user and team management from an identity provider."   scimEnabled: Boolean!
   "[INTERNAL] SCIM settings."   scimSettings: JSONObject
-  "Security settings for the organization."   securitySettings: JSONObject!
-  "Allowed authentication providers, empty array means all are allowed."   allowedAuthServices: [String!]!
+  "Security settings for the workspace, including role-based restrictions for invitations, team creation, label management, and other sensitive operations."   securitySettings: JSONObject!
+  "Authentication settings for the workspace, including allowed auth providers, bypass rules, and organization visibility during signup."   authSettings: JSONObject!
+  "Allowed authentication providers, empty array means all are allowed."   allowedAuthServices: [String!]! @deprecated(reason: "Use authSettings.allowedAuthServices instead.")
   "Allowed file upload content types"   allowedFileUploadContentTypes: [String!]
   "IP restriction configurations."   ipRestrictions: [OrganizationIpRestriction!]
-  "The time at which deletion of the organization was requested."   deletionRequestedAt: DateTime
-  "The time at which the trial will end."   trialEndsAt: DateTime
-  "The time at which the trial started."   trialStartsAt: DateTime
-  "Previously used URL keys for the organization (last 3 are kept and redirected)."   previousUrlKeys: [String!]!
-  "Whether HIPAA compliance is enabled for organization."   hipaaComplianceEnabled: Boolean!
-  "[ALPHA] Theme settings for the organization."   themeSettings: JSONObject
-  "The feature release channel the organization belongs to."   releaseChannel: ReleaseChannel!
-  "Configuration settings for the Customers feature."   customersConfiguration: JSONObject!
-  "[INTERNAL] Whether code intelligence is enabled for the organization."   codeIntelligenceEnabled: Boolean!
+  "The time at which deletion of the workspace was requested. Null if no deletion has been requested."   deletionRequestedAt: DateTime
+  "The time at which the current plan trial will end. Null if the workspace is not in a trial period."   trialEndsAt: DateTime
+  "The time at which the current plan trial started. Null if the workspace is not in a trial period."   trialStartsAt: DateTime
+  "Previously used URL keys for the workspace. The last 3 are kept and automatically redirected to the current URL key."   previousUrlKeys: [String!]!
+  "[Internal] Whether agent invocation is restricted to full workspace members."   restrictAgentInvocationToMembers: Boolean
+  "Whether HIPAA compliance is enabled for the workspace. When enabled, certain data processing features are restricted to meet compliance requirements."   hipaaComplianceEnabled: Boolean!
+  "[ALPHA] Theme settings for the workspace."   themeSettings: JSONObject
+  "The feature release channel the workspace belongs to, which controls access to pre-release features."   releaseChannel: ReleaseChannel!
+  "Configuration settings for the Customers feature, including revenue currency and other customer tracking preferences."   customersConfiguration: JSONObject!
+  "[INTERNAL] Whether code intelligence is enabled for the workspace."   codeIntelligenceEnabled: Boolean!
   "[INTERNAL] GitHub repository in owner/repo format for code intelligence."   codeIntelligenceRepository: String
   "Default schedule for how often feed summaries are generated."   defaultFeedSummarySchedule: FeedSummarySchedule
-  "Whether the organization has enabled the feed feature."   feedEnabled: Boolean!
-  "Whether to hide other organizations for new users signing up with email domains claimed by this organization."   hideNonPrimaryOrganizations: Boolean!
-  "[INTERNAL] Whether the organization has enabled the AI add-on (which at this point only includes triage suggestions)."   aiAddonEnabled: Boolean!
-  "[INTERNAL] Whether the organization has enabled generated updates."   generatedUpdatesEnabled: Boolean!
-  "Whether the organization has enabled resolved thread AI summaries."   aiThreadSummariesEnabled: Boolean!
-  "Whether the organization has enabled AI discussion summaries for issues."   aiDiscussionSummariesEnabled: Boolean!
+  "Whether the activity feed feature is enabled for the workspace."   feedEnabled: Boolean!
+  "Whether to hide other organizations for new users signing up with email domains claimed by this organization."   hideNonPrimaryOrganizations: Boolean! @deprecated(reason: "Use authSettings.hideNonPrimaryOrganizations instead.")
+  "[INTERNAL] Whether the workspace has enabled the AI add-on (which at this point only includes triage suggestions)."   aiAddonEnabled: Boolean!
+  "[INTERNAL] Whether the workspace has enabled agent automation."   agentAutomationEnabled: Boolean!
+  "[INTERNAL] Whether the workspace has enabled generated updates."   generatedUpdatesEnabled: Boolean!
+  "Whether the workspace has enabled resolved thread AI summaries."   aiThreadSummariesEnabled: Boolean!
+  "Whether the workspace has enabled AI discussion summaries for issues."   aiDiscussionSummariesEnabled: Boolean!
   "[INTERNAL] Configure per-modality AI host providers and model families."   aiProviderConfiguration: JSONObject
-  "[Internal] Whether the organization has enabled Linear Agent."   linearAgentEnabled: Boolean!
+  "[Internal] Whether the workspace has enabled Linear Agent."   linearAgentEnabled: Boolean!
+  "[Internal] Settings for Linear Agent features."   linearAgentSettings: JSONObject!
+  "[INTERNAL] Whether the workspace has enabled the Coding Agent."   codingAgentEnabled: Boolean!
   "[DEPRECATED] Which day count to use for SLA calculations."   slaDayCount: SLADayCountType! @deprecated(reason: "No longer in use")
   "[DEPRECATED] The frequency at which to prompt for project updates."   projectUpdatesReminderFrequency: ProjectUpdateReminderFrequency! @deprecated(reason: "Use organization.projectUpdatesReminderFrequencyInWeeks instead")
   "[INTERNAL] Permitted AI providers."   allowedAiProviders: [String!]! @deprecated(reason: "Use aiProviderConfiguration instead.")
-  "Users associated with the organization."   users(includeDisabled: Boolean, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): UserConnection!
-  "Teams associated with the organization."   teams(filter: TeamFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TeamConnection!
-  "The organization's project statuses."   projectStatuses: [ProjectStatus!]!
-  "Integrations associated with the organization."   integrations(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IntegrationConnection!
+  "Users belonging to the workspace. By default only returns active users; use the includeDisabled argument to include deactivated users."   users(includeDisabled: Boolean, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): UserConnection!
+  "Teams in the workspace. Returns only teams visible to the requesting user (all public teams plus private teams the user is a member of)."   teams(filter: TeamFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TeamConnection!
+  "The workspace's available project statuses, which define the lifecycle stages for projects."   projectStatuses: [ProjectStatus!]!
+  "Third-party integrations configured for the workspace (e.g., GitHub, Slack, Figma)."   integrations(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IntegrationConnection!
   "The Slack integration used for auto-creating project channels."   slackProjectChannelIntegration: Integration
   "The prefix used for auto-created Slack project channels."   slackProjectChannelPrefix: String!
-  "The organization's subscription to a paid plan."   subscription: PaidSubscription
-  "Number of active users in the organization."   userCount: Int!
-  "Aproximate number of issues in the organization, including archived ones."   createdIssueCount: Int!
-  "Templates associated with the organization."   templates(filter: NullableTemplateFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TemplateConnection!
-  "Labels associated with the organization."   labels(filter: IssueLabelFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueLabelConnection!
-  "Project labels associated with the organization."   projectLabels(filter: ProjectLabelFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ProjectLabelConnection!
-  "Number of customers in the organization."   customerCount: Int!
-  "Whether the organization is using Customers."   customersEnabled: Boolean!
+  "[Internal] Whether the Slack project channels feature is enabled for the workspace."   slackProjectChannelsEnabled: Boolean!
+  "[Internal] Whether to automatically create a Slack channel when a new project is created."   slackAutoCreateProjectChannel: Boolean!
+  "The workspace's subscription to a paid plan."   subscription: PaidSubscription
+  "The number of active (non-deactivated) users in the workspace."   userCount: Int!
+  "Approximate total number of issues created in the workspace, including archived ones. This count is cached and may not reflect the exact real-time count."   createdIssueCount: Int!
+  "Workspace-level templates (not associated with any specific team). These templates are available across all teams in the workspace."   templates(filter: NullableTemplateFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TemplateConnection!
+  "Workspace-level issue labels (not associated with any specific team). These labels are available across all teams in the workspace."   labels(filter: IssueLabelFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueLabelConnection!
+  "Project labels available in the workspace for categorizing projects."   projectLabels(filter: ProjectLabelFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ProjectLabelConnection!
+  "The number of active (non-archived) customers tracked in the workspace."   customerCount: Int!
+  "Whether the Customers feature is enabled and accessible for the workspace based on the current plan."   customersEnabled: Boolean!
+  "[Internal] Whether release management is enabled for the workspace."   releasesEnabled: Boolean!
   "[DEPRECATED] Whether member users are allowed to send invites."   allowMembersToInvite: Boolean @deprecated(reason: "Use `securitySettings.invitationsRole` instead.")
   "[DEPRECATED] Whether team creation is restricted to admins."   restrictTeamCreationToAdmins: Boolean @deprecated(reason: "Use `securitySettings.teamCreationRole` instead.")
   "[DEPRECATED] Whether workspace label creation, update, and deletion is restricted to admins."   restrictLabelManagementToAdmins: Boolean @deprecated(reason: "Use `securitySettings.labelManagementRole` instead.")
@@ -7507,15 +8360,15 @@ type OrganizationAcceptedOrExpiredInviteDetailsPayload {
   "The status of the invite."   status: OrganizationInviteStatus!
 }
 
-type OrganizationCancelDeletePayload {
+"Workspace deletion cancellation response." type OrganizationCancelDeletePayload {
   "Whether the operation was successful."   success: Boolean!
 }
 
-type OrganizationDeletePayload {
+"Workspace deletion operation response." type OrganizationDeletePayload {
   "Whether the operation was successful."   success: Boolean!
 }
 
-"Defines the use of a domain by an organization." type OrganizationDomain implements Node {
+"A verified email domain associated with a workspace. Domains are used for automatic team joining, SSO/SAML authentication, and controlling workspace access. Each domain has an authentication type (general or SAML) and can be verified via email or DNS." type OrganizationDomain implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -7523,13 +8376,13 @@ type OrganizationDeletePayload {
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The identity provider the domain belongs to."   identityProvider: IdentityProvider
-  "Domain name."   name: String!
-  "Is this domain verified."   verified: Boolean!
-  "E-mail used to verify this domain."   verificationEmail: String
+  "The domain name (e.g., 'example.com')."   name: String!
+  "Whether the domain has been verified via email verification."   verified: Boolean!
+  "The email address used to verify this domain. Null if the domain was verified via DNS or has not been verified."   verificationEmail: String
   "The user who added the domain."   creator: User
-  "What type of auth is the domain used for."   authType: OrganizationDomainAuthType!
-  "Whether the domains was claimed by the organization through DNS verification."   claimed: Boolean
-  "Prevent users with this domain to create new workspaces."   disableOrganizationCreation: Boolean
+  "The authentication type this domain is used for. 'general' means standard email-based auth, 'saml' means SAML SSO authentication."   authType: OrganizationDomainAuthType!
+  "Whether the domain was claimed by the workspace through DNS TXT record verification. Claimed domains provide stronger ownership proof than email verification and enable additional features like preventing users from creating new workspaces."   claimed: Boolean
+  "Whether users with email addresses from this domain are prevented from creating new workspaces. Can only be set on claimed domains."   disableOrganizationCreation: Boolean
 }
 
 "[INTERNAL] Domain claim request response." type OrganizationDomainClaimPayload {
@@ -7538,7 +8391,7 @@ type OrganizationDeletePayload {
 
 "[INTERNAL] Organization domain operation response." type OrganizationDomainPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "The organization domain that was created or updated."   organizationDomain: OrganizationDomain!
+  "The workspace domain that was created or updated."   organizationDomain: OrganizationDomain!
   "Whether the operation was successful."   success: Boolean!
 }
 
@@ -7546,27 +8399,27 @@ type OrganizationDeletePayload {
   "Whether the operation was successful."   success: Boolean!
 }
 
-type OrganizationExistsPayload {
+"Response for checking whether a workspace exists." type OrganizationExistsPayload {
   "Whether the operation was successful."   success: Boolean!
   "Whether the organization exists."   exists: Boolean!
 }
 
-"An invitation to the organization that has been sent via email." type OrganizationInvite implements Node {
+"A pending invitation to join the workspace, sent via email. Invites specify the role the invitee will receive and can optionally include team assignments. Invites can expire and must be accepted by the invitee to grant workspace access." type OrganizationInvite implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The invitees email address."   email: String!
-  "The user role that the invitee will receive upon accepting the invite."   role: UserRoleType!
-  "The invite was sent to external address."   external: Boolean!
-  "The time at which the invite was accepted. Null, if the invite hasn't been accepted."   acceptedAt: DateTime
-  "The time at which the invite will be expiring. Null, if the invite shouldn't expire."   expiresAt: DateTime
-  "Extra metadata associated with the organization invite."   metadata: JSONObject
+  "The email address of the person being invited to the workspace."   email: String!
+  "The workspace role (admin, member, guest, or owner) that the invitee will receive upon accepting the invite."   role: UserRoleType!
+  "Whether the invite was sent to an email address outside the workspace's verified domains."   external: Boolean!
+  "The time at which the invite was accepted by the invitee. Null if the invite is still pending."   acceptedAt: DateTime
+  "The time at which the invite will expire and can no longer be accepted. Null if the invite does not have an expiration date."   expiresAt: DateTime
+  "Extra metadata associated with the invite."   metadata: JSONObject
   "The user who created the invitation."   inviter: User!
   "The user who has accepted the invite. Null, if the invite hasn't been accepted."   invitee: User
-  "The organization that the invite is associated with."   organization: Organization!
+  "The workspace that the invite is associated with."   organization: Organization!
 }
 
 type OrganizationInviteConnection {
@@ -7594,31 +8447,31 @@ type OrganizationInviteFullDetailsPayload {
   "Allowed authentication providers, empty array means all are allowed."   allowedAuthServices: [String!]!
 }
 
-type OrganizationInvitePayload {
+"Workspace invite operation response." type OrganizationInvitePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The organization invite that was created or updated."   organizationInvite: OrganizationInvite!
   "Whether the operation was successful."   success: Boolean!
 }
 
-type OrganizationIpRestriction {
+"[INTERNAL] IP restriction rule for a workspace, defining allowed or blocked IP ranges." type OrganizationIpRestriction {
   "IP range in CIDR format."   range: String!
   "Restriction type."   type: String!
   "Optional restriction description."   description: String
   "Whether the restriction is enabled."   enabled: Boolean!
 }
 
-type OrganizationMeta {
-  "The region the organization is hosted in."   region: String!
+"[INTERNAL] Workspace metadata including region and allowed authentication providers." type OrganizationMeta {
+  "The region the workspace is hosted in."   region: String!
   "Allowed authentication providers, empty array means all are allowed."   allowedAuthServices: [String!]!
 }
 
-type OrganizationPayload {
+"Workspace update operation response." type OrganizationPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "The organization that was created or updated."   organization: Organization
+  "The workspace that was created or updated."   organization: Organization
   "Whether the operation was successful."   success: Boolean!
 }
 
-type OrganizationStartTrialPayload {
+"Workspace trial start response." type OrganizationStartTrialPayload {
   "Whether the operation was successful."   success: Boolean!
 }
 
@@ -7629,60 +8482,56 @@ type PageInfo {
   "Cursor representing the last result in the paginated results."   endCursor: String
 }
 
-"The paid subscription of an organization." type PaidSubscription implements Node {
+"The billing subscription of a workspace. Represents an active paid plan (e.g., Basic, Business, Enterprise) backed by a Stripe subscription. If a workspace has no Subscription record, it is on the free plan. Only one active subscription per workspace is expected." type PaidSubscription implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The subscription type."   type: String!
-  "The number of seats in the subscription."   seats: Float!
-  "The minimum number of seats that will be billed in the subscription."   seatsMinimum: Float
-  "The maximum number of seats that will be billed in the subscription."   seatsMaximum: Float
-  "The creator of the subscription."   creator: User
-  "The organization that the subscription is associated with."   organization: Organization!
-  "The collection method for this subscription, either automatically charged or invoiced."   collectionMethod: String!
-  "The date the subscription was canceled, if any."   canceledAt: DateTime
-  "The date the subscription is scheduled to be canceled, if any."   cancelAt: DateTime
-  "The subscription type of a pending change. Null if no change pending."   pendingChangeType: String
-  "The date the subscription will be billed next."   nextBillingAt: DateTime
+  "The subscription plan type (e.g., basic, business, enterprise). Determines the feature set and pricing tier for the workspace."   type: String!
+  "The number of seats (active members) in the subscription. This is the raw count before applying minimum and maximum seat limits."   seats: Float!
+  "The minimum number of seats that will be billed in the subscription. The billed seat count will never go below this value even if actual member count is lower. Null if no minimum is enforced."   seatsMinimum: Float
+  "The maximum number of seats that will be billed in the subscription. The billed seat count will never exceed this value even if actual member count is higher. Null if no maximum is enforced."   seatsMaximum: Float
+  "The user who initially created (purchased) the subscription. Null if the creator has been removed from the workspace."   creator: User
+  "The workspace that the subscription is associated with."   organization: Organization!
+  "The billing collection method for this subscription. 'automatic' means the payment method on file is charged automatically. 'send_invoice' means invoices are sent to the billing email for manual payment."   collectionMethod: String!
+  "The date the subscription was canceled. Null if the subscription has not been canceled."   canceledAt: DateTime
+  "The date the subscription is scheduled to be canceled in the future. Null if no cancellation is scheduled. The subscription remains active until this date."   cancelAt: DateTime
+  "The subscription plan type that the workspace is scheduled to change to at the next billing cycle. Null if no plan change is pending."   pendingChangeType: String
+  "The date the subscription will be billed next. Null if the subscription is canceled or has no upcoming billing date."   nextBillingAt: DateTime
 }
 
 type PasskeyLoginStartResponse {
-  success: Boolean!
-  options: JSONObject!
+  "Whether the operation was successful."   success: Boolean!
+  "The passkey authentication options to pass to the WebAuthn API."   options: JSONObject!
 }
 
-"[Internal] A generic post." type Post implements Node {
+"[Internal] A post or announcement in a team or user feed. Posts can be manually authored by users or AI-generated summaries of team activity. They support rich text content (ProseMirror), emoji reactions, threaded comments, and audio summaries. Posts are associated with either a team or a user, but not both." type Post implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The update content in markdown format."   body: String!
-  "[Internal] The content of the post as a Prosemirror document."   bodyData: String!
-  "[Internal] The written update data used to compose the written post."   writtenSummaryData: JSONObject
-  "The update content summarized for audio consumption."   audioSummary: String
-  "The post's title."   title: String
-  "The post's unique URL slug."   slugId: String!
-  "The user who wrote the post."   creator: User
-  "The time the post was edited."   editedAt: DateTime
-  "Emoji reaction summary, grouped by emoji type."   reactionData: JSONObject!
-  "A URL of the TTL (text-to-language) for the body."   ttlUrl: String
-  "The user that the post is associated with."   user: User
-  "The team that the post is associated with."   team: Team
-  "The type of the post."   type: PostType
-  "The log id of the ai response."   evalLogId: String
-  "Schedule used to create a post summary."   feedSummaryScheduleAtCreate: FeedSummarySchedule
-  "Reactions associated with the post."   reactions: [Reaction!]!
-  "Comments associated with the post."   comments(filter: CommentFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CommentConnection!
-  "A URL to the generated audio for the Post."   audioSummaryUrl: String
-  "Number of comments associated with the post."   commentCount: Int!
-}
-
-"A post related notification." type PostNotification implements Notification & Entity & Node {
+  "The post content in markdown format."   body: String!
+  "[Internal] The content of the post as a ProseMirror document. This is the canonical rich-text representation of the post body."   bodyData: String!
+  "[Internal] The structured data used to compose an AI-generated written summary post, including section content and source references."   writtenSummaryData: JSONObject
+  "The post content summarized for audio text-to-speech consumption. Null if no audio summary has been generated."   audioSummary: String
+  "The post's title. Null or empty for posts that do not have a title."   title: String
+  "The post's unique URL slug, used to construct human-readable URLs."   slugId: String!
+  "The user who created the post. Null for system-generated posts."   creator: User
+  "The time the post was last edited. Null if the post has not been edited since creation."   editedAt: DateTime
+  "Emoji reaction summary for this post, grouped by emoji type. Each entry contains the emoji name, count, and the IDs of users who reacted."   reactionData: JSONObject!
+  "A URL of the text-to-speech audio rendering of the post body. Null if no audio has been generated."   ttlUrl: String
+  "The user that the post is scoped to, for user-level feed posts. Null for team-scoped posts."   user: User
+  "The team that the post is scoped to, for team-level feed posts. Null for user-scoped posts."   team: Team
+  "The type of the post, such as 'summary' for AI-generated feed summaries. Null for standard user-authored posts."   type: PostType
+  "The evaluation log ID of the AI response that generated this post. Null for non-AI-generated posts."   evalLogId: String
+  "The feed summary schedule cadence that was active when this post was created. Null for non-summary posts."   feedSummaryScheduleAtCreate: FeedSummarySchedule
+}
+
+"A notification related to a post, such as new comments or reactions." type PostNotification implements Notification & Entity & Node {
   "Related comment ID. Null if the notification is not related to a comment."   commentId: String
   "Related parent comment ID. Null if the notification is not related to a comment."   parentCommentId: String
   "Name of the reaction emoji related to the notification."   reactionEmoji: String
@@ -7692,16 +8541,14 @@ type PasskeyLoginStartResponse {
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "Notification type."   type: String!
-  "The user that caused the notification."   actor: User
-  "The external user that caused the notification."   externalUserActor: ExternalUser
-  "The user that received the notification."   user: User!
-  "The time at when the user marked the notification as read. Null, if the the user hasn't read the notification"   readAt: DateTime
-  """The time at when an email reminder for this notification was sent to the user. Null, if no email
-    reminder has been sent."""
-  emailedAt: DateTime
-  "The time until a notification will be snoozed. After that it will appear in the inbox again."   snoozedUntilAt: DateTime
-  "The time at which a notification was unsnoozed.."   unsnoozedAt: DateTime
+  "Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated."   type: String!
+  "The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event."   actor: User
+  "The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member."   externalUserActor: ExternalUser
+  "The recipient user of this notification."   user: User!
+  "The time at which the user marked the notification as read. Null if the notification is unread."   readAt: DateTime
+  "The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent."   emailedAt: DateTime
+  "The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed."   snoozedUntilAt: DateTime
+  "The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed."   unsnoozedAt: DateTime
   "The category of the notification."   category: NotificationCategory!
   "[Internal] URL to the target of the notification."   url: String!
   "[Internal] Inbox URL for the notification."   inboxUrl: String!
@@ -7720,7 +8567,7 @@ type PasskeyLoginStartResponse {
   "Related post ID."   postId: String!
 }
 
-"A project." type Project implements Node {
+"A project is a collection of issues working toward a shared goal. Projects have start and target dates, milestones, status tracking, and progress metrics. They can span multiple teams and be grouped under initiatives." type Project implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -7732,44 +8579,44 @@ type PasskeyLoginStartResponse {
   "The resolution of the reminder frequency."   frequencyResolution: FrequencyResolutionType!
   "The day at which to prompt for updates."   updateRemindersDay: Day
   "The hour at which to prompt for updates."   updateRemindersHour: Float
-  "The project's name."   name: String!
-  "The project's description."   description: String!
-  "The project's unique URL slug."   slugId: String!
-  "The icon of the project."   icon: String
-  "The project's color."   color: String!
-  "The status that the project is associated with."   status: ProjectStatus!
+  "The name of the project."   name: String!
+  "The short description of the project."   description: String!
+  "The project's unique URL slug, used to construct human-readable URLs."   slugId: String!
+  "The icon of the project. Can be an emoji or a decorative icon type."   icon: String
+  "The project's color as a HEX string. Used in the UI to visually identify the project."   color: String!
+  "The current project status. Defines the project's position in its lifecycle (e.g., backlog, planned, started, paused, completed, canceled)."   status: ProjectStatus!
   "The user who created the project."   creator: User
-  "The project lead."   lead: User
-  "[Internal] Facets associated with the project."   facets: [Facet!]!
-  "The time until which project update reminders are paused."   projectUpdateRemindersPausedUntilAt: DateTime
-  "The estimated start date of the project."   startDate: TimelessDate
-  "The resolution of the project's start date."   startDateResolution: DateResolutionType
-  "The estimated completion date of the project."   targetDate: TimelessDate
-  "The resolution of the project's estimated completion date."   targetDateResolution: DateResolutionType
-  "The time at which the project was moved into started state."   startedAt: DateTime
-  "The time at which the project was moved into completed state."   completedAt: DateTime
-  "The time at which the project was moved into canceled state."   canceledAt: DateTime
-  "The time at which the project was automatically archived by the auto pruning process."   autoArchivedAt: DateTime
+  "The user who leads the project. The project lead is typically responsible for posting status updates and driving the project to completion. Null if no lead is assigned."   lead: User
+  "[Internal] Facets associated with the project, used for filtering and categorization."   facets: [Facet!]!
+  "The time until which project update reminders are paused. When set, no update reminders will be sent for this project until this date passes. Null means reminders are active."   projectUpdateRemindersPausedUntilAt: DateTime
+  "The estimated start date of the project. Null if no start date is set."   startDate: TimelessDate
+  "The resolution of the project's start date, indicating whether it refers to a specific month, quarter, half-year, or year."   startDateResolution: DateResolutionType
+  "The estimated completion date of the project. Null if no target date is set."   targetDate: TimelessDate
+  "The resolution of the project's estimated completion date, indicating whether it refers to a specific month, quarter, half-year, or year."   targetDateResolution: DateResolutionType
+  "The time at which the project was moved into a started status. Null if the project has not been started."   startedAt: DateTime
+  "The time at which the project was moved into a completed status. Null if the project has not been completed."   completedAt: DateTime
+  "The time at which the project was moved into a canceled status. Null if the project has not been canceled."   canceledAt: DateTime
+  "The time at which the project was automatically archived by the auto-pruning process. Null if the project has not been auto-archived."   autoArchivedAt: DateTime
   "A flag that indicates whether the project is in the trash bin."   trashed: Boolean
-  "The sort order for the project within the organization."   sortOrder: Float!
-  "The sort order for the project within the organization, when ordered by priority."   prioritySortOrder: Float!
-  "The project was created based on this issue."   convertedFromIssue: Issue
+  "The sort order for the project within the workspace. Used for manual ordering in list views."   sortOrder: Float!
+  "The sort order for the project within the workspace when ordered by priority."   prioritySortOrder: Float!
+  "The issue that was converted into this project. Null if the project was not created from an issue."   convertedFromIssue: Issue
   "The last template that was applied to this project."   lastAppliedTemplate: Template
-  "The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low."   priority: Int!
-  "The last project update posted for this project."   lastUpdate: ProjectUpdate
-  "The health of the project."   health: ProjectUpdateHealthType
-  "The time at which the project health was updated."   healthUpdatedAt: DateTime
-  "The total number of issues in the project after each week."   issueCountHistory: [Float!]!
-  "The number of completed issues in the project after each week."   completedIssueCountHistory: [Float!]!
-  "The total number of estimation points after each week."   scopeHistory: [Float!]!
-  "The number of completed estimation points after each week."   completedScopeHistory: [Float!]!
-  "The number of in progress estimation points after each week."   inProgressScopeHistory: [Float!]!
-  "[INTERNAL] The progress history of the project."   progressHistory: JSONObject!
-  "[INTERNAL] The current progress of the project."   currentProgress: JSONObject!
+  "The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low."   priority: Int!
+  "The most recent status update posted for this project. Null if no updates have been posted."   lastUpdate: ProjectUpdate
+  "The overall health of the project, derived from the most recent project update. Possible values are onTrack, atRisk, or offTrack. Null if no health has been reported."   health: ProjectUpdateHealthType
+  "The time at which the project health was last updated, typically when a new project update is posted. Null if health has never been set."   healthUpdatedAt: DateTime
+  "The total number of issues in the project at the end of each week since project creation. Each entry represents one week."   issueCountHistory: [Float!]!
+  "The number of completed issues in the project at the end of each week since project creation. Each entry represents one week."   completedIssueCountHistory: [Float!]!
+  "The total scope (estimation points) of the project at the end of each week since project creation. Each entry represents one week."   scopeHistory: [Float!]!
+  "The number of completed estimation points at the end of each week since project creation. Each entry represents one week."   completedScopeHistory: [Float!]!
+  "The number of in-progress estimation points at the end of each week since project creation. Each entry represents one week."   inProgressScopeHistory: [Float!]!
+  "[INTERNAL] The progress history of the project, tracking issue completion over time."   progressHistory: JSONObject!
+  "[INTERNAL] The current progress of the project, broken down by issue status category."   currentProgress: JSONObject!
   "Whether to send new issue notifications to Slack."   slackNewIssue: Boolean! @deprecated(reason: "No longer in use")
   "Whether to send new issue comment notifications to Slack."   slackIssueComments: Boolean! @deprecated(reason: "No longer in use")
   "Whether to send new issue status updates to Slack."   slackIssueStatuses: Boolean! @deprecated(reason: "No longer is use")
-  "Id of the labels associated with this project."   labelIds: [String!]!
+  "The IDs of the project labels associated with this project."   labelIds: [String!]!
   "The user's favorite associated with this project."   favorite: Favorite
   "Project URL."   url: String!
   "Initiatives that this project belongs to."   initiatives(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): InitiativeConnection!
@@ -7796,6 +8643,7 @@ type PasskeyLoginStartResponse {
   "Customer needs associated with the project."   needs(filter: CustomerNeedFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CustomerNeedConnection!
   "[DEPRECATED] The type of the state."   state: String! @deprecated(reason: "Use project.status instead")
   "The priority of the project as a label."   priorityLabel: String!
+  "The external services the project is synced with."   syncedWith: [ExternalEntityInfo!]
 }
 
 "A generic payload return from entity archive mutations." type ProjectArchivePayload implements ArchivePayload {
@@ -7804,7 +8652,7 @@ type PasskeyLoginStartResponse {
   "The archived/unarchived entity. Null if entity was deleted."   entity: Project
 }
 
-"Project attachment" type ProjectAttachment implements Node {
+"An attachment (link, reference, or integration data) associated with a project. Attachments are typically created by integrations and contain metadata for rendering in the client." type ProjectAttachment implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -7812,14 +8660,12 @@ type PasskeyLoginStartResponse {
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "Title of the attachment."   title: String!
-  "Optional subtitle of the attachment"   subtitle: String
+  "Optional subtitle of the attachment, providing additional context below the title."   subtitle: String
   "URL of the attachment."   url: String!
   "The creator of the attachment."   creator: User
-  "Custom metadata related to the attachment."   metadata: JSONObject!
-  "Information about the external source which created the attachment."   source: JSONObject
-  "An accessor helper to source.type, defines the source type of the attachment."   sourceType: String
-  "The project this attachment belongs to."   project: Project!
-  "The body data of the attachment, if any."   bodyData: String
+  "Custom metadata related to the attachment. Contains user-facing content such as conversation messages or rendered attributes from integrations."   metadata: JSONObject!
+  "Metadata about the external source which created the attachment, including foreign identifiers used for syncing with external services. Null if the attachment was not created by an integration."   source: JSONObject
+  "The source type of the attachment, derived from the source metadata. Returns the integration type that created the attachment (e.g., 'slack', 'github'), or null if not set."   sourceType: String
 }
 
 type ProjectAttachmentConnection {
@@ -7844,12 +8690,12 @@ type ProjectEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type ProjectFilterSuggestionPayload {
+"The result of a project filter suggestion query." type ProjectFilterSuggestionPayload {
   "The json filter that is suggested."   filter: JSONObject
   "The log id of the prompt, that created this filter."   logId: String
 }
 
-"An history associated with a project." type ProjectHistory implements Node {
+"A history record associated with a project. Tracks changes to project properties, status, members, teams, milestones, labels, and relationships over time." type ProjectHistory implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -7857,7 +8703,7 @@ type ProjectFilterSuggestionPayload {
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The events that happened while recording that history."   entries: JSONObject!
-  "The project that the history is associated with."   project: Project!
+  "The project that this history record belongs to."   project: Project!
 }
 
 type ProjectHistoryConnection {
@@ -7871,7 +8717,7 @@ type ProjectHistoryEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"Labels that can be associated with projects." type ProjectLabel implements Node {
+"A label that can be applied to projects for categorization. Project labels are workspace-level and can be organized into groups with a parent-child hierarchy. Only child labels (not group labels) can be directly applied to projects." type ProjectLabel implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -7880,14 +8726,14 @@ type ProjectHistoryEdge {
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The label's name."   name: String!
   "The label's description."   description: String
-  "The label's color as a HEX string."   color: String!
-  "Whether the label is a group."   isGroup: Boolean!
-  "The date when the label was last applied to an issue or project."   lastAppliedAt: DateTime
+  "The label's color as a HEX string (e.g., '#EB5757'). Used for visual identification of the label in the UI."   color: String!
+  "Whether the label is a group. When true, this label acts as a container for child labels and cannot be directly applied to issues or projects. When false, the label can be directly applied."   isGroup: Boolean!
+  "The date when the label was last applied to an issue or project. Null if the label has never been applied."   lastAppliedAt: DateTime
   "[Internal] When the label was retired."   retiredAt: DateTime
-  organization: Organization!
+  "The workspace that the project label belongs to."   organization: Organization!
   "The user who created the label."   creator: User
-  "The user who retired the label."   retiredBy: User
-  "The parent label."   parent: ProjectLabel
+  "The user who retired the label. Retired labels cannot be applied to new projects but remain on existing ones. Null if the label is active."   retiredBy: User
+  "The parent label group. If set, this label is a child within a group. Only one child label from each group can be applied to a project at a time."   parent: ProjectLabel
   "Projects associated with the label."   projects(filter: ProjectFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [ProjectSortInput!]): ProjectConnection!
   "Children of the label."   children(filter: ProjectLabelFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ProjectLabelConnection!
 }
@@ -7903,13 +8749,13 @@ type ProjectLabelEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type ProjectLabelPayload {
+"The result of a project label mutation." type ProjectLabelPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The label that was created or updated."   projectLabel: ProjectLabel!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"A milestone for a project." type ProjectMilestone implements Node {
+"A milestone within a project. Milestones break a project into phases or target checkpoints, each with its own target date and set of issues. Issues can be assigned to a milestone to track progress toward that checkpoint." type ProjectMilestone implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -7917,11 +8763,11 @@ type ProjectLabelPayload {
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The name of the project milestone."   name: String!
-  "The content of the project milestone description."   documentContent: DocumentContent
-  "The planned completion date of the milestone."   targetDate: TimelessDate
-  "The project of the milestone."   project: Project!
-  "[Internal] The progress history of the project milestone."   progressHistory: JSONObject!
-  "[Internal] The current progress of the project milestone."   currentProgress: JSONObject!
+  "The rich-text content of the milestone description. Null if no description has been set."   documentContent: DocumentContent
+  "The planned completion date of the milestone. Null if no target date is set."   targetDate: TimelessDate
+  "The project that this milestone belongs to."   project: Project!
+  "[Internal] The progress history of the milestone, tracking issue completion over time."   progressHistory: JSONObject!
+  "[Internal] The current progress of the milestone, broken down by issue status category."   currentProgress: JSONObject!
   "The order of the milestone in relation to other milestones within a project."   sortOrder: Float!
   "The project milestone's description in markdown format."   description: String
   "The status of the project milestone."   status: ProjectMilestoneStatus!
@@ -7946,7 +8792,7 @@ type ProjectMilestoneMoveIssueToTeam {
   "The team id in this relationship"   teamId: String!
 }
 
-type ProjectMilestoneMovePayload {
+"[Internal] The result of a project milestone move mutation." type ProjectMilestoneMovePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The project milestone that was created or updated."   projectMilestone: ProjectMilestone!
   "Whether the operation was successful."   success: Boolean!
@@ -7959,13 +8805,13 @@ type ProjectMilestoneMoveProjectTeams {
   "The team ids for the project"   teamIds: [String!]!
 }
 
-type ProjectMilestonePayload {
+"The result of a project milestone mutation." type ProjectMilestonePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The project milestone that was created or updated."   projectMilestone: ProjectMilestone!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"A project related notification." type ProjectNotification implements Notification & Entity & Node {
+"A notification related to a project, such as being added as a member or lead, project updates, comments, or mentions on the project or its milestones." type ProjectNotification implements Notification & Entity & Node {
   "Related comment ID. Null if the notification is not related to a comment."   commentId: String
   "Related parent comment ID. Null if the notification is not related to a comment."   parentCommentId: String
   "Name of the reaction emoji related to the notification."   reactionEmoji: String
@@ -7975,16 +8821,14 @@ type ProjectMilestonePayload {
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "Notification type."   type: String!
-  "The user that caused the notification."   actor: User
-  "The external user that caused the notification."   externalUserActor: ExternalUser
-  "The user that received the notification."   user: User!
-  "The time at when the user marked the notification as read. Null, if the the user hasn't read the notification"   readAt: DateTime
-  """The time at when an email reminder for this notification was sent to the user. Null, if no email
-    reminder has been sent."""
-  emailedAt: DateTime
-  "The time until a notification will be snoozed. After that it will appear in the inbox again."   snoozedUntilAt: DateTime
-  "The time at which a notification was unsnoozed.."   unsnoozedAt: DateTime
+  "Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated."   type: String!
+  "The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event."   actor: User
+  "The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member."   externalUserActor: ExternalUser
+  "The recipient user of this notification."   user: User!
+  "The time at which the user marked the notification as read. Null if the notification is unread."   readAt: DateTime
+  "The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent."   emailedAt: DateTime
+  "The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed."   snoozedUntilAt: DateTime
+  "The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed."   unsnoozedAt: DateTime
   "The category of the notification."   category: NotificationCategory!
   "[Internal] URL to the target of the notification."   url: String!
   "[Internal] Inbox URL for the notification."   inboxUrl: String!
@@ -8010,49 +8854,49 @@ type ProjectMilestonePayload {
   "The parent comment related to the notification, if a notification is a reply comment notification."   parentComment: Comment
 }
 
-"A project notification subscription." type ProjectNotificationSubscription implements NotificationSubscription & Entity & Node {
+"A notification subscription scoped to a specific project. The subscriber receives notifications for events related to this project, such as updates, comments, and membership changes." type ProjectNotificationSubscription implements NotificationSubscription & Entity & Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The user that subscribed to receive notifications."   subscriber: User!
-  "The customer associated with the notification subscription."   customer: Customer
-  "The contextual custom view associated with the notification subscription."   customView: CustomView
-  "The contextual cycle view associated with the notification subscription."   cycle: Cycle
-  "The contextual label view associated with the notification subscription."   label: IssueLabel
+  "The user who will receive notifications from this subscription."   subscriber: User!
+  "The customer that this notification subscription is scoped to. Null if the subscription targets a different entity type."   customer: Customer
+  "The custom view that this notification subscription is scoped to. Null if the subscription targets a different entity type."   customView: CustomView
+  "The cycle that this notification subscription is scoped to. Null if the subscription targets a different entity type."   cycle: Cycle
+  "The issue label that this notification subscription is scoped to. Null if the subscription targets a different entity type."   label: IssueLabel
   "The project subscribed to."   project: Project!
-  "The contextual initiative view associated with the notification subscription."   initiative: Initiative
-  "The team associated with the notification subscription."   team: Team
-  "The user view associated with the notification subscription."   user: User
-  "The type of view to which the notification subscription context is associated with."   contextViewType: ContextViewType
-  "The type of user view to which the notification subscription context is associated with."   userContextViewType: UserContextViewType
-  "Whether the subscription is active or not."   active: Boolean!
-  "The type of subscription."   notificationSubscriptionTypes: [String!]!
+  "The initiative that this notification subscription is scoped to. Null if the subscription targets a different entity type."   initiative: Initiative
+  "The team that this notification subscription is scoped to. Null if the subscription targets a different entity type."   team: Team
+  "The user that this notification subscription is scoped to, for user-specific view subscriptions. Null if the subscription targets a different entity type."   user: User
+  "The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type."   contextViewType: ContextViewType
+  "The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type."   userContextViewType: UserContextViewType
+  "Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists."   active: Boolean!
+  "The notification event types that this subscription will deliver to the subscriber."   notificationSubscriptionTypes: [String!]!
 }
 
-type ProjectPayload {
+"The result of a project mutation." type ProjectPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The project that was created or updated."   project: Project
   "Whether the operation was successful."   success: Boolean!
 }
 
-"A relation between two projects." type ProjectRelation implements Node {
+"A dependency relation between two projects. Relations can optionally be anchored to specific milestones within each project, allowing fine-grained dependency tracking." type ProjectRelation implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The relationship of the project with the related project."   type: String!
-  "The project whose relationship is being described."   project: Project!
-  "The milestone within the project whose relationship is being described."   projectMilestone: ProjectMilestone
-  "The type of anchor on the project end of the relation."   anchorType: String!
-  "The related project."   relatedProject: Project!
-  "The milestone within the related project whose relationship is being described."   relatedProjectMilestone: ProjectMilestone
-  "The type of anchor on the relatedProject end of the relation."   relatedAnchorType: String!
-  "The last user who created or modified the relation."   user: User
+  "The type of dependency relationship from the project to the related project (e.g., blocks)."   type: String!
+  "The source project in the dependency relation."   project: Project!
+  "The specific milestone within the source project that the relation is anchored to. Null if the relation applies to the project as a whole."   projectMilestone: ProjectMilestone
+  "The type of anchor on the source project end of the relation, indicating whether it is anchored to the project itself or a specific milestone."   anchorType: String!
+  "The target project in the dependency relation."   relatedProject: Project!
+  "The specific milestone within the target project that the relation is anchored to. Null if the relation applies to the target project as a whole."   relatedProjectMilestone: ProjectMilestone
+  "The type of anchor on the target project end of the relation, indicating whether it is anchored to the project itself or a specific milestone."   relatedAnchorType: String!
+  "The user who last created or modified the relation. Null if the user has been deleted."   user: User
 }
 
 type ProjectRelationConnection {
@@ -8066,7 +8910,7 @@ type ProjectRelationEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type ProjectRelationPayload {
+"The result of a project relation mutation." type ProjectRelationPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The project relation that was created or updated."   projectRelation: ProjectRelation!
   "Whether the operation was successful."   success: Boolean!
@@ -8076,8 +8920,8 @@ type ProjectSearchPayload {
   edges: [ProjectSearchResultEdge!]!
   nodes: [ProjectSearchResult!]!
   pageInfo: PageInfo!
-  "Archived entities matching the search term along with all their dependencies."   archivePayload: ArchiveResponse!
-  "Total number of results for query without filters applied."   totalCount: Float!
+  "Archived entities matching the search term along with all their dependencies, serialized for the client sync engine."   archivePayload: ArchiveResponse!
+  "Total number of matching results before pagination is applied."   totalCount: Float!
 }
 
 type ProjectSearchResult implements Node {
@@ -8092,44 +8936,44 @@ type ProjectSearchResult implements Node {
   "The resolution of the reminder frequency."   frequencyResolution: FrequencyResolutionType!
   "The day at which to prompt for updates."   updateRemindersDay: Day
   "The hour at which to prompt for updates."   updateRemindersHour: Float
-  "The project's name."   name: String!
-  "The project's description."   description: String!
-  "The project's unique URL slug."   slugId: String!
-  "The icon of the project."   icon: String
-  "The project's color."   color: String!
-  "The status that the project is associated with."   status: ProjectStatus!
+  "The name of the project."   name: String!
+  "The short description of the project."   description: String!
+  "The project's unique URL slug, used to construct human-readable URLs."   slugId: String!
+  "The icon of the project. Can be an emoji or a decorative icon type."   icon: String
+  "The project's color as a HEX string. Used in the UI to visually identify the project."   color: String!
+  "The current project status. Defines the project's position in its lifecycle (e.g., backlog, planned, started, paused, completed, canceled)."   status: ProjectStatus!
   "The user who created the project."   creator: User
-  "The project lead."   lead: User
-  "[Internal] Facets associated with the project."   facets: [Facet!]!
-  "The time until which project update reminders are paused."   projectUpdateRemindersPausedUntilAt: DateTime
-  "The estimated start date of the project."   startDate: TimelessDate
-  "The resolution of the project's start date."   startDateResolution: DateResolutionType
-  "The estimated completion date of the project."   targetDate: TimelessDate
-  "The resolution of the project's estimated completion date."   targetDateResolution: DateResolutionType
-  "The time at which the project was moved into started state."   startedAt: DateTime
-  "The time at which the project was moved into completed state."   completedAt: DateTime
-  "The time at which the project was moved into canceled state."   canceledAt: DateTime
-  "The time at which the project was automatically archived by the auto pruning process."   autoArchivedAt: DateTime
+  "The user who leads the project. The project lead is typically responsible for posting status updates and driving the project to completion. Null if no lead is assigned."   lead: User
+  "[Internal] Facets associated with the project, used for filtering and categorization."   facets: [Facet!]!
+  "The time until which project update reminders are paused. When set, no update reminders will be sent for this project until this date passes. Null means reminders are active."   projectUpdateRemindersPausedUntilAt: DateTime
+  "The estimated start date of the project. Null if no start date is set."   startDate: TimelessDate
+  "The resolution of the project's start date, indicating whether it refers to a specific month, quarter, half-year, or year."   startDateResolution: DateResolutionType
+  "The estimated completion date of the project. Null if no target date is set."   targetDate: TimelessDate
+  "The resolution of the project's estimated completion date, indicating whether it refers to a specific month, quarter, half-year, or year."   targetDateResolution: DateResolutionType
+  "The time at which the project was moved into a started status. Null if the project has not been started."   startedAt: DateTime
+  "The time at which the project was moved into a completed status. Null if the project has not been completed."   completedAt: DateTime
+  "The time at which the project was moved into a canceled status. Null if the project has not been canceled."   canceledAt: DateTime
+  "The time at which the project was automatically archived by the auto-pruning process. Null if the project has not been auto-archived."   autoArchivedAt: DateTime
   "A flag that indicates whether the project is in the trash bin."   trashed: Boolean
-  "The sort order for the project within the organization."   sortOrder: Float!
-  "The sort order for the project within the organization, when ordered by priority."   prioritySortOrder: Float!
-  "The project was created based on this issue."   convertedFromIssue: Issue
+  "The sort order for the project within the workspace. Used for manual ordering in list views."   sortOrder: Float!
+  "The sort order for the project within the workspace when ordered by priority."   prioritySortOrder: Float!
+  "The issue that was converted into this project. Null if the project was not created from an issue."   convertedFromIssue: Issue
   "The last template that was applied to this project."   lastAppliedTemplate: Template
-  "The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low."   priority: Int!
-  "The last project update posted for this project."   lastUpdate: ProjectUpdate
-  "The health of the project."   health: ProjectUpdateHealthType
-  "The time at which the project health was updated."   healthUpdatedAt: DateTime
-  "The total number of issues in the project after each week."   issueCountHistory: [Float!]!
-  "The number of completed issues in the project after each week."   completedIssueCountHistory: [Float!]!
-  "The total number of estimation points after each week."   scopeHistory: [Float!]!
-  "The number of completed estimation points after each week."   completedScopeHistory: [Float!]!
-  "The number of in progress estimation points after each week."   inProgressScopeHistory: [Float!]!
-  "[INTERNAL] The progress history of the project."   progressHistory: JSONObject!
-  "[INTERNAL] The current progress of the project."   currentProgress: JSONObject!
+  "The priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low."   priority: Int!
+  "The most recent status update posted for this project. Null if no updates have been posted."   lastUpdate: ProjectUpdate
+  "The overall health of the project, derived from the most recent project update. Possible values are onTrack, atRisk, or offTrack. Null if no health has been reported."   health: ProjectUpdateHealthType
+  "The time at which the project health was last updated, typically when a new project update is posted. Null if health has never been set."   healthUpdatedAt: DateTime
+  "The total number of issues in the project at the end of each week since project creation. Each entry represents one week."   issueCountHistory: [Float!]!
+  "The number of completed issues in the project at the end of each week since project creation. Each entry represents one week."   completedIssueCountHistory: [Float!]!
+  "The total scope (estimation points) of the project at the end of each week since project creation. Each entry represents one week."   scopeHistory: [Float!]!
+  "The number of completed estimation points at the end of each week since project creation. Each entry represents one week."   completedScopeHistory: [Float!]!
+  "The number of in-progress estimation points at the end of each week since project creation. Each entry represents one week."   inProgressScopeHistory: [Float!]!
+  "[INTERNAL] The progress history of the project, tracking issue completion over time."   progressHistory: JSONObject!
+  "[INTERNAL] The current progress of the project, broken down by issue status category."   currentProgress: JSONObject!
   "Whether to send new issue notifications to Slack."   slackNewIssue: Boolean! @deprecated(reason: "No longer in use")
   "Whether to send new issue comment notifications to Slack."   slackIssueComments: Boolean! @deprecated(reason: "No longer in use")
   "Whether to send new issue status updates to Slack."   slackIssueStatuses: Boolean! @deprecated(reason: "No longer is use")
-  "Id of the labels associated with this project."   labelIds: [String!]!
+  "The IDs of the project labels associated with this project."   labelIds: [String!]!
   "The user's favorite associated with this project."   favorite: Favorite
   "Project URL."   url: String!
   "Initiatives that this project belongs to."   initiatives(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): InitiativeConnection!
@@ -8156,6 +9000,7 @@ type ProjectSearchResult implements Node {
   "Customer needs associated with the project."   needs(filter: CustomerNeedFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CustomerNeedConnection!
   "[DEPRECATED] The type of the state."   state: String! @deprecated(reason: "Use project.status instead")
   "The priority of the project as a label."   priorityLabel: String!
+  "The external services the project is synced with."   syncedWith: [ExternalEntityInfo!]
   "Metadata related to search result."   metadata: JSONObject!
 }
 
@@ -8164,7 +9009,7 @@ type ProjectSearchResultEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"A project status." type ProjectStatus implements Node {
+"A custom project status within a workspace. Statuses are grouped by type (backlog, planned, started, paused, completed, canceled) and define the lifecycle stages a project can move through. Each workspace can customize the names and colors of its project statuses." type ProjectStatus implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -8172,11 +9017,11 @@ type ProjectSearchResultEdge {
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The name of the status."   name: String!
-  "The UI color of the status as a HEX string."   color: String!
+  "The color of the status as a HEX string, used for display in the UI."   color: String!
   "Description of the status."   description: String
-  "The position of the status in the workspace's project flow."   position: Float!
-  "The type of the project status."   type: ProjectStatusType!
-  "Whether or not a project can be in this status indefinitely."   indefinite: Boolean!
+  "The position of the status within its type group in the workspace's project flow. Used for ordering statuses of the same type."   position: Float!
+  "The category type of the project status (e.g., backlog, planned, started, paused, completed, canceled). Determines the status's behavior and position in the project lifecycle."   type: ProjectStatusType!
+  "Whether a project can remain in this status indefinitely. When false, projects in this status may trigger reminders or auto-archiving after a period of inactivity."   indefinite: Boolean!
 }
 
 "A generic payload return from entity archive mutations." type ProjectStatusArchivePayload implements ArchivePayload {
@@ -8191,7 +9036,7 @@ type ProjectStatusConnection {
   pageInfo: PageInfo!
 }
 
-type ProjectStatusCountPayload {
+"The count of projects using a specific project status." type ProjectStatusCountPayload {
   "Total number of projects using this project status."   count: Float!
   "Total number of projects using this project status that are not visible to the user because they are in a private team."   privateCount: Float!
   "Total number of projects using this project status that are not visible to the user because they are in an archived team."   archivedTeamCount: Float!
@@ -8202,13 +9047,13 @@ type ProjectStatusEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type ProjectStatusPayload {
+"The result of a project status mutation." type ProjectStatusPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The project status that was created or updated."   status: ProjectStatus!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"An update associated with a project." type ProjectUpdate implements Node {
+"A status update posted to a project. Project updates communicate progress, health, and blockers to stakeholders. Each update captures the project's health at the time of writing and includes a rich-text body with the update content." type ProjectUpdate implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -8220,11 +9065,11 @@ type ProjectStatusPayload {
   "Emoji reaction summary, grouped by emoji type."   reactionData: JSONObject!
   "[Internal] The content of the update as a Prosemirror document."   bodyData: String!
   "The update's unique URL slug."   slugId: String!
-  "The project that the update is associated with."   project: Project!
-  "The health of the project at the time of the update."   health: ProjectUpdateHealthType!
+  "The project that this status update was posted to."   project: Project!
+  "The health of the project at the time this update was posted. Possible values are onTrack, atRisk, or offTrack."   health: ProjectUpdateHealthType!
   "The user who wrote the update."   user: User!
-  "[Internal] Serialized JSON representing current state of the project properties when posting the project update."   infoSnapshot: JSONObject
-  "Whether project update diff should be hidden."   isDiffHidden: Boolean!
+  "[Internal] A snapshot of project properties at the time the update was posted, including team, milestone, and issue statistics. Used to compute diffs between consecutive updates."   infoSnapshot: JSONObject
+  "Whether the diff between this update and the previous one should be hidden in the UI."   isDiffHidden: Boolean!
   "The URL to the project update."   url: String!
   "Whether the project update is stale."   isStale: Boolean!
   "The diff between the current update and the previous one."   diff: JSONObject
@@ -8251,99 +9096,88 @@ type ProjectUpdateEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type ProjectUpdatePayload {
+"The result of a project update mutation." type ProjectUpdatePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The project update that was created or updated."   projectUpdate: ProjectUpdate!
   "Whether the operation was successful."   success: Boolean!
 }
 
-type ProjectUpdateReminderPayload {
+"The result of a project update reminder mutation." type ProjectUpdateReminderPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"[Internal] A pull request in a version control system." type PullRequest implements Node {
+"[Internal] A pull or merge request from a connected version control system (GitHub or GitLab). Pull requests are automatically linked to Linear issues via branch names or commit messages containing issue identifiers. They track the full lifecycle including status, reviewers, checks, and merge state, and are synced bidirectionally with the hosting provider." type PullRequest implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The pull request's unique URL slug."   slugId: String!
+  "The pull request's unique URL slug, used to construct human-readable URLs within the Linear app."   slugId: String!
   "The title of the pull request."   title: String!
-  "The number of the pull request in the version control system."   number: Float!
-  "The source branch of the pull request."   sourceBranch: String!
-  "The target branch of the pull request."   targetBranch: String!
-  "The URL of the pull request in the version control system."   url: String!
-  "The status of the pull request."   status: PullRequestStatus!
-  "Merge settings for this pull request."   mergeSettings: PullRequestMergeSettings
-  "The merge commit created when the PR was merged."   mergeCommit: PullRequestCommit
-  "[Internal] The checks associated with the pull request."   checks: [PullRequestCheck!]!
-  "[ALPHA] The commits associated with the pull request."   commits: [PullRequestCommit!]!
-  "[Internal] The user who created the pull request."   creator: User
-  "Agent sessions associated with this pull request."   agentSessions(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): AgentSessionToPullRequestConnection!
-  "Pull request URL to the Linear app"   appUrl: String!
-  "The pull request's description in markdown format."   description: String
-  "The pull request's description as a Prosemirror document."   descriptionData: JSON
-  "Integration type that created this pull request, if applicable."   integrationSourceType: IntegrationService
-  "Diff statistics for the pull request including file count, additions, deletions, and changes."   diffStats: PullRequestDiffStats
-}
-
-"[ALPHA] A pull request check." type PullRequestCheck {
+  "The pull request number as assigned by the hosting provider (e.g., #123 on GitHub). Unique within a repository."   number: Float!
+  "The source (head) branch of the pull request that contains the proposed changes."   sourceBranch: String!
+  "The target (base) branch that the pull request will be merged into."   targetBranch: String!
+  "The Git SHA of the latest commit on the source branch. Updated as new commits are pushed. Null if not yet synced."   headSha: String
+  "The Git SHA of the base commit on the target branch that the pull request is compared against. Null if not yet synced."   baseSha: String
+  "The URL of the pull request on the hosting provider (e.g., a GitHub or GitLab URL)."   url: String!
+  "The current status of the pull request (open, closed, merged, or draft). Synced from the hosting provider."   status: PullRequestStatus!
+  "Merge settings and allowed merge methods for this pull request's repository. Null if the settings have not been synced from the provider."   mergeSettings: PullRequestMergeSettings
+  "The merge commit created when the pull request was merged. Null if the pull request has not been merged or if the merge commit data is not available."   mergeCommit: PullRequestCommit
+  "[Internal] The CI/CD checks and status checks associated with the pull request, synced from the hosting provider."   checks: [PullRequestCheck!]!
+  "[ALPHA] The commits included in the pull request, synced from the hosting provider. Includes metadata such as SHA, message, diff stats, and author information."   commits: [PullRequestCommit!]!
+  "[Internal] The Linear user who created the pull request. Null if the creator is an external user not mapped to a Linear account, or if the creator's account has been deleted."   creator: User
+}
+
+"[ALPHA] A CI/CD check or status check associated with a pull request (e.g., a GitHub Actions workflow run or a required status check)." type PullRequestCheck {
   "The name of the check."   name: String!
-  "The name of the workflow that triggered the check."   workflowName: String
+  "The name of the CI workflow that triggered the check (e.g., 'CI' or 'Build and Test'). Null if the check is not part of a named workflow."   workflowName: String
   "The status of the check."   status: String!
-  "The URL of the check."   url: String
-  "Whether the check is required."   isRequired: Boolean
-  "The date/time at which when the check was started."   startedAt: DateTime
-  "The date/time at which when the check was completed."   completedAt: DateTime
+  "The URL to view the check details on the hosting provider. Null if no URL is available."   url: String
+  "Whether this check is required to pass before the pull request can be merged. Null if the required status is unknown."   isRequired: Boolean
+  "How the check should be opened in the client."   presentation: PullRequestCheckPresentation
+  "The date and time when the check started running. Null if the check has not started yet."   startedAt: DateTime
+  "The date and time when the check finished running. Null if the check has not completed yet."   completedAt: DateTime
 }
 
-"[ALPHA] A pull request commit." type PullRequestCommit {
+"[ALPHA] A Git commit associated with a pull request, including metadata about the commit's content and authors." type PullRequestCommit {
   "The Git commit SHA."   sha: String!
   "The full commit message."   message: String!
-  "The timestamp when the commit was committed (ISO 8601 string)."   committedAt: String!
+  "The timestamp when the commit was committed, as an ISO 8601 string."   committedAt: String!
   "Number of additions in this commit."   additions: Float!
   "Number of deletions in this commit."   deletions: Float!
-  "The number of changed files if available."   changedFiles: Float
+  "The number of files changed in this commit. Null if the hosting provider did not include this information."   changedFiles: Float
+  "Whether this commit is a merge commit (has multiple parents). Merge commits are typically filtered out when counting diff stats."   isMergeCommit: Boolean
   "Linear user IDs for commit authors (includes co-authors)."   authorUserIds: [String!]!
   "External user IDs for commit authors (includes co-authors)."   authorExternalUserIds: [String!]!
 }
 
-"Diff statistics for a pull request." type PullRequestDiffStats {
-  "The number of files changed in the pull request."   fileCount: Float!
-  "The number of lines added in the pull request."   additions: Float!
-  "The number of lines changed in the pull request."   changes: Float!
-  "The number of lines deleted in the pull request."   deletions: Float!
-}
-
-"[Internal] Merge settings for a pull request" type PullRequestMergeSettings {
-  "Whether merge queue is enabled for this repository."   isMergeQueueEnabled: Boolean!
+"[Internal] Merge settings and capabilities for a pull request's repository, including which merge methods are allowed and whether features like merge queues and auto-merge are enabled." type PullRequestMergeSettings {
+  "Whether a merge queue is enabled for pull requests in this repository. When enabled, merges go through an ordered queue rather than being merged directly."   isMergeQueueEnabled: Boolean!
   "Whether squash merge is allowed for this pull request's repository."   squashMergeAllowed: Boolean!
   "Whether auto-merge is allowed for the PR's repository."   autoMergeAllowed: Boolean!
   "Whether rebase merge is allowed for pull requests PR's repository."   rebaseMergeAllowed: Boolean!
   "Whether merge commits are allowed for pull requests PR's repository."   mergeCommitAllowed: Boolean!
   "Whether the branch will be deleted when the pull request is merged."   deleteBranchOnMerge: Boolean!
-  "The method used to merge a pull request."   mergeQueueMergeMethod: PullRequestMergeMethod
+  "The merge method used by the merge queue, if applicable. Null when merge queue is not enabled or the method is not specified."   mergeQueueMergeMethod: PullRequestMergeMethod
 }
 
-"A pull request related notification." type PullRequestNotification implements Notification & Entity & Node {
+"A notification related to a pull request, such as review requests, approvals, comments, check failures, or merge queue events." type PullRequestNotification implements Notification & Entity & Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "Notification type."   type: String!
-  "The user that caused the notification."   actor: User
-  "The external user that caused the notification."   externalUserActor: ExternalUser
-  "The user that received the notification."   user: User!
-  "The time at when the user marked the notification as read. Null, if the the user hasn't read the notification"   readAt: DateTime
-  """The time at when an email reminder for this notification was sent to the user. Null, if no email
-    reminder has been sent."""
-  emailedAt: DateTime
-  "The time until a notification will be snoozed. After that it will appear in the inbox again."   snoozedUntilAt: DateTime
-  "The time at which a notification was unsnoozed.."   unsnoozedAt: DateTime
+  "Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated."   type: String!
+  "The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event."   actor: User
+  "The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member."   externalUserActor: ExternalUser
+  "The recipient user of this notification."   user: User!
+  "The time at which the user marked the notification as read. Null if the notification is unread."   readAt: DateTime
+  "The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent."   emailedAt: DateTime
+  "The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed."   snoozedUntilAt: DateTime
+  "The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed."   unsnoozedAt: DateTime
   "The category of the notification."   category: NotificationCategory!
   "[Internal] URL to the target of the notification."   url: String!
   "[Internal] Inbox URL for the notification."   inboxUrl: String!
@@ -8364,7 +9198,7 @@ type ProjectUpdateReminderPayload {
   "The pull request related to the notification."   pullRequest: PullRequest!
 }
 
-"A user's web or mobile push notification subscription." type PushSubscription implements Node {
+"A device registration for receiving push notifications. Each PushSubscription represents a specific browser or mobile device endpoint where a user has opted in to receive real-time push notifications. A user may have multiple push subscriptions across different devices and browsers." type PushSubscription implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -8373,146 +9207,150 @@ type ProjectUpdateReminderPayload {
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
 }
 
-type PushSubscriptionPayload {
+"Return type for push subscription mutations." type PushSubscriptionPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "The push subscription that was created or updated."   entity: PushSubscription!
+  "The push subscription that was created or deleted."   entity: PushSubscription!
   "Whether the operation was successful."   success: Boolean!
 }
 
-type PushSubscriptionTestPayload {
+"Return type for the push subscription test query." type PushSubscriptionTestPayload {
   "Whether the operation was successful."   success: Boolean!
 }
 
 type Query {
-  "All integrations."   integrations(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IntegrationConnection!
-  "One specific integration."   integration(id: String!): Integration!
-  "Verify that we received the correct response from the GitHub Enterprise Server."   verifyGitHubEnterpriseServerInstallation(integrationId: String!): GitHubEnterpriseServerInstallVerificationPayload!
-  "Checks if the integration has all required scopes."   integrationHasScopes(scopes: [String!]!, integrationId: String!): IntegrationHasScopesPayload!
-  "returns a list of initiative to project entities."   initiativeToProjects(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): InitiativeToProjectConnection!
-  "One specific initiativeToProject."   initiativeToProject(id: String!): InitiativeToProject!
-  "A collection of document content history entries."   documentContentHistory(id: String!): DocumentContentHistoryPayload!
-  "All comments."   comments(filter: CommentFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CommentConnection!
-  "A specific comment."   comment(id: String, hash: String): Comment!
-  "Get basic information for an application."   applicationInfo(clientId: String!): Application!
-  "All issue workflow states."   workflowStates(filter: WorkflowStateFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): WorkflowStateConnection!
-  "One specific state."   workflowState(id: String!): WorkflowState!
-  "All webhooks."   webhooks(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): WebhookConnection!
-  "A specific webhook."   webhook(id: String!): Webhook!
+  "All issue workflow states (issue statuses). Returns a paginated list of workflow states visible to the authenticated user, across all teams they have access to."   workflowStates(filter: WorkflowStateFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): WorkflowStateConnection!
+  "One specific workflow state (issue status), looked up by its unique identifier."   workflowState(id: String!): WorkflowState!
+  "All webhooks for the current workspace."   webhooks(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): WebhookConnection!
+  "Retrieves a single webhook by its identifier."   webhook(id: String!): Webhook!
   "[INTERNAL] Webhook failure events for webhooks that belong to an OAuth application. (last 50)"   failuresForOauthWebhooks(oauthClientId: String!): [WebhookFailureEvent!]!
-  "The user's settings."   userSettings: UserSettings!
-  "All users for the organization."   users(filter: UserFilter, includeDisabled: Boolean, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [UserSortInput!]): UserConnection!
-  "One specific user."   user(id: String!): User!
-  "The currently authenticated user."   viewer: User!
-  "Lists the sessions of a user. Can only be called by an admin or owner."   userSessions(id: String!): [AuthenticationSessionResponse!]!
+  "The authenticated user's notification and UI settings."   userSettings: UserSettings!
+  "All users in the workspace. Supports filtering, sorting, and pagination."   users(filter: UserFilter, includeDisabled: Boolean, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [UserSortInput!]): UserConnection!
+  "Fetches a specific user by their ID."   user(id: String!): User!
+  "The currently authenticated user making the API request."   viewer: User!
+  "Lists all active authentication sessions for a user. Can only be called by a workspace admin or owner."   userSessions(id: String!): [AuthenticationSessionResponse!]!
   "All triage responsibilities."   triageResponsibilities(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TriageResponsibilityConnection!
   "A specific triage responsibility."   triageResponsibility(id: String!): TriageResponsibility!
   "All time schedules."   timeSchedules(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TimeScheduleConnection!
   "A specific time schedule."   timeSchedule(id: String!): TimeSchedule!
-  "All templates from all users."   templates: [Template!]!
+  "All templates in the workspace, including both team-scoped and workspace-level templates."   templates: [Template!]!
   "A specific template."   template(id: String!): Template!
   "Returns all templates that are associated with the integration type."   templatesForIntegration(integrationType: String!): [Template!]!
-  "All projects."   projects(filter: ProjectFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [ProjectSortInput!]): ProjectConnection!
-  "One specific project."   project(id: String!): Project!
-  "Suggests filters for a project view based on a text prompt."   projectFilterSuggestion(prompt: String!): ProjectFilterSuggestionPayload!
-  "All teams whose issues can be accessed by the user. This might be different from `administrableTeams`, which also includes teams whose settings can be changed by the user."   teams(filter: TeamFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TeamConnection!
-  "All teams you the user can administrate. Administrable teams are teams whose settings the user can change, but to whose issues the user doesn't necessarily have access to."   administrableTeams(filter: TeamFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TeamConnection!
-  "One specific team."   team(id: String!): Team!
-  "All team memberships."   teamMemberships(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TeamMembershipConnection!
-  "One specific team membership."   teamMembership(id: String!): TeamMembership!
-  "Search for various resources using natural language."   semanticSearch(query: String!, types: [SemanticSearchResultType!], maxResults: Int, includeArchived: Boolean, filters: SemanticSearchFilters): SemanticSearchPayload!
-  "Search documents."   searchDocuments(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, term: String!, includeComments: Boolean, teamId: String): DocumentSearchPayload!
-  "Search projects."   searchProjects(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, term: String!, includeComments: Boolean, teamId: String): ProjectSearchPayload!
-  "Search issues."   searchIssues(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, term: String!, includeComments: Boolean, teamId: String): IssueSearchPayload!
-  roadmapToProjects(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): RoadmapToProjectConnection! @deprecated(reason: "RoadmapToProject is deprecated, use InitiativeToProject instead.")
-  "One specific roadmapToProject."   roadmapToProject(id: String!): RoadmapToProject! @deprecated(reason: "RoadmapToProject is deprecated, use InitiativeToProject instead.")
-  "All roadmaps in the workspace."   roadmaps(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): RoadmapConnection! @deprecated(reason: "Roadmaps are deprecated, use initiatives instead.")
-  "One specific roadmap."   roadmap(id: String!): Roadmap! @deprecated(reason: "Roadmaps are deprecated, use initiatives instead.")
-  "[ALPHA] All release stages."   releaseStages(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ReleaseStageConnection!
-  "[ALPHA] One specific release stage."   releaseStage(id: String!): ReleaseStage!
-  "[ALPHA] All releases."   releases(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ReleaseConnection!
-  "[ALPHA] One specific release."   release(id: String!): Release!
-  "[ALPHA] All release pipelines."   releasePipelines(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ReleasePipelineConnection!
-  "[ALPHA] One specific release pipeline."   releasePipeline(id: String!): ReleasePipeline!
+  "Returns all projects in the workspace, with optional filtering and sorting."   projects(filter: ProjectFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [ProjectSortInput!]): ProjectConnection!
+  "Returns a single project by its identifier or URL slug."   project(id: String!): Project!
+  "Suggests filters for a project view based on a text prompt."   projectFilterSuggestion(teamId: String, prompt: String!): ProjectFilterSuggestionPayload!
+  "All teams whose issues the user can access. This includes public teams and private teams the user is a member of. This may differ from `administrableTeams`, which returns teams whose settings the user can change but whose issues they don't necessarily have access to."   teams(filter: TeamFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TeamConnection!
+  "All teams whose settings the user can administer. This includes teams the user can change settings for, but whose issues they may not have direct access to. This differs from the `teams` query which returns teams based on issue access."   administrableTeams(filter: TeamFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TeamConnection!
+  "Fetches a specific team by its ID."   team(id: String!): Team!
+  "All team memberships in the workspace."   teamMemberships(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TeamMembershipConnection!
+  "Fetches a specific team membership by its ID."   teamMembership(id: String!): TeamMembership!
+  "Search for issues, projects, initiatives, and documents using natural language. Uses vector-based semantic search with optional full-text search and reranking. Results can be filtered by type and by entity-specific filters. Rate-limited to 30 requests per minute."   semanticSearch(query: String!, types: [SemanticSearchResultType!], maxResults: Int, includeArchived: Boolean, filters: SemanticSearchFilters): SemanticSearchPayload!
+  "Search documents by text query using full-text and vector search. Results are ranked by relevance unless an orderBy parameter is specified. Rate-limited to 30 requests per minute."   searchDocuments(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, term: String!, includeComments: Boolean, teamId: String): DocumentSearchPayload!
+  "Search projects by text query using full-text and vector search. Results are ranked by relevance unless an orderBy parameter is specified. Rate-limited to 30 requests per minute."   searchProjects(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, term: String!, includeComments: Boolean, teamId: String): ProjectSearchPayload!
+  "Search issues by text query using full-text and vector search. Results are ranked by relevance unless an orderBy parameter is specified. Supports optional issue filters and comment inclusion. Rate-limited to 30 requests per minute."   searchIssues(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, term: String!, includeComments: Boolean, teamId: String): IssueSearchPayload!
+  "[Deprecated] Returns all roadmap-to-project associations. Use InitiativeToProject instead."   roadmapToProjects(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): RoadmapToProjectConnection! @deprecated(reason: "RoadmapToProject is deprecated, use InitiativeToProject instead.")
+  "[Deprecated] Returns a single roadmap-to-project association. Use InitiativeToProject instead."   roadmapToProject(id: String!): RoadmapToProject! @deprecated(reason: "RoadmapToProject is deprecated, use InitiativeToProject instead.")
+  "[Deprecated] Returns all roadmaps in the workspace. Use initiatives instead."   roadmaps(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): RoadmapConnection! @deprecated(reason: "Roadmaps are deprecated, use initiatives instead.")
+  "[Deprecated] Returns a single roadmap by its identifier. Use initiatives instead."   roadmap(id: String!): Roadmap! @deprecated(reason: "Roadmaps are deprecated, use initiatives instead.")
+  "[ALPHA] All release stages in the workspace, with optional filtering."   releaseStages(filter: ReleaseStageFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ReleaseStageConnection!
+  "[ALPHA] Fetch a single release stage by its UUID."   releaseStage(id: String!): ReleaseStage!
+  "[ALPHA] All release pipelines in the workspace, with optional filtering and sorting."   releasePipelines(filter: ReleasePipelineFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [ReleasePipelineSortInput!]): ReleasePipelineConnection!
+  "[ALPHA] Fetch a single release pipeline by its UUID or slug identifier."   releasePipeline(id: String!): ReleasePipeline!
   "[ALPHA] Returns a release pipeline by ID. Requires the access key to have access to the pipeline."   releasePipelineByAccessKey: ReleasePipeline!
   "[ALPHA] Returns the latest release for the pipeline associated with the access key."   latestReleaseByAccessKey: Release
-  "The status of the rate limiter."   rateLimitStatus: RateLimitPayload!
-  "Sends a test push message."   pushSubscriptionTest(targetMobile: Boolean = false, sendStrategy: SendStrategy = push): PushSubscriptionTestPayload!
-  "All project updates."   projectUpdates(filter: ProjectUpdateFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ProjectUpdateConnection!
-  "A specific project update."   projectUpdate(id: String!): ProjectUpdate!
-  "All project statuses."   projectStatuses(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ProjectStatusConnection!
-  "[INTERNAL] Count of projects using this project status across the organization."   projectStatusProjectCount(id: String!): ProjectStatusCountPayload!
-  "One specific project status."   projectStatus(id: String!): ProjectStatus!
-  "All project relationships."   projectRelations(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ProjectRelationConnection!
-  "One specific project relation."   projectRelation(id: String!): ProjectRelation!
-  "All milestones for the project."   projectMilestones(filter: ProjectMilestoneFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ProjectMilestoneConnection!
-  "One specific project milestone."   projectMilestone(id: String!): ProjectMilestone!
-  "All project labels."   projectLabels(filter: ProjectLabelFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ProjectLabelConnection!
-  "One specific label."   projectLabel(id: String!): ProjectLabel!
-  "The user's organization."   organization: Organization!
-  "Does the organization exist."   organizationExists(urlKey: String!): OrganizationExistsPayload!
-  "[Internal] All archived teams of the organization."   archivedTeams: [Team!]!
-  "[INTERNAL] Get organization metadata by urlKey or organization id."   organizationMeta(urlKey: String!): OrganizationMeta
-  "All invites for the organization."   organizationInvites(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): OrganizationInviteConnection!
-  "One specific organization invite."   organizationInvite(id: String!): OrganizationInvite!
-  "One specific organization invite."   organizationInviteDetails(id: String!): OrganizationInviteDetailsPayload!
+  "[ALPHA] All releases in the workspace, with optional filtering and sorting."   releases(filter: ReleaseFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [ReleaseSortInput!]): ReleaseConnection!
+  "[ALPHA] Fetch a single release by its UUID or slug identifier."   release(id: String!): Release!
+  "[ALPHA] Search releases with optional text matching against name, version, and pipeline name. When no search term is provided, returns releases ordered by stage priority (started > planned > completed > canceled)."   releaseSearch(filter: ReleaseFilter, first: Int = 20, term: String): [Release!]!
+  "[ALPHA] Release notes in the workspace."   releaseNotes(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ReleaseNoteConnection!
+  "[ALPHA] Fetch a release note by its identifier."   releaseNote(id: String!): ReleaseNote!
+  "The current rate limit status for the authenticated client, including remaining quota and reset timing for each limit type."   rateLimitStatus: RateLimitPayload!
+  "Sends a test push notification to the authenticated user's registered devices. Useful for verifying that push notification delivery is working correctly."   pushSubscriptionTest(targetMobile: Boolean = false, sendStrategy: SendStrategy = push): PushSubscriptionTestPayload!
+  "Returns all project status updates in the workspace, with optional filtering."   projectUpdates(filter: ProjectUpdateFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ProjectUpdateConnection!
+  "Returns a single project update by its identifier."   projectUpdate(id: String!): ProjectUpdate!
+  "Returns all project statuses in the workspace."   projectStatuses(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ProjectStatusConnection!
+  "[INTERNAL] Count of projects using this project status across the workspace."   projectStatusProjectCount(id: String!): ProjectStatusCountPayload!
+  "Returns a single project status by its identifier."   projectStatus(id: String!): ProjectStatus!
+  "Returns all project dependency relations in the workspace."   projectRelations(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ProjectRelationConnection!
+  "Returns a single project relation by its identifier."   projectRelation(id: String!): ProjectRelation!
+  "Returns all project milestones in the workspace, with optional filtering."   projectMilestones(filter: ProjectMilestoneFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ProjectMilestoneConnection!
+  "Returns a single project milestone by its identifier."   projectMilestone(id: String!): ProjectMilestone!
+  "Returns all project labels in the workspace, with optional filtering."   projectLabels(filter: ProjectLabelFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ProjectLabelConnection!
+  "Returns a single project label by its identifier."   projectLabel(id: String!): ProjectLabel!
+  "The authenticated user's workspace."   organization: Organization!
+  "Checks whether a workspace with the given URL key exists."   organizationExists(urlKey: String!): OrganizationExistsPayload!
+  "[Internal] All archived teams of the workspace."   archivedTeams: [Team!]!
+  "[INTERNAL] Get workspace metadata by URL key or workspace ID."   organizationMeta(urlKey: String!): OrganizationMeta
+  "All pending and accepted invites for the workspace."   organizationInvites(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): OrganizationInviteConnection!
+  "Fetches a specific workspace invite by its ID."   organizationInvite(id: String!): OrganizationInvite!
+  "Fetches public details of a specific workspace invite by its ID. This query does not require authentication and is used for invite acceptance flows."   organizationInviteDetails(id: String!): OrganizationInviteDetailsPayload!
   "[INTERNAL] Checks whether the domain can be claimed."   organizationDomainClaimRequest(id: String!): OrganizationDomainClaimPayload!
-  "The user's notification subscriptions."   notificationSubscriptions(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): NotificationSubscriptionConnection!
-  "One specific notification subscription."   notificationSubscription(id: String!): NotificationSubscription!
-  "All notifications."   notifications(filter: NotificationFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): NotificationConnection!
+  "The authenticated user's notification subscriptions. These subscriptions control which notifications the user receives for specific entities such as teams, projects, cycles, labels, custom views, initiatives, customers, and users."   notificationSubscriptions(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): NotificationSubscriptionConnection!
+  "A specific notification subscription by ID."   notificationSubscription(id: String!): NotificationSubscription!
+  "The authenticated user's notifications."   notifications(filter: NotificationFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): NotificationConnection!
   "[Internal] A number of unread notifications."   notificationsUnreadCount: Int!
-  "One specific notification."   notification(id: String!): Notification!
-  "[ALPHA] Returns a list of issue to release entities."   issueToReleases(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueToReleaseConnection!
-  "[ALPHA] One specific issueToRelease."   issueToRelease(id: String!): IssueToRelease!
-  "All issues."   issues(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [IssueSortInput!]): IssueConnection!
-  "One specific issue."   issue(id: String!): Issue!
+  "A specific notification by ID."   notification(id: String!): Notification!
+  "[ALPHA] All issue-to-release associations. Returns a paginated list of all issue-to-release links visible to the authenticated user."   issueToReleases(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueToReleaseConnection!
+  "[ALPHA] One specific issue-to-release association, looked up by its unique identifier."   issueToRelease(id: String!): IssueToRelease!
+  "All issues. Returns a paginated list of issues visible to the authenticated user. Can be filtered by various criteria including team, assignee, state, labels, project, and cycle."   issues(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [IssueSortInput!]): IssueConnection!
+  "One specific issue, looked up by its unique identifier."   issue(id: String!): Issue!
   "[DEPRECATED] Search issues. This endpoint is deprecated and will be removed in the future – use `searchIssues` instead."   issueSearch(filter: IssueFilter, query: String, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
   "Find issue based on the VCS branch name."   issueVcsBranchSearch(branchName: String!): Issue
   "Find issues that are related to a given Figma file key."   issueFigmaFileKeySearch(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, fileKey: String!): IssueConnection!
   "Issue priority values and corresponding labels."   issuePriorityValues: [IssuePriorityValue!]!
-  "Suggests filters for an issue view based on a text prompt."   issueFilterSuggestion(projectId: String, prompt: String!): IssueFilterSuggestionPayload!
+  "Suggests filters for an issue view based on a text prompt."   issueFilterSuggestion(teamId: String, projectId: String, prompt: String!): IssueFilterSuggestionPayload!
   "Returns code repositories that are most likely to be relevant for implementing an issue."   issueRepositorySuggestions(agentSessionId: String, candidateRepositories: [CandidateRepository!]!, issueId: String!): RepositorySuggestionsPayload!
-  "All issue relationships."   issueRelations(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueRelationConnection!
-  "One specific issue relation."   issueRelation(id: String!): IssueRelation!
-  "All issue labels."   issueLabels(filter: IssueLabelFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueLabelConnection!
-  "One specific label."   issueLabel(id: String!): IssueLabel!
+  "All issue relations. Returns a paginated list of all issue relations (blocks, blocked by, relates to, duplicates) visible to the authenticated user."   issueRelations(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueRelationConnection!
+  "One specific issue relation, looked up by its unique identifier."   issueRelation(id: String!): IssueRelation!
+  "All issue labels. Returns a paginated list of labels visible to the authenticated user, including both workspace-level and team-scoped labels."   issueLabels(filter: IssueLabelFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueLabelConnection!
+  "One specific label, looked up by its unique identifier."   issueLabel(id: String!): IssueLabel!
   "Checks a CSV file validity against a specific import service."   issueImportCheckCSV(csvUrl: String!, service: String!): IssueImportCheckPayload!
-  "Checks whether it will be possible to setup sync for this project or repository at the end of import"   issueImportCheckSync(issueImportId: String!): IssueImportSyncCheckPayload!
-  "Checks whether a custom JQL query is valid and can be used to filter issues of a Jira import"   issueImportJqlCheck(jiraHostname: String!, jiraToken: String!, jiraEmail: String!, jiraProject: String!, jql: String!): IssueImportJqlCheckPayload!
-  "One specific set of settings."   integrationsSettings(id: String!): IntegrationsSettings!
-  "Template and integration connections."   integrationTemplates(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IntegrationTemplateConnection!
-  "One specific integrationTemplate."   integrationTemplate(id: String!): IntegrationTemplate!
-  "All  InitiativeUpdates."   initiativeUpdates(filter: InitiativeUpdateFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): InitiativeUpdateConnection!
-  "A specific  initiative update."   initiativeUpdate(id: String!): InitiativeUpdate!
-  "All initiatives in the workspace."   initiatives(filter: InitiativeFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [InitiativeSortInput!]): InitiativeConnection!
-  "One specific initiative."   initiative(id: String!): Initiative!
-  "All initiative relationships."   initiativeRelations(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): InitiativeRelationConnection!
-  "One specific initiative relation."   initiativeRelation(id: String!): ProjectRelation!
+  "Checks whether it will be possible to set up sync for this project or repository at the end of import."   issueImportCheckSync(issueImportId: String!): IssueImportSyncCheckPayload!
+  "Checks whether a custom JQL query is valid and can be used to filter issues of a Jira import."   issueImportJqlCheck(jiraHostname: String!, jiraToken: String!, jiraEmail: String!, jiraProject: String!, jql: String!): IssueImportJqlCheckPayload!
+  "Retrieves a specific integration settings configuration by its identifier."   integrationsSettings(id: String!): IntegrationsSettings!
+  "All integration template connections for the workspace, linking templates to integrations."   integrationTemplates(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IntegrationTemplateConnection!
+  "Retrieves a single integration template connection by its identifier."   integrationTemplate(id: String!): IntegrationTemplate!
+  "All integrations for the workspace."   integrations(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IntegrationConnection!
+  "Retrieves a single integration by its identifier."   integration(id: String!): Integration!
+  "Verify that we received the correct response from the GitHub Enterprise Server."   verifyGitHubEnterpriseServerInstallation(integrationId: String!): GitHubEnterpriseServerInstallVerificationPayload!
+  "Checks if the integration has all required scopes."   integrationHasScopes(scopes: [String!]!, integrationId: String!): IntegrationHasScopesPayload!
+  "[Internal] Lists Microsoft Teams teams and channels accessible to the connecting user. Uses the user's microsoftPersonal integration for auth. Used by the project channel picker dialog to populate the team/channel dropdowns."   microsoftTeamsChannels: MicrosoftTeamsChannelsPayload!
+  "Returns all initiative status updates in the workspace, with optional filtering."   initiativeUpdates(filter: InitiativeUpdateFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): InitiativeUpdateConnection!
+  "Returns a single initiative update by its identifier."   initiativeUpdate(id: String!): InitiativeUpdate!
+  "Returns all initiative-to-project associations in the workspace."   initiativeToProjects(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): InitiativeToProjectConnection!
+  "Returns a single initiative-to-project association by its identifier."   initiativeToProject(id: String!): InitiativeToProject!
+  "Returns all initiatives in the workspace, with optional filtering and sorting."   initiatives(filter: InitiativeFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [InitiativeSortInput!]): InitiativeConnection!
+  "Returns a single initiative by its identifier or URL slug."   initiative(id: String!): Initiative!
+  "Returns all initiative parent-child relations in the workspace."   initiativeRelations(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): InitiativeRelationConnection!
+  "Returns a single initiative relation by its identifier."   initiativeRelation(id: String!): InitiativeRelation!
   "[Internal] Fetch an arbitrary set of data using natural language query. Be specific about what you want including properties for each entity, sort order, filters, limit and properties."   fetchData(query: String!): FetchDataPayload!
-  "The user's favorites."   favorites(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): FavoriteConnection!
-  "One specific favorite."   favorite(id: String!): Favorite!
-  "All external users for the organization."   externalUsers(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ExternalUserConnection!
-  "One specific external user."   externalUser(id: String!): ExternalUser!
-  "One specific entity link."   entityExternalLink(id: String!): EntityExternalLink!
-  "All custom emojis."   emojis(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): EmojiConnection!
-  "A specific emoji."   emoji(id: String!): Emoji!
+  "The authenticated user's favorites. Returns all bookmarked items that appear in the user's sidebar."   favorites(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): FavoriteConnection!
+  "A specific favorite by ID."   favorite(id: String!): Favorite!
+  "All external users for the organization. External users are people who interact with Linear through integrated services (Slack, Jira, GitHub, etc.) without having a Linear account."   externalUsers(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ExternalUserConnection!
+  "Retrieves a single external user by their identifier."   externalUser(id: String!): ExternalUser!
+  "Retrieves a single entity external link by its identifier."   entityExternalLink(id: String!): EntityExternalLink!
+  "All custom emojis in the workspace."   emojis(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): EmojiConnection!
+  "A specific custom emoji by ID or name."   emoji(id: String!): Emoji!
   "One specific email intake address."   emailIntakeAddress(id: String!): EmailIntakeAddress!
-  "All documents in the workspace."   documents(filter: DocumentFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): DocumentConnection!
-  "One specific document."   document(id: String!): Document!
-  "All cycles."   cycles(filter: CycleFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CycleConnection!
-  "One specific cycle."   cycle(id: String!): Cycle!
-  "All customer tiers."   customerTiers(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CustomerTierConnection!
+  "All documents the user has access to in the workspace."   documents(filter: DocumentFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): DocumentConnection!
+  "A specific document by ID or slug."   document(id: String!): Document!
+  "A collection of document content history entries."   documentContentHistory(id: String!): DocumentContentHistoryPayload!
+  "[Internal] Fetches document content history entries by their IDs, including content data."   documentContentHistoryEntries(entryIds: [String!]!): DocumentContentHistoryPayload!
+  "All cycles accessible to the user."   cycles(filter: CycleFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CycleConnection!
+  "One specific cycle, looked up by ID or slug."   cycle(id: String!): Cycle!
+  "All customer tiers defined in the workspace."   customerTiers(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CustomerTierConnection!
   "One specific customer tier."   customerTier(id: String!): CustomerTier!
-  "All customer statuses."   customerStatuses(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CustomerStatusConnection!
+  "All customer statuses defined in the workspace."   customerStatuses(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CustomerStatusConnection!
   "One specific customer status."   customerStatus(id: String!): CustomerStatus!
-  "All customers."   customers(filter: CustomerFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sorts: [CustomerSortInput!]): CustomerConnection!
-  "One specific customer."   customer(id: String!): Customer!
-  "All customer needs."   customerNeeds(filter: CustomerNeedFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CustomerNeedConnection!
-  "One specific customer need"   customerNeed(id: String, hash: String): CustomerNeed!
-  "Suggests issue title based on a customer request."   issueTitleSuggestionFromCustomerRequest(request: String!): IssueTitleSuggestionFromCustomerRequestPayload!
-  "Custom views for the user."   customViews(filter: CustomViewFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [CustomViewSortInput!]): CustomViewConnection!
-  "One specific custom view."   customView(id: String!): CustomView!
-  "[INTERNAL] Suggests metadata for a view based on it's filters."   customViewDetailsSuggestion(modelName: String, filter: JSONObject!): CustomViewSuggestionPayload!
-  "Whether a custom view has other subscribers than the current user in the organization."   customViewHasSubscribers(id: String!): CustomViewHasSubscribersPayload!
+  "All customers in the workspace, with optional filtering and sorting."   customers(filter: CustomerFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sorts: [CustomerSortInput!]): CustomerConnection!
+  "Retrieves a single customer by ID or slug."   customer(id: String!): Customer!
+  "All customer needs in the workspace, with optional filtering."   customerNeeds(filter: CustomerNeedFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CustomerNeedConnection!
+  "Retrieves a single customer need by ID or hash."   customerNeed(id: String, hash: String): CustomerNeed!
+  "Suggests an issue title based on a customer request message using AI summarization."   issueTitleSuggestionFromCustomerRequest(request: String!): IssueTitleSuggestionFromCustomerRequestPayload!
+  "All custom views accessible to the user, including personal views and shared workspace views. Excludes views scoped to a specific project or initiative."   customViews(filter: CustomViewFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [CustomViewSortInput!]): CustomViewConnection!
+  "One specific custom view, looked up by ID or slug."   customView(id: String!): CustomView!
+  "[INTERNAL] Suggests metadata (name, description, icon) for a view based on its filters using AI. Rate-limited to 30 requests per minute."   customViewDetailsSuggestion(modelName: String, filter: JSONObject!): CustomViewSuggestionPayload!
+  "Whether a custom view has active notification subscribers other than the current user. Useful for warning before deleting a shared view."   customViewHasSubscribers(id: String!): CustomViewHasSubscribersPayload!
+  "All comments the user has access to in the workspace."   comments(filter: CommentFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CommentConnection!
+  "A specific comment."   comment(id: String, hash: String): Comment!
   "Fetch users belonging to this user account."   availableUsers: AuthResolverResponse!
   "User's active sessions."   authenticationSessions: [AuthenticationSessionResponse!]!
   "Fetch SSO login URL for the email provided."   ssoUrlFromEmail(isDesktop: Boolean, type: IdentityProviderType! = general, email: String!): SsoUrlFromEmailResponse!
@@ -8532,53 +9370,53 @@ Query an issue by its associated attachment, and its id.
 """
   attachmentIssue(id: String!): Issue! @deprecated(reason: "Will be removed in near future, please use `attachmentsForURL` to get attachments and their issues instead.")
   "[Internal] Get a list of all unique attachment sources in the workspace."   attachmentSources(teamId: String): AttachmentSourcesPayload!
-  "Asks web form settings by ID."   asksWebSetting(id: String!): AsksWebSettings!
-  "An Asks web page by ID."   asksWebPage(id: String!): AsksWebPage!
+  "Retrieves public information about an OAuth application by its client ID. Used during the authorization flow to display application details to the user."   applicationInfo(clientId: String!): Application!
   "All agent sessions."   agentSessions(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): AgentSessionConnection!
   "A specific agent session."   agentSession(id: String!): AgentSession!
+  "[Internal] Retrieves coding agent sandbox details for a given agent session ID."   agentSessionSandbox(agentSessionId: String!): CodingAgentSandboxPayload
   "All agent activities."   agentActivities(filter: AgentActivityFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): AgentActivityConnection!
   "A specific agent activity."   agentActivity(id: String!): AgentActivity!
 }
 
-type RateLimitPayload {
-  "The identifier we rate limit on."   identifier: String
-  "The kind of rate limit selected for this request."   kind: String!
-  "The state of the rate limit."   limits: [RateLimitResultPayload!]!
+"The current rate limit status for the authenticated entity." type RateLimitPayload {
+  "The identifier being rate limited, typically the API key or user ID."   identifier: String
+  "The category of rate limit applied to this request, such as API complexity or request count."   kind: String!
+  "The current state of each rate limit type, including remaining quota and reset timing."   limits: [RateLimitResultPayload!]!
 }
 
-type RateLimitResultPayload {
-  "What is being rate limited."   type: String!
+"The state of a specific rate limit type, including remaining quota and reset timing." type RateLimitResultPayload {
+  "The specific type of rate limit being tracked, such as query complexity or mutation count."   type: String!
   "The requested quantity for this type of limit."   requestedAmount: Float!
   "The total allowed quantity for this type of limit."   allowedAmount: Float!
-  "The period in which the rate limit is fully replenished in ms."   period: Float!
+  "The duration in milliseconds of the rate limit window. After this period elapses, the limit is fully replenished."   period: Float!
   "The remaining quantity for this type of limit after this request."   remainingAmount: Float!
-  "The timestamp after the rate limit is fully replenished as a UNIX timestamp."   reset: Float!
+  "The UNIX timestamp (in milliseconds) at which the rate limit will be fully replenished."   reset: Float!
 }
 
-"A reaction associated with a comment or a project update." type Reaction implements Node {
+"An emoji reaction on a comment, issue, project update, initiative update, post, pull request, or pull request comment. Each reaction is associated with exactly one parent entity and is created by either a workspace user or an external user. Reactions are persisted individually but surfaced on their parent entities as aggregated reactionData." type Reaction implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "Name of the reaction's emoji."   emoji: String!
-  "The issue that the reaction is associated with."   issue: Issue
-  "The comment that the reaction is associated with."   comment: Comment
-  "The project update that the reaction is associated with."   projectUpdate: ProjectUpdate
-  "The initiative update that the reaction is associated with."   initiativeUpdate: InitiativeUpdate
-  "The post that the reaction is associated with."   post: Post
-  "The user that created the reaction."   user: User
-  "The external user that created the reaction."   externalUser: ExternalUser
+  "The name of the emoji used for this reaction. For custom workspace emojis, this is the custom emoji name; for standard emojis, this is the normalized emoji name."   emoji: String!
+  "The issue that the reaction is associated with. Null if the reaction belongs to a different parent entity type."   issue: Issue
+  "The comment that the reaction is associated with. Null if the reaction belongs to a different parent entity type."   comment: Comment
+  "The project update that the reaction is associated with. Null if the reaction belongs to a different parent entity type."   projectUpdate: ProjectUpdate
+  "The initiative update that the reaction is associated with. Null if the reaction belongs to a different parent entity type."   initiativeUpdate: InitiativeUpdate
+  "The post that the reaction is associated with. Null if the reaction belongs to a different parent entity type."   post: Post
+  "The workspace user that created the reaction. Null if the reaction was created by an external user through an integration."   user: User
+  "The external user that created the reaction through an integration. Null if the reaction was created by a workspace user."   externalUser: ExternalUser
 }
 
-type ReactionPayload {
+"The result of a reaction mutation." type ReactionPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  reaction: Reaction!
-  success: Boolean!
+  "The reaction that was created."   reaction: Reaction!
+  "Whether the operation was successful."   success: Boolean!
 }
 
-"[Internal] A release." type Release implements Node {
+"[Internal] A release that bundles issues together for a software deployment or version. Releases belong to a release pipeline and progress through stages (e.g., planned, started, completed, canceled). Issues are associated with releases via the IssueToRelease join entity, and the release tracks lifecycle timestamps such as when it was started, completed, or canceled." type Release implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -8586,20 +9424,28 @@ type ReactionPayload {
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The name of the release."   name: String!
-  "The release's description."   description: String
-  "The version of the release."   version: String
-  "The commit SHA associated with this release."   commitSha: String
-  "The pipeline this release belongs to."   pipeline: ReleasePipeline!
-  "The current stage of the release."   stage: ReleaseStage!
-  "The release's unique URL slug."   slugId: String!
-  "The estimated start date of the release."   startDate: TimelessDate
-  "The estimated completion date of the release."   targetDate: TimelessDate
-  "The time at which the release was started."   startedAt: DateTime
-  "The time at which the release was completed."   completedAt: DateTime
-  "The time at which the release was canceled."   canceledAt: DateTime
-  "Release URL."   url: String!
+  "The description of the release in plain text or markdown. Null if no description has been set."   description: String
+  "The version identifier for this release (e.g., 'v1.2.3' or a short commit hash). Must be unique within the pipeline. Null if no version has been assigned."   version: String
+  "The Git commit SHA associated with this release. Used for SHA-based idempotency when completing releases and for linking releases to specific points in the repository history. Null if the release was created without a commit reference."   commitSha: String
+  "The release pipeline that this release belongs to. A release always belongs to exactly one pipeline."   pipeline: ReleasePipeline!
+  "The current stage of the release within its pipeline (e.g., Planned, In Progress, Completed, Canceled). Changing the stage triggers lifecycle timestamp updates and may move non-closed issues to a new release when completing a scheduled pipeline release."   stage: ReleaseStage!
+  "The user who created the release. Null if the release was created by a non-user context such as an access key or automation."   creator: User
+  "The release's unique URL slug, used to construct human-readable URLs for the release."   slugId: String!
+  "The estimated start date of the release. This is a date-only value without a time component. Automatically set to today when the release moves to a started stage if not already set. Null if no start date has been specified."   startDate: TimelessDate
+  "The estimated completion date of the release. This is a date-only value without a time component. Null if no target date has been specified."   targetDate: TimelessDate
+  "The time at which the release first entered a started stage. Null if the release has not yet been started."   startedAt: DateTime
+  "The time at which the release was completed. Set automatically when the release moves to a completed stage. Reset to null if the release moves back to a non-completed stage."   completedAt: DateTime
+  "The time at which the release was canceled. Set automatically when the release moves to a canceled stage. Reset to null if the release moves back to a non-canceled stage."   canceledAt: DateTime
+  "A flag that indicates whether the release is in the trash bin. Trashed releases are archived and will be permanently deleted after a retention period. Null when the release is not trashed."   trashed: Boolean
+  "[Internal] The historical progress snapshots for the release, tracking how issue completion has evolved over time."   progressHistory: JSONObject!
+  "[Internal] The current progress summary for the release, including counts of issues by workflow state type (e.g., completed, in progress, unstarted)."   currentProgress: JSONObject!
+  "[Internal] History entries associated with the release."   history(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ReleaseHistoryConnection!
+  "The URL to the release page in the Linear app."   url: String!
   "[Internal] Documents associated with the release."   documents(filter: DocumentFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): DocumentConnection!
+  "[ALPHA] Issues associated with the release."   issues(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
+  "[ALPHA] Number of issues associated with the release."   issueCount(includeArchived: Boolean = false): Int!
   "[Internal] Links associated with the release."   links(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): EntityExternalLinkConnection!
+  "[ALPHA] Release notes for the release."   releaseNotes: [ReleaseNote!]!
 }
 
 "A generic payload return from entity archive mutations." type ReleaseArchivePayload implements ArchivePayload {
@@ -8619,13 +9465,63 @@ type ReleaseEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type ReleasePayload {
+"[Internal] A release history record containing a batch of chronologically ordered change events for a release. Each record holds up to 30 entries, and new records are created once the current record is full and a time window has elapsed. Tracks changes to name, description, version, stage, dates, pipeline, and archive status." type ReleaseHistory implements Node {
+  "The unique identifier of the entity."   id: ID!
+  "The time at which the entity was created."   createdAt: DateTime!
+  """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
+    been updated after creation."""
+  updatedAt: DateTime!
+  "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
+  "The events that happened while recording that history."   entries: JSONObject!
+  "The release that this history record tracks changes for."   release: Release!
+}
+
+type ReleaseHistoryConnection {
+  edges: [ReleaseHistoryEdge!]!
+  nodes: [ReleaseHistory!]!
+  pageInfo: PageInfo!
+}
+
+type ReleaseHistoryEdge {
+  node: ReleaseHistory!
+  "Used in `before` and `after` args"   cursor: String!
+}
+
+"[Internal] A release note. The note body is stored in related document content, and the releases it covers are tracked in releaseIds." type ReleaseNote implements Node {
+  "The unique identifier of the entity."   id: ID!
+  "The time at which the entity was created."   createdAt: DateTime!
+  """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
+    been updated after creation."""
+  updatedAt: DateTime!
+  "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
+  "[ALPHA] Releases included in the note."   releases: [Release!]!
+  "[Internal] Document content backing the release note body."   documentContent: DocumentContent
+}
+
+type ReleaseNoteConnection {
+  edges: [ReleaseNoteEdge!]!
+  nodes: [ReleaseNote!]!
+  pageInfo: PageInfo!
+}
+
+type ReleaseNoteEdge {
+  node: ReleaseNote!
+  "Used in `before` and `after` args"   cursor: String!
+}
+
+"[ALPHA] The result of a release note mutation." type ReleaseNotePayload {
+  "The identifier of the last sync operation."   lastSyncId: Float!
+  "The release note that was created or updated."   releaseNote: ReleaseNote!
+  "Whether the operation was successful."   success: Boolean!
+}
+
+"The result of a release mutation, containing the release that was created or updated and a success indicator." type ReleasePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The release that was created or updated."   release: Release!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"[Internal] A release pipeline." type ReleasePipeline implements Node {
+"[Internal] A release pipeline that defines a release workflow with ordered stages. Pipelines can be continuous (each sync creates a completed release) or scheduled (issues accumulate in a started release that is explicitly completed). Pipelines are associated with teams and can filter commits by file path patterns." type ReleasePipeline implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -8633,12 +9529,15 @@ type ReleasePayload {
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The name of the pipeline."   name: String!
-  "The pipeline's unique slug identifier."   slugId: String!
-  "The type of the pipeline."   type: ReleasePipelineType!
-  "Glob patterns to include commits affecting matching file paths."   includePathPatterns: [String!]!
-  "[ALPHA] The active access key for this pipeline."   accessKey: AccessKey
+  "The pipeline's unique slug identifier, used in URLs and for lookup by human-readable identifier instead of UUID."   slugId: String!
+  "The type of the pipeline, which determines how releases are created and managed. Continuous pipelines create a completed release per sync, while scheduled pipelines accumulate issues in a started release."   type: ReleasePipelineType!
+  "[ALPHA] Whether this pipeline targets a production environment. Defaults to true. Used to distinguish production pipelines from staging or development pipelines."   isProduction: Boolean!
+  "Glob patterns to filter commits by file path. When non-empty, only commits that modify files matching at least one pattern will be included in release syncs. An empty array means all commits are included regardless of file paths."   includePathPatterns: [String!]!
+  "[ALPHA] The approximate number of non-archived releases in this pipeline. This is a denormalized count that is updated when releases are created or archived, and may not reflect the exact count at all times."   approximateReleaseCount: Int!
+  "[Internal] The URL to the release pipeline's releases list in the Linear app."   url: String!
+  "[ALPHA] Teams associated with this pipeline."   teams(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TeamConnection!
   "[ALPHA] Stages associated with this pipeline."   stages(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ReleaseStageConnection!
-  "[ALPHA] Releases associated with this pipeline."   releases(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ReleaseConnection!
+  "[ALPHA] Releases associated with this pipeline."   releases(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [ReleaseSortInput!]): ReleaseConnection!
 }
 
 "A generic payload return from entity archive mutations." type ReleasePipelineArchivePayload implements ArchivePayload {
@@ -8658,13 +9557,13 @@ type ReleasePipelineEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type ReleasePipelinePayload {
+"The result of a release pipeline mutation." type ReleasePipelinePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The release pipeline that was created or updated."   releasePipeline: ReleasePipeline!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"[Internal] A release stage." type ReleaseStage implements Node {
+"[Internal] A stage within a release pipeline that represents a phase in the release lifecycle (e.g., Planned, In Progress, Completed, Canceled). Releases progress through stages as they move toward production. Started-type stages can be frozen to prevent new issues from being automatically synced into releases at that stage." type ReleaseStage implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -8672,11 +9571,11 @@ type ReleasePipelinePayload {
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The name of the stage."   name: String!
-  "The UI color of the stage as a HEX string."   color: String!
-  "The type of the stage."   type: ReleaseStageType!
-  "The position of the stage."   position: Float!
-  "Whether this stage is frozen. Only applicable to started type stages."   frozen: Boolean!
-  "The pipeline this stage belongs to."   pipeline: ReleasePipeline!
+  "The display color of the stage as a HEX string (e.g., '#0f783c'), used for visual representation in the UI."   color: String!
+  "The lifecycle type of the stage (planned, started, completed, or canceled). The type determines what lifecycle timestamps are set on a release when it enters this stage."   type: ReleaseStageType!
+  "The position of the stage within its pipeline, used for ordering stages in the UI. Lower values appear first."   position: Float!
+  "Whether this stage is frozen. Only applicable to started-type stages. When a stage is frozen, automated release syncs will not target releases in this stage, and new issues will not be automatically added. At least one started stage in the pipeline must remain non-frozen."   frozen: Boolean!
+  "The release pipeline that this stage belongs to. A stage always belongs to exactly one pipeline."   pipeline: ReleasePipeline!
   "[ALPHA] Releases associated with this stage."   releases(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ReleaseConnection!
 }
 
@@ -8697,23 +9596,23 @@ type ReleaseStageEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type ReleaseStagePayload {
+"The result of a release stage mutation." type ReleaseStagePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The release stage that was created or updated."   releaseStage: ReleaseStage!
   "Whether the operation was successful."   success: Boolean!
 }
 
-type RepositorySuggestion {
+"A suggested code repository that may be relevant for implementing an issue." type RepositorySuggestion {
   "The full name of the repository in owner/name format (e.g., 'acme/backend')."   repositoryFullName: String!
   "Hostname of the Git service (e.g., 'github.com', 'github.company.com')."   hostname: String
   "Confidence score from 0.0 to 1.0."   confidence: Float!
 }
 
-type RepositorySuggestionsPayload {
+"The result of a repository suggestions query, containing the list of suggested repositories." type RepositorySuggestionsPayload {
   "The suggested repositories."   suggestions: [RepositorySuggestion!]!
 }
 
-"[Deprecated] A roadmap for projects." type Roadmap implements Node {
+"[Deprecated] A roadmap for grouping projects. Use Initiative instead, which supersedes this entity and provides richer hierarchy and tracking capabilities." type Roadmap implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -8722,11 +9621,11 @@ type RepositorySuggestionsPayload {
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The name of the roadmap."   name: String!
   "The description of the roadmap."   description: String
-  "The organization of the roadmap."   organization: Organization!
+  "The workspace of the roadmap."   organization: Organization!
   "The user who created the roadmap."   creator: User!
   "The user who owns the roadmap."   owner: User
   "The roadmap's unique URL slug."   slugId: String!
-  "The sort order of the roadmap within the organization."   sortOrder: Float!
+  "The sort order of the roadmap within the workspace."   sortOrder: Float!
   "The roadmap's color."   color: String
   "Projects associated with the roadmap."   projects(filter: ProjectFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ProjectConnection!
   "The canonical url for the roadmap."   url: String!
@@ -8749,13 +9648,13 @@ type RoadmapEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type RoadmapPayload {
+"The result of a roadmap mutation." type RoadmapPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The roadmap that was created or updated."   roadmap: Roadmap!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"[Deprecated] Join table between projects and roadmaps." type RoadmapToProject implements Node {
+"[Deprecated] The join entity linking a project to a roadmap. Use InitiativeToProject instead, which supersedes this entity." type RoadmapToProject implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -8778,27 +9677,27 @@ type RoadmapToProjectEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type RoadmapToProjectPayload {
+"The result of a roadmap-to-project mutation." type RoadmapToProjectPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The roadmapToProject that was created or updated."   roadmapToProject: RoadmapToProject!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"Payload returned by semantic search." type SemanticSearchPayload {
+"The payload returned by the semantic search query, containing the list of matching results." type SemanticSearchPayload {
   "Whether the semantic search is enabled."   enabled: Boolean! @deprecated(reason: "Always true.")
-  results: [SemanticSearchResult!]!
+  "The list of matching search results, ordered by relevance score."   results: [SemanticSearchResult!]!
 }
 
-"A semantic search result reference." type SemanticSearchResult implements Node {
+"A reference to an entity returned by semantic search, containing its type and ID. Resolve the specific entity using the type-specific field resolvers (issue, project, initiative, document)." type SemanticSearchResult implements Node {
   "The unique identifier of the entity."   id: ID!
   "The type of the semantic search result."   type: SemanticSearchResultType!
-  "The issue related to the semantic search result."   issue: Issue
-  "The project related to the semantic search result."   project: Project
-  "The initiative related to the semantic search result."   initiative: Initiative
-  "The document related to the semantic search result."   document: Document
+  "The issue entity, if this search result is of type Issue. Null for other result types."   issue: Issue
+  "The project entity, if this search result is of type Project. Null for other result types."   project: Project
+  "The initiative entity, if this search result is of type Initiative. Null for other result types."   initiative: Initiative
+  "The document entity, if this search result is of type Document. Null for other result types."   document: Document
 }
 
-"SES domain identity used for sending emails from a custom domain." type SesDomainIdentity implements Node {
+"A verified Amazon SES domain identity that enables sending emails from a custom domain. Organizations configure SES domain identities to send issue notification replies and Asks auto-replies from their own domain instead of the default Linear domain. Full verification requires DKIM signing, a custom MAIL FROM domain, and organization ownership confirmation. Multiple organizations sharing the same domain each have their own SesDomainIdentity record but share the underlying SES identity." type SesDomainIdentity implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -8807,7 +9706,7 @@ type RoadmapToProjectPayload {
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The domain of the SES domain identity."   domain: String!
   "The AWS region of the SES domain identity."   region: String!
-  "The organization of the SES domain identity."   organization: Organization!
+  "The workspace of the SES domain identity."   organization: Organization!
   "The user who created the SES domain identity."   creator: User
   "Whether the domain is fully verified and can be used for sending emails."   canSendFromCustomDomain: Boolean!
   "The DNS records for the SES domain identity."   dnsRecords: [SesDomainIdentityDnsRecord!]!
@@ -8820,7 +9719,7 @@ type RoadmapToProjectPayload {
   "Whether the DNS record is verified in the domain's DNS configuration."   isVerified: Boolean!
 }
 
-"Tuple for mapping Slack channel IDs to names." type SlackAsksTeamSettings {
+"Configuration for a Linear team within a Slack Asks channel mapping. Controls whether the default Asks template is enabled for the team in a given Slack channel." type SlackAsksTeamSettings {
   "The Linear team ID."   id: String!
   "Whether the default Asks template is enabled in the given channel for this team."   hasDefaultAsk: Boolean!
 }
@@ -8834,7 +9733,7 @@ type SlackChannelConnectPayload {
   "Whether it's recommended to update main Slack integration."   nudgeToUpdateMainSlackIntegration: Boolean
 }
 
-"Object for mapping Slack channel IDs to names and other settings." type SlackChannelNameMapping {
+"Configuration for a Slack channel connected to Linear via Slack Asks. Maps the Slack channel ID and name to team assignments and auto-creation settings that control how issues are created from Slack messages in this channel." type SlackChannelNameMapping {
   "The Slack channel ID."   id: String!
   "The Slack channel name."   name: String!
   "Whether or not the Slack channel is private."   isPrivate: Boolean
@@ -8856,38 +9755,116 @@ type SsoUrlFromEmailResponse {
   "SAML SSO sign-in URL."   samlSsoUrl: String!
 }
 
+type Subscription {
+  "Triggered when a comment is created"   commentCreated: Comment!
+  "Triggered when a comment is updated"   commentUpdated: Comment!
+  "Triggered when a comment is archived"   commentArchived: Comment!
+  "Triggered when a a comment is unarchived"   commentUnarchived: Comment!
+  "Triggered when a comment is deleted"   commentDeleted: Comment!
+  "Triggered when a cycle is created"   cycleCreated: Cycle!
+  "Triggered when a cycle is updated"   cycleUpdated: Cycle!
+  "Triggered when a cycle is archived"   cycleArchived: Cycle!
+  "Triggered when a document is created"   documentCreated: Document!
+  "Triggered when a document is updated"   documentUpdated: Document!
+  "Triggered when a document is archived"   documentArchived: Document!
+  "Triggered when a a document is unarchived"   documentUnarchived: Document!
+  "Triggered when a document content is created"   documentContentCreated: DocumentContent!
+  "Triggered when a document content is updated"   documentContentUpdated: DocumentContent!
+  "Triggered when a document content draft is created"   documentContentDraftCreated: DocumentContentDraft!
+  "Triggered when a document content draft is updated"   documentContentDraftUpdated: DocumentContentDraft!
+  "Triggered when a document content draft is deleted"   documentContentDraftDeleted: DocumentContentDraft!
+  "Triggered when a draft is created"   draftCreated: Draft!
+  "Triggered when a draft is updated"   draftUpdated: Draft!
+  "Triggered when a draft is deleted"   draftDeleted: Draft!
+  "Triggered when a favorite is created"   favoriteCreated: Favorite!
+  "Triggered when a favorite is updated"   favoriteUpdated: Favorite!
+  "Triggered when a favorite is deleted"   favoriteDeleted: Favorite!
+  "Triggered when an issue is created"   issueCreated(filter: IssueSubscriptionFilter): Issue!
+  "Triggered when an issue is updated"   issueUpdated(filter: IssueSubscriptionFilter): Issue!
+  "Triggered when an issue is archived"   issueArchived: Issue!
+  "Triggered when a an issue is unarchived"   issueUnarchived: Issue!
+  "Triggered when an issue history is created"   issueHistoryCreated: IssueHistory!
+  "Triggered when an issue history is updated"   issueHistoryUpdated: IssueHistory!
+  "Triggered when an issue draft is created"   issueDraftCreated: IssueDraft!
+  "Triggered when an issue draft is updated"   issueDraftUpdated: IssueDraft!
+  "Triggered when an issue draft is deleted"   issueDraftDeleted: IssueDraft!
+  "Triggered when an issue label is created"   issueLabelCreated: IssueLabel!
+  "Triggered when an issue label is updated"   issueLabelUpdated: IssueLabel!
+  "Triggered when an issue label is deleted"   issueLabelDeleted: IssueLabel!
+  "Triggered when an issue relation is created"   issueRelationCreated: IssueRelation!
+  "Triggered when an issue relation is updated"   issueRelationUpdated: IssueRelation!
+  "Triggered when an issue relation is deleted"   issueRelationDeleted: IssueRelation!
+  "Triggered when a notification is created"   notificationCreated: Notification!
+  "Triggered when a notification is updated"   notificationUpdated: Notification!
+  "Triggered when a notification is archived"   notificationArchived: Notification!
+  "Triggered when a a notification is unarchived"   notificationUnarchived: Notification!
+  "Triggered when a notification is deleted"   notificationDeleted: Notification!
+  "Triggered when an organization is updated"   organizationUpdated: Organization!
+  "Triggered when a project is created"   projectCreated: Project!
+  "Triggered when a project is updated"   projectUpdated: Project!
+  "Triggered when a project is archived"   projectArchived: Project!
+  "Triggered when a a project is unarchived"   projectUnarchived: Project!
+  "Triggered when a project update is created"   projectUpdateCreated: ProjectUpdate!
+  "Triggered when a project update is updated"   projectUpdateUpdated: ProjectUpdate!
+  "Triggered when a project update is deleted"   projectUpdateDeleted: ProjectUpdate!
+  "Triggered when a roadmap is created"   roadmapCreated: Roadmap!
+  "Triggered when a roadmap is updated"   roadmapUpdated: Roadmap!
+  "Triggered when a roadmap is deleted"   roadmapDeleted: Roadmap!
+  "Triggered when an initiative is created"   initiativeCreated: Initiative!
+  "Triggered when an initiative is updated"   initiativeUpdated: Initiative!
+  "Triggered when an initiative is deleted"   initiativeDeleted: Initiative!
+  "Triggered when an agent session is created"   agentSessionCreated: AgentSession!
+  "Triggered when an agent session is updated"   agentSessionUpdated: AgentSession!
+  "Triggered when an agent activity is created"   agentActivityCreated: AgentActivity!
+  "Triggered when an agent activity is updated"   agentActivityUpdated: AgentActivity!
+  "Triggered when an ai conversation is updated"   aiConversationUpdated: AiConversation!
+  "Triggered when an ai prompt progress is created"   aiPromptProgressCreated(filter: AiPromptProgressSubscriptionFilter): AiPromptProgress!
+  "Triggered when an ai prompt progress is updated"   aiPromptProgressUpdated(filter: AiPromptProgressSubscriptionFilter): AiPromptProgress!
+  "Triggered when a team is created"   teamCreated: Team!
+  "Triggered when a team is updated"   teamUpdated: Team!
+  "Triggered when a team is deleted"   teamDeleted: Team!
+  "Triggered when a team membership is created"   teamMembershipCreated: TeamMembership!
+  "Triggered when a team membership is updated"   teamMembershipUpdated: TeamMembership!
+  "Triggered when a team membership is deleted"   teamMembershipDeleted: TeamMembership!
+  "Triggered when an user is created"   userCreated: User!
+  "Triggered when an user is updated"   userUpdated: User!
+  "Triggered when a workflow state is created"   workflowStateCreated: WorkflowState!
+  "Triggered when a workflow state is updated"   workflowStateUpdated: WorkflowState!
+  "Triggered when a workflow state is archived"   workflowStateArchived: WorkflowState!
+}
+
 type SuccessPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"An AI-generated summary." type Summary implements Node {
+"An AI-generated summary of an issue. Each issue can have at most one summary. The summary content is stored as ProseMirror data and tracks its generation status and timing." type Summary implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The issue this summary belongs to."   issue: Issue!
-  "The summary content as a Prosemirror document."   content: JSONObject!
-  "The evaluation log id for this summary generation."   evalLogId: String
-  "The generation status of the summary."   generationStatus: SummaryGenerationStatus!
-  "The time at which the summary was generated."   generatedAt: DateTime!
-}
-
-"A comment thread that is synced with an external source." type SyncedExternalThread {
-  id: ID
-  "The type of the external source."   type: String!
-  "The sub type of the external source."   subType: String
-  "The display name of the source."   name: String
-  "The display name of the thread."   displayName: String
-  "The external url of the thread."   url: String
-  "Whether this thread is syncing with the external service."   isConnected: Boolean!
-  "Whether the current user has the corresponding personal integration connected for the external service."   isPersonalIntegrationConnected: Boolean!
-  "Whether a connected personal integration is required to comment in this thread."   isPersonalIntegrationRequired: Boolean!
-}
-
-"An organizational unit that contains issues." type Team implements Node {
+  "The issue that this summary was generated for."   issue: Issue!
+  "The summary content as a ProseMirror document containing the AI-generated summary text."   content: JSONObject!
+  "The evaluation log ID for this summary generation, used for tracking and debugging AI output quality. Null if not available."   evalLogId: String
+  "The current generation status of the summary, indicating whether generation is in progress, completed, or failed."   generationStatus: SummaryGenerationStatus!
+  "The time at which the summary content was generated or last regenerated."   generatedAt: DateTime!
+}
+
+"A comment thread that is synced with an external source such as Slack, Jira, GitHub, Salesforce, or email. Provides information about the external thread's origin, its current sync status, and whether the user has the necessary personal integration connected to participate in the thread." type SyncedExternalThread {
+  "The unique identifier of this synced external thread. Auto-generated if not provided."   id: ID
+  "The category of the external source (e.g., 'integration' for service integrations, 'email' for email-based threads)."   type: String!
+  "The specific integration service for the external source (e.g., 'slack', 'jira', 'github', 'salesforce'). Null if the source type does not have a sub-type."   subType: String
+  "A human-readable display name for the external source (e.g., 'Slack', 'Jira', 'GitHub')."   name: String
+  "A human-readable display name for the thread, derived from the external source. For Slack threads this is the channel name, for Jira it's the issue key, for email it's the sender name and count of other participants."   displayName: String
+  "A URL linking to the thread in the external service. For example, a Slack message permalink, a Jira issue URL, or a GitHub issue URL."   url: String
+  "Whether this thread is currently syncing comments bidirectionally with the external service. False if the external entity relation has been removed or if the thread was explicitly unsynced."   isConnected: Boolean!
+  "Whether the current user has a working personal integration connected for the external service. For example, whether they have connected their personal Jira, GitHub, or Slack account. A connected personal integration may still return false if it has an authentication error."   isPersonalIntegrationConnected: Boolean!
+  "Whether a connected personal integration is required to post comments in this synced thread. True for Jira and GitHub threads, where comments must be attributed to a specific user in the external system. False for Slack and other services where the workspace integration can post on behalf of users."   isPersonalIntegrationRequired: Boolean!
+}
+
+"A team is the primary organizational unit in Linear. Issues belong to teams, and each team has its own workflow states, cycles, labels, and settings. Teams can be public (visible to all workspace members) or private (visible only to team members). Teams can also have sub-teams that inherit settings from their parent." type Team implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -8895,17 +9872,17 @@ type SuccessPayload {
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The team's name."   name: String!
-  "The team's unique key. The key is used in URLs."   key: String!
+  "The team's unique key, used as a prefix in issue identifiers (e.g., 'ENG' in 'ENG-123') and in URLs."   key: String!
   "The team's description."   description: String
   "The icon of the team."   icon: String
   "The team's color."   color: String
-  "The time at which the team was retired. Null if the team has not been retired."   retiredAt: DateTime
-  "The organization that the team is associated with."   organization: Organization!
-  "[Internal] The team's parent team."   parent: Team
+  "The time at which the team was retired. Retired teams no longer accept new issues or members. Null if the team has not been retired."   retiredAt: DateTime
+  "The workspace that the team belongs to."   organization: Organization!
+  "The team's parent team."   parent: Team
   "[Internal] The team's sub-teams."   children: [Team!]!
-  "Whether the team uses cycles."   cyclesEnabled: Boolean!
-  "The day of the week that a new cycle starts."   cycleStartDay: Float!
-  "The duration of a cycle in weeks."   cycleDuration: Float!
+  "Whether the team uses cycles for sprint-style issue management."   cyclesEnabled: Boolean!
+  "The day of the week that a new cycle starts (0 = Sunday, 1 = Monday, ..., 6 = Saturday)."   cycleStartDay: Float!
+  "The duration of each cycle in weeks."   cycleDuration: Float!
   "The cooldown time after each cycle in weeks."   cycleCooldownTime: Float!
   "Auto assign started issues to current cycle."   cycleIssueAutoAssignStarted: Boolean!
   "Auto assign completed issues to current cycle."   cycleIssueAutoAssignCompleted: Boolean!
@@ -8920,7 +9897,7 @@ type SuccessPayload {
   "Where to move issues when changing state."   setIssueSortOrderOnStateChange: String!
   "Whether to add additional points to the estimate scale."   issueEstimationExtended: Boolean!
   "What to use as a default estimate for unestimated issues."   defaultIssueEstimate: Float!
-  "Whether triage mode is enabled for the team or not."   triageEnabled: Boolean!
+  "Whether triage mode is enabled for the team. When enabled, issues created by non-members or integrations are routed to a triage state for review before entering the normal workflow."   triageEnabled: Boolean!
   "Whether an issue needs to have a priority set before leaving triage."   requirePriorityToLeaveTriage: Boolean!
   "The default workflow state into which issues are set when they are opened by team members."   defaultIssueState: WorkflowState
   "The default template to use for new issues created by members of the team."   defaultTemplateForMembers: Template
@@ -8929,12 +9906,12 @@ type SuccessPayload {
   "The id of the default template to use for new issues created by non-members of the team."   defaultTemplateForNonMembersId: String @deprecated(reason: "Use defaultTemplateForNonMembers instead")
   "The default template to use for new projects created for the team."   defaultProjectTemplate: Template
   "The workflow state into which issues are set when they are opened by non-team members or integrations if triage is enabled."   triageIssueState: WorkflowState
-  "Whether the team is private or not."   private: Boolean!
+  "Whether the team is private. Private teams are only visible to their members and require an explicit invitation to join."   private: Boolean!
   "Whether all members in the workspace can join the team. Only used for public teams."   allMembersCanJoin: Boolean
-  "Security settings for the team."   securitySettings: JSONObject!
+  "Security settings for the team, including role-based restrictions for issue sharing, label management, member management, and template management."   securitySettings: JSONObject!
   "[Internal] Facets associated with the team."   facets: [Facet!]!
   "[Internal] Posts associated with the team."   posts: [Post!]!
-  "Whether the team is managed by SCIM integration."   scimManaged: Boolean!
+  "Whether the team is managed by a SCIM integration. SCIM-managed teams have their membership controlled by the identity provider."   scimManaged: Boolean!
   "The SCIM group name for the team."   scimGroupName: String
   "[Internal] The progress history of the team."   progressHistory: JSONObject!
   "[Internal] The current progress of the team."   currentProgress: JSONObject!
@@ -8951,22 +9928,26 @@ type SuccessPayload {
   "Whether to send new issue status updates to Slack."   slackIssueStatuses: Boolean! @deprecated(reason: "No longer in use")
   "Period after which issues are automatically closed in months. Null/undefined means disabled."   autoClosePeriod: Float
   "The canceled workflow state which auto closed issues will be set to. Defaults to the first canceled state."   autoCloseStateId: String
-  "Period after which automatically closed and completed issues are automatically archived in months."   autoArchivePeriod: Float!
+  "Period after which automatically closed, completed, and duplicate issues are automatically archived in months."   autoArchivePeriod: Float!
   "Whether parent issues should automatically close when all child issues are closed"   autoCloseParentIssues: Boolean
   "Whether child issues should automatically close when their parent issue is closed"   autoCloseChildIssues: Boolean
   "The workflow state into which issues are moved when they are marked as a duplicate of another issue. Defaults to the first canceled state."   markedAsDuplicateWorkflowState: WorkflowState
   "[Internal] Whether new users should join this team by default."   joinByDefault: Boolean
+  "[Internal] Whether the team should inherit its Slack auto-create project channel setting from its parent. Only applies to sub-teams."   inheritSlackAutoCreateProjectChannel: Boolean!
+  "[Internal] Whether to automatically create a Slack channel when a new project is created in this team."   slackAutoCreateProjectChannel: Boolean
   "Calendar feed URL (iCal) for cycles."   cycleCalenderUrl: String!
   "The name of the team including its parent team name if it has one."   displayName: String!
-  "Issues associated with the team."   issues(includeSubTeams: Boolean = false, filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
-  "Number of issues in the team."   issueCount(includeArchived: Boolean = false): Int!
+  "[Internal] The team's ancestor teams, ordered from the root to the immediate parent."   ancestors: [Team!]!
+  "Issues belonging to the team. Supports filtering and optional inclusion of sub-team issues."   issues(includeSubTeams: Boolean = false, filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
+  "The total number of issues in the team. By default excludes archived issues; use the includeArchived argument to include them."   issueCount(includeArchived: Boolean = false): Int!
   "Cycles associated with the team."   cycles(filter: CycleFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): CycleConnection!
   "Team's currently active cycle."   activeCycle: Cycle
   "Team's triage responsibility."   triageResponsibility: TriageResponsibility
-  "Users who are members of this team."   members(filter: UserFilter, includeDisabled: Boolean, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): UserConnection!
+  "Users who are members of this team. Supports filtering and pagination."   members(filter: UserFilter, includeDisabled: Boolean, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): UserConnection!
   "[ALPHA] The membership of the given user in the team."   membership(userId: String!): TeamMembership
   "Memberships associated with the team. For easier access of the same data, use `members` query."   memberships(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TeamMembershipConnection!
   "Projects associated with the team."   projects(includeSubTeams: Boolean = false, filter: ProjectFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy, sort: [ProjectSortInput!]): ProjectConnection!
+  "[ALPHA] Release pipelines associated with the team."   releasePipelines(filter: ReleasePipelineFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): ReleasePipelineConnection!
   "The states that define the workflow associated with the team."   states(filter: WorkflowStateFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): WorkflowStateConnection!
   "The Git automation states for the team."   gitAutomationStates(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): GitAutomationStateConnection!
   "Templates associated with the team."   templates(filter: NullableTemplateFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TemplateConnection!
@@ -8994,7 +9975,7 @@ type TeamEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"Defines the membership of a user to a team." type TeamMembership implements Node {
+"A join entity that defines a user's membership in a team. Each membership record links a user to a team and tracks whether the user is a team owner. Users can be members of multiple teams, and their memberships determine which teams' issues and resources they can access." type TeamMembership implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -9003,8 +9984,8 @@ type TeamEdge {
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The user that the membership is associated with."   user: User!
   "The team that the membership is associated with."   team: Team!
-  "Whether the user is an owner of the team."   owner: Boolean!
-  "The order of the item in the users team list."   sortOrder: Float!
+  "Whether the user is an owner of the team. Team owners have elevated permissions for managing team settings, members, and resources."   owner: Boolean!
+  "The sort order of this team in the user's personal team list. Lower values appear first."   sortOrder: Float!
 }
 
 type TeamMembershipConnection {
@@ -9018,58 +9999,60 @@ type TeamMembershipEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type TeamMembershipPayload {
+"Team membership operation response." type TeamMembershipPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The team membership that was created or updated."   teamMembership: TeamMembership
   "Whether the operation was successful."   success: Boolean!
 }
 
-"A team notification subscription." type TeamNotificationSubscription implements NotificationSubscription & Entity & Node {
+"A notification subscription scoped to a specific team. The subscriber receives notifications for events related to issues and activity in this team." type TeamNotificationSubscription implements NotificationSubscription & Entity & Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The user that subscribed to receive notifications."   subscriber: User!
-  "The customer associated with the notification subscription."   customer: Customer
-  "The contextual custom view associated with the notification subscription."   customView: CustomView
-  "The contextual cycle view associated with the notification subscription."   cycle: Cycle
-  "The contextual label view associated with the notification subscription."   label: IssueLabel
-  "The contextual project view associated with the notification subscription."   project: Project
-  "The contextual initiative view associated with the notification subscription."   initiative: Initiative
+  "The user who will receive notifications from this subscription."   subscriber: User!
+  "The customer that this notification subscription is scoped to. Null if the subscription targets a different entity type."   customer: Customer
+  "The custom view that this notification subscription is scoped to. Null if the subscription targets a different entity type."   customView: CustomView
+  "The cycle that this notification subscription is scoped to. Null if the subscription targets a different entity type."   cycle: Cycle
+  "The issue label that this notification subscription is scoped to. Null if the subscription targets a different entity type."   label: IssueLabel
+  "The project that this notification subscription is scoped to. Null if the subscription targets a different entity type."   project: Project
+  "The initiative that this notification subscription is scoped to. Null if the subscription targets a different entity type."   initiative: Initiative
   "The team subscribed to."   team: Team!
-  "The user view associated with the notification subscription."   user: User
-  "The type of view to which the notification subscription context is associated with."   contextViewType: ContextViewType
-  "The type of user view to which the notification subscription context is associated with."   userContextViewType: UserContextViewType
-  "Whether the subscription is active or not."   active: Boolean!
-  "The type of subscription."   notificationSubscriptionTypes: [String!]!
+  "The user that this notification subscription is scoped to, for user-specific view subscriptions. Null if the subscription targets a different entity type."   user: User
+  "The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type."   contextViewType: ContextViewType
+  "The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type."   userContextViewType: UserContextViewType
+  "Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists."   active: Boolean!
+  "The notification event types that this subscription will deliver to the subscriber."   notificationSubscriptionTypes: [String!]!
 }
 
-type TeamPayload {
+"Team operation response." type TeamPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The team that was created or updated."   team: Team
   "Whether the operation was successful."   success: Boolean!
 }
 
-"A template object used for creating entities faster." type Template implements Node {
+"A reusable template for creating issues, projects, or documents. Templates store pre-filled field values and content as JSON data. They can be scoped to a specific team or shared across the entire workspace. Team-scoped templates may be inherited from parent teams." type Template implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The entity type this template is for."   type: String!
+  "The entity type this template is for, such as 'issue', 'project', or 'document'."   type: String!
   "The name of the template."   name: String!
-  "Template description."   description: String
-  "Template data."   templateData: JSON!
-  "The sort order of the template."   sortOrder: Float!
-  "The date when the template was last applied."   lastAppliedAt: DateTime
-  "The organization that the template is associated with. If null, the template is associated with a particular team."   organization: Organization!
+  "A description of what the template is used for."   description: String
+  "The icon of the template, either a decorative icon type or an emoji string. Null if no icon has been set."   icon: String
+  "The hex color of the template icon. Null if no custom color has been set."   color: String
+  "The template data as a JSON-encoded string containing the pre-filled attributes for the entity type (e.g., issue fields, project configuration, or document content)."   templateData: JSON!
+  "The sort order of the template within the templates list."   sortOrder: Float!
+  "The date when the template was last applied to create or update an entity. Null if the template has never been applied."   lastAppliedAt: DateTime
+  "The workspace that owns this template."   organization: Organization!
   "The team that the template is associated with. If null, the template is global to the workspace."   team: Team
-  "The user who created the template."   creator: User
-  "The user who last updated the template."   lastUpdatedBy: User
-  "The original template inherited from."   inheritedFrom: Template
+  "The user who created the template. Null if the creator's account has been deleted."   creator: User
+  "The user who last updated the template. Null if the user's account has been deleted."   lastUpdatedBy: User
+  "The parent team template this template was inherited from. Null for original (non-inherited) templates."   inheritedFrom: Template
   "[Internal] Whether the template has form fields"   hasFormFields: Boolean!
 }
 
@@ -9084,13 +10067,13 @@ type TemplateEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type TemplatePayload {
+"The result of a template mutation." type TemplatePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The template that was created or updated."   template: Template!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"A time schedule." type TimeSchedule implements Node {
+"A time-based schedule defining on-call rotations or availability windows. Schedules contain a series of time entries, each specifying a user and their active period. They can be synced from external services (such as PagerDuty or Opsgenie) via integrations, or created manually. Schedules are used by triage responsibilities to determine who should be assigned or notified when issues enter triage." type TimeSchedule implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -9101,7 +10084,7 @@ type TemplatePayload {
   "The schedule entries."   entries: [TimeScheduleEntry!]
   "The identifier of the external schedule."   externalId: String
   "The URL to the external schedule."   externalUrl: String
-  "The organization of the schedule."   organization: Organization!
+  "The workspace of the schedule."   organization: Organization!
   "The identifier of the Linear integration populating the schedule."   integration: Integration
 }
 
@@ -9116,20 +10099,20 @@ type TimeScheduleEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type TimeScheduleEntry {
-  "The start date of the schedule in ISO 8601 date-time format."   startsAt: DateTime!
-  "The end date of the schedule in ISO 8601 date-time format."   endsAt: DateTime!
+"A single entry in a time schedule, defining a time range and the user responsible during that period." type TimeScheduleEntry {
+  "The start time of the schedule entry in ISO 8601 date-time format."   startsAt: DateTime!
+  "The end time of the schedule entry in ISO 8601 date-time format."   endsAt: DateTime!
   "The Linear user id of the user on schedule. If the user cannot be mapped to a Linear user then `userEmail` can be used as a reference."   userId: String
   "The email, name or reference to the user on schedule. This is used in case the external user could not be mapped to a Linear user id."   userEmail: String
 }
 
-type TimeSchedulePayload {
+"The result of a time schedule mutation." type TimeSchedulePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  timeSchedule: TimeSchedule!
+  "The time schedule that was created or updated."   timeSchedule: TimeSchedule!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"A team's triage responsibility." type TriageResponsibility implements Node {
+"A team's triage responsibility configuration that defines how issues entering triage are handled. Each team can have one triage responsibility, which specifies the action to take (notify or assign) and the responsible users, determined either by a manual selection of specific users or by an on-call time schedule." type TriageResponsibility implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -9154,25 +10137,25 @@ type TriageResponsibilityEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type TriageResponsibilityManualSelection {
+"Manual triage responsibility configuration specifying a set of users to assign triaged issues to, with optional round-robin rotation." type TriageResponsibilityManualSelection {
   "The set of users responsible for triage."   userIds: [String!]!
   "[Internal] The index of the current userId used for the assign action when having more than one user."   assignmentIndex: Int
 }
 
-type TriageResponsibilityPayload {
+"The result of a triage responsibility mutation." type TriageResponsibilityPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  triageResponsibility: TriageResponsibility!
+  "The triage responsibility that was created or updated."   triageResponsibility: TriageResponsibility!
   "Whether the operation was successful."   success: Boolean!
 }
 
-"Object representing Google Cloud upload policy, plus additional data." type UploadFile {
+"Represents a file upload destination with a pre-signed upload URL, asset URL, and required request headers for uploading to cloud storage." type UploadFile {
   "The filename."   filename: String!
   "The content type."   contentType: String!
   "The size of the uploaded file."   size: Int!
-  "The signed URL the for the uploaded file. (assigned automatically)."   uploadUrl: String!
-  "The asset URL for the uploaded file. (assigned automatically)."   assetUrl: String!
-  metaData: JSONObject
-  headers: [UploadFileHeader!]!
+  "The pre-signed URL to which the file should be uploaded via a PUT request."   uploadUrl: String!
+  "The permanent asset URL where the file will be accessible after upload."   assetUrl: String!
+  "Optional metadata associated with the upload, such as the related issue or comment ID."   metaData: JSONObject
+  "HTTP headers that must be included in the PUT request to the upload URL."   headers: [UploadFileHeader!]!
 }
 
 type UploadFileHeader {
@@ -9182,11 +10165,11 @@ type UploadFileHeader {
 
 type UploadPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
-  "Object describing the file to be uploaded."   uploadFile: UploadFile
+  "The upload file details including signed URL, asset URL, and required headers. Null if the upload could not be prepared."   uploadFile: UploadFile
   "Whether the operation was successful."   success: Boolean!
 }
 
-"A user that has access to the the resources of an organization." type User implements Node {
+"A user that belongs to a workspace. Users can have different roles (admin, member, guest, or app) that determine their level of access. Users can be members of multiple teams, and can be active or deactivated. Guest users have limited access scoped to specific teams they are invited to." type User implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -9194,47 +10177,47 @@ type UploadPayload {
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The user's full name."   name: String!
-  "The user's display (nick) name. Unique within each organization."   displayName: String!
+  "The user's display (nick) name. Must be unique within the workspace."   displayName: String!
   "The user's email address."   email: String!
   "An URL to the user's avatar image."   avatarUrl: String
-  "Reason why is the account disabled."   disableReason: String
+  "The reason why the user account is disabled. Null if the user is active. Possible values include admin suspension, downgrade, voluntary departure, or pending invite."   disableReason: String
   "[DEPRECATED] Hash for the user to be used in calendar URLs."   calendarHash: String
-  "A short description of the user, either its title or bio."   description: String
-  "The emoji to represent the user current status."   statusEmoji: String
-  "The label of the user current status."   statusLabel: String
-  "A date at which the user current status should be cleared."   statusUntilAt: DateTime
+  "A short description of the user, such as their title or a brief bio."   description: String
+  "The user's job title."   title: String
+  "The emoji representing the user's current status. Null if no status is set."   statusEmoji: String
+  "The text label of the user's current status. Null if no status is set."   statusLabel: String
+  "The date and time at which the user's current status should be automatically cleared. Null if the status has no expiration."   statusUntilAt: DateTime
   "The local timezone of the user."   timezone: String
-  "Organization the user belongs to."   organization: Organization!
-  "The last time the user was seen online."   lastSeen: DateTime
+  "The workspace that the user belongs to."   organization: Organization!
+  "The last time the user was seen online. Updated based on user activity. Null if the user has never been seen."   lastSeen: DateTime
   "[INTERNAL] Identity provider the user is managed by."   identityProvider: IdentityProvider
   "The initials of the user."   initials: String!
   "The background color of the avatar for users without set avatar."   avatarBackgroundColor: String!
   "Whether the user is a guest in the workspace and limited to accessing a subset of teams."   guest: Boolean!
   "Whether the user is an app."   app: Boolean!
   "Whether the user is mentionable."   isMentionable: Boolean!
-  "Whether the user is assignable."   isAssignable: Boolean!
   "Whether the user account is active or disabled (suspended)."   active: Boolean!
-  "Enabled feature flags for the user."   featureFlags: [String!]!
-  "The user's issue drafts"   issueDrafts(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueDraftConnection!
-  "The user's drafts"   drafts(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): DraftConnection!
+  "Issue drafts that the user has created but not yet submitted."   issueDrafts(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueDraftConnection!
+  "The user's saved drafts."   drafts(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): DraftConnection!
   "User's profile URL."   url: String!
   "Issues assigned to the user."   assignedIssues(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
   "Issues delegated to this user."   delegatedIssues(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
   "Issues created by the user."   createdIssues(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
   "Number of issues created."   createdIssueCount: Int!
-  "Teams the user is part of."   teams(filter: TeamFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TeamConnection!
+  "Teams the user is a member of. Supports filtering by team properties."   teams(filter: TeamFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TeamConnection!
   "Memberships associated with the user. For easier access of the same data, use `teams` query."   teamMemberships(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): TeamMembershipConnection!
   "[INTERNAL] The user's pinned feeds."   feedFacets(before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): FacetConnection!
-  "Whether this user can access any public team in the organization."   canAccessAnyPublicTeam: Boolean!
+  "Whether this user can access any public team in the workspace. True for non-guest members and app users with public team access."   canAccessAnyPublicTeam: Boolean!
   "Whether the user is the currently authenticated user."   isMe: Boolean!
-  "Whether the user is an organization administrator."   admin: Boolean!
-  "Whether the user is an organization owner."   owner: Boolean!
+  "Whether the user is a workspace administrator. On Free plans, all members are treated as admins."   admin: Boolean!
+  "Whether the user is a workspace owner, which is the highest permission level."   owner: Boolean!
+  "Whether the user can be assigned to issues. Regular users are always assignable; app users are assignable only if they have the app:assignable scope."   isAssignable: Boolean!
   "Whether this agent user supports agent sessions."   supportsAgentSessions: Boolean!
   "[DEPRECATED] Unique hash for the user to be used in invite URLs."   inviteHash: String! @deprecated(reason: "This hash is not in use anymore, this value will always be empty.")
   "The user's GitHub user ID."   gitHubUserId: String
 }
 
-type UserAdminPayload {
+"User admin operation response." type UserAdminPayload {
   "Whether the operation was successful."   success: Boolean!
 }
 
@@ -9249,35 +10232,35 @@ type UserEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"A user notification subscription." type UserNotificationSubscription implements NotificationSubscription & Entity & Node {
+"A notification subscription scoped to a specific user view. The subscriber receives notifications for events in the context of a particular user's activity view." type UserNotificationSubscription implements NotificationSubscription & Entity & Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The user that subscribed to receive notifications."   subscriber: User!
-  "The customer associated with the notification subscription."   customer: Customer
-  "The contextual custom view associated with the notification subscription."   customView: CustomView
-  "The contextual cycle view associated with the notification subscription."   cycle: Cycle
-  "The contextual label view associated with the notification subscription."   label: IssueLabel
-  "The contextual project view associated with the notification subscription."   project: Project
-  "The contextual initiative view associated with the notification subscription."   initiative: Initiative
-  "The team associated with the notification subscription."   team: Team
+  "The user who will receive notifications from this subscription."   subscriber: User!
+  "The customer that this notification subscription is scoped to. Null if the subscription targets a different entity type."   customer: Customer
+  "The custom view that this notification subscription is scoped to. Null if the subscription targets a different entity type."   customView: CustomView
+  "The cycle that this notification subscription is scoped to. Null if the subscription targets a different entity type."   cycle: Cycle
+  "The issue label that this notification subscription is scoped to. Null if the subscription targets a different entity type."   label: IssueLabel
+  "The project that this notification subscription is scoped to. Null if the subscription targets a different entity type."   project: Project
+  "The initiative that this notification subscription is scoped to. Null if the subscription targets a different entity type."   initiative: Initiative
+  "The team that this notification subscription is scoped to. Null if the subscription targets a different entity type."   team: Team
   "The user subscribed to."   user: User!
-  "The type of view to which the notification subscription context is associated with."   contextViewType: ContextViewType
-  "The type of user view to which the notification subscription context is associated with."   userContextViewType: UserContextViewType
-  "Whether the subscription is active or not."   active: Boolean!
-  "The type of subscription."   notificationSubscriptionTypes: [String!]!
+  "The type of contextual view (e.g., active issues, backlog) that further scopes a team notification subscription. Null if the subscription is not associated with a specific view type."   contextViewType: ContextViewType
+  "The type of user-specific view that further scopes a user notification subscription. Null if the subscription is not associated with a user view type."   userContextViewType: UserContextViewType
+  "Whether the subscription is active. When inactive, no notifications are generated from this subscription even though it still exists."   active: Boolean!
+  "The notification event types that this subscription will deliver to the subscriber."   notificationSubscriptionTypes: [String!]!
 }
 
-type UserPayload {
+"User operation response." type UserPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The user that was created or updated."   user: User
   "Whether the operation was successful."   success: Boolean!
 }
 
-"The settings of a user as a JSON object." type UserSettings implements Node {
+"Per-user settings and preferences for a workspace member. Includes notification delivery preferences, email subscription settings, notification category and channel preferences, theme configuration, and various UI preferences. Each user has exactly one UserSettings record per workspace." type UserSettings implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -9286,98 +10269,308 @@ type UserPayload {
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
   "The notification delivery preferences for the user. Note: notificationDisabled field is deprecated in favor of notificationChannelPreferences."   notificationDeliveryPreferences: NotificationDeliveryPreferences!
   "The email types the user has unsubscribed from."   unsubscribedFrom: [String!]! @deprecated(reason: "Use individual subscription fields instead. This field's value is now outdated.")
-  "The user associated with these settings."   user: User!
-  "Hash for the user to be used in calendar URLs."   calendarHash: String
-  "Whether this user is subscribed to changelog email or not."   subscribedToChangelog: Boolean!
-  "Whether this user is subscribed to DPA emails or not."   subscribedToDPA: Boolean!
-  "Whether this user is subscribed to invite accepted emails or not."   subscribedToInviteAccepted: Boolean!
-  "Whether this user is subscribed to privacy and legal update emails or not."   subscribedToPrivacyLegalUpdates: Boolean!
-  "The user's feed summary schedule preference."   feedSummarySchedule: FeedSummarySchedule
+  "The user that these settings belong to."   user: User!
+  "A unique hash for the user, used to construct secure calendar subscription URLs."   calendarHash: String
+  "Whether this user is subscribed to receive changelog emails about Linear product updates."   subscribedToChangelog: Boolean!
+  "Whether this user is subscribed to receive Data Processing Agreement (DPA) related emails."   subscribedToDPA: Boolean!
+  "Whether this user is subscribed to receive email notifications when their workspace invitations are accepted."   subscribedToInviteAccepted: Boolean!
+  "Whether this user is subscribed to receive emails about privacy policy and legal updates."   subscribedToPrivacyLegalUpdates: Boolean!
+  "The user's preferred schedule for receiving feed summary digests. Null if the user has not set a preference and will use the workspace default."   feedSummarySchedule: FeedSummarySchedule
   "Whether to show full user names instead of display names."   showFullUserNames: Boolean!
   "The user's last seen time for the pulse feed."   feedLastSeenTime: DateTime
   "Whether to auto-assign newly created issues to the current user by default."   autoAssignToSelf: Boolean!
-  "The user's notification category preferences."   notificationCategoryPreferences: NotificationCategoryPreferences!
-  "The user's notification channel preferences."   notificationChannelPreferences: NotificationChannelPreferences!
-  "The user's theme for a given mode and device type."   theme(deviceType: UserSettingsThemeDeviceType = desktop, mode: UserSettingsThemeMode = light): UserSettingsTheme
+  "The user's notification category preferences, indicating which notification categories are enabled or disabled per notification channel."   notificationCategoryPreferences: NotificationCategoryPreferences!
+  "The user's notification channel preferences, indicating which notification delivery channels (email, in-app, mobile push, Slack) are enabled."   notificationChannelPreferences: NotificationChannelPreferences!
+  "The user's theme configuration for the specified color mode (light/dark) and device type (desktop/mobile). Returns null if no valid theme preset is configured."   theme(deviceType: UserSettingsThemeDeviceType = desktop, mode: UserSettingsThemeMode = light): UserSettingsTheme
 }
 
-type UserSettingsCustomSidebarTheme {
+"Custom sidebar theme definition with accent, base colors and contrast." type UserSettingsCustomSidebarTheme {
   "The accent color in LCH format."   accent: [Float!]!
   "The base color in LCH format."   base: [Float!]!
   "The contrast value."   contrast: Int!
 }
 
-type UserSettingsCustomTheme {
+"Custom theme definition with accent, base colors, contrast, and optional sidebar theme." type UserSettingsCustomTheme {
   "The accent color in LCH format."   accent: [Float!]!
   "The base color in LCH format."   base: [Float!]!
   "The contrast value."   contrast: Int!
   "Optional sidebar theme colors."   sidebar: UserSettingsCustomSidebarTheme
 }
 
-type UserSettingsFlagPayload {
+"User settings flag update response." type UserSettingsFlagPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The flag key which was updated."   flag: String
   "The flag value after update."   value: Int
   "Whether the operation was successful."   success: Boolean!
 }
 
-type UserSettingsFlagsResetPayload {
+"User settings flags reset response." type UserSettingsFlagsResetPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "Whether the operation was successful."   success: Boolean!
 }
 
-type UserSettingsPayload {
+"User settings operation response." type UserSettingsPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The user's settings."   userSettings: UserSettings!
   "Whether the operation was successful."   success: Boolean!
 }
 
-type UserSettingsTheme {
+"The user's resolved theme configuration for a specific color mode and device type." type UserSettingsTheme {
   "The theme preset."   preset: UserSettingsThemePreset!
   "The custom theme definition, only present when preset is 'custom'."   custom: UserSettingsCustomTheme
 }
 
-"View preferences." type ViewPreferences implements Node {
+"The display preferences for a view, controlling layout mode (list, board, spreadsheet), grouping, sorting, column visibility, and other visual settings. View preferences exist at two levels: organization-wide defaults and per-user overrides. The effective preferences are computed by merging both layers, with user preferences taking priority." type ViewPreferences implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The view preference type."   type: String!
-  "The view type."   viewType: String!
-  "The view preferences"   preferences: ViewPreferencesValues!
+  "The type of view preferences: \"organization\" for workspace-wide defaults or \"user\" for personal overrides."   type: String!
+  "The type of view these preferences apply to, such as board, cycle, project, customView, myIssues, etc."   viewType: String!
+  "The view preferences values, containing layout, grouping, sorting, and field visibility settings."   preferences: ViewPreferencesValues!
 }
 
-type ViewPreferencesPayload {
+"The result of a view preferences mutation." type ViewPreferencesPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The view preferences entity being mutated."   viewPreferences: ViewPreferences!
   "Whether the operation was successful."   success: Boolean!
 }
 
-type ViewPreferencesValues {
-  "The issue ordering."   viewOrdering: String
-  "The issue grouping."   issueGrouping: String
-  "The issue sub grouping."   issueSubGrouping: String
-  "Whether to show completed issues."   showCompletedIssues: String
+"A label group column configuration for the project list view." type ViewPreferencesProjectLabelGroupColumn {
+  "The identifier of the label group."   id: String!
+  "Whether the label group column is active."   active: Boolean!
 }
 
-"A webhook used to send HTTP notifications over data updates." type Webhook implements Node {
+"The computed view preferences values for a view, containing all display settings such as layout mode, grouping, sorting, field visibility, and other visual configuration. These values represent the merged result of organization defaults and user overrides." type ViewPreferencesValues {
+  "The issue layout type."   layout: String
+  "The issue ordering."   viewOrdering: String
+  "The direction of the issue ordering."   viewOrderingDirection: String
+  "The issue grouping."   issueGrouping: String
+  "The issue sub-grouping."   issueSubGrouping: String
+  "How sub-issues should be nested and displayed."   issueNesting: String
+  "Whether completed issues are shown and for how long."   showCompletedIssues: String
+  "Whether to show parent issues for sub-issues."   showParents: Boolean
+  "Whether to show sub-issues."   showSubIssues: Boolean
+  "Whether to show sub-team issues."   showSubTeamIssues: Boolean
+  "Whether to show supervised issues."   showSupervisedIssues: Boolean
+  "Whether to show triage issues."   showTriageIssues: Boolean
+  "Whether to show snoozed items."   showSnoozedItems: Boolean
+  "Whether to show only snoozed items."   showOnlySnoozedItems: Boolean
+  "Whether to show archived items."   showArchivedItems: Boolean
+  "Whether to show read items."   showReadItems: Boolean
+  "Whether to show unread items first."   showUnreadItemsFirst: Boolean
+  "Whether issues in closed columns should be ordered by recency."   closedIssuesOrderedByRecency: Boolean
+  "Whether to show empty groups."   showEmptyGroups: Boolean
+  "Whether to show empty groups on the board layout."   showEmptyGroupsBoard: Boolean
+  "Whether to show empty groups on the list layout."   showEmptyGroupsList: Boolean
+  "Whether to show empty sub-groups."   showEmptySubGroups: Boolean
+  "Whether to show empty sub-groups on the board layout."   showEmptySubGroupsBoard: Boolean
+  "Whether to show empty sub-groups on the list layout."   showEmptySubGroupsList: Boolean
+  "The label group ID used for issue grouping."   issueGroupingLabelGroupId: String
+  "The label group ID used for issue sub-grouping."   issueSubGroupingLabelGroupId: String
+  "Whether to show the issue identifier field."   fieldId: Boolean
+  "Whether to show the issue status field."   fieldStatus: Boolean
+  "Whether to show the issue priority field."   fieldPriority: Boolean
+  "Whether to show the issue creation date field."   fieldDateCreated: Boolean
+  "Whether to show the issue updated date field."   fieldDateUpdated: Boolean
+  "Whether to show the issue archived date field."   fieldDateArchived: Boolean
+  "Whether to show the issue last activity date field."   fieldDateMyActivity: Boolean
+  "Whether to show the issue assignee field."   fieldAssignee: Boolean
+  "Whether to show the issue estimate field."   fieldEstimate: Boolean
+  "Whether to show the pull requests field."   fieldPullRequests: Boolean
+  "Whether to show preview links."   fieldPreviewLinks: Boolean
+  "Whether to show the Sentry issues field."   fieldSentryIssues: Boolean
+  "Whether to show the due date field."   fieldDueDate: Boolean
+  "Whether to show the link count field."   fieldLinkCount: Boolean
+  "Whether to show the customer request count field."   fieldCustomerCount: Boolean
+  "Whether to show the customer revenue field."   fieldCustomerRevenue: Boolean
+  "Whether to show the SLA field."   fieldSla: Boolean
+  "Whether to show the labels field."   fieldLabels: Boolean
+  "Whether to show the project field."   fieldProject: Boolean
+  "Whether to show the cycle field."   fieldCycle: Boolean
+  "Whether to show the milestone field."   fieldMilestone: Boolean
+  "Whether to show the release field."   fieldRelease: Boolean
+  "Whether to show the time in current status field."   fieldTimeInCurrentStatus: Boolean
+  "List of column model IDs which should be hidden on a board."   hiddenColumns: [String!]
+  "List of row model IDs which should be hidden on a board."   hiddenRows: [String!]
+  "List of group model IDs which should be hidden on a list."   hiddenGroupsList: [String!]
+  "Custom ordering of groups on the board layout."   columnOrderBoard: [String!]
+  "Custom ordering of groups on the list layout."   columnOrderList: [String!]
+  "The project layout type."   projectLayout: String
+  "The project ordering."   projectViewOrdering: String
+  "The project grouping."   projectGrouping: String
+  "The project sub-grouping."   projectSubGrouping: String
+  "The ordering of project groups."   projectGroupOrdering: String
+  "The date resolution when grouping projects by date."   projectGroupingDateResolution: String
+  "Whether completed projects are shown and for how long."   showCompletedProjects: String
+  "The label group ID used for project grouping."   projectGroupingLabelGroupId: String
+  "The label group ID used for project sub-grouping."   projectSubGroupingLabelGroupId: String
+  "The project label group columns configuration."   projectLabelGroupColumns: [ViewPreferencesProjectLabelGroupColumn!]
+  "Whether to show sub-team projects."   showSubTeamProjects: Boolean
+  "Whether to show sub-initiative projects."   showSubInitiativeProjects: Boolean
+  "How to show empty project groups."   projectShowEmptyGroups: String
+  "How to show empty project groups on the list layout."   projectShowEmptyGroupsList: String
+  "How to show empty project groups on the timeline layout."   projectShowEmptyGroupsTimeline: String
+  "How to show empty project groups on the board layout."   projectShowEmptyGroupsBoard: String
+  "How to show empty project sub-groups."   projectShowEmptySubGroups: String
+  "How to show empty project sub-groups on the list layout."   projectShowEmptySubGroupsList: String
+  "How to show empty project sub-groups on the timeline layout."   projectShowEmptySubGroupsTimeline: String
+  "How to show empty project sub-groups on the board layout."   projectShowEmptySubGroupsBoard: String
+  "Whether to show the project status field."   projectFieldStatus: Boolean
+  "Whether to show the project priority field."   projectFieldPriority: Boolean
+  "Whether to show the project lead field."   projectFieldLead: Boolean
+  "Whether to show the project health field."   projectFieldHealth: Boolean
+  "Whether to show the project members field."   projectFieldMembers: Boolean
+  "Whether to show the project start date field."   projectFieldStartDate: Boolean
+  "Whether to show the project target date field."   projectFieldTargetDate: Boolean
+  "Whether to show the project teams field."   projectFieldTeams: Boolean
+  "Whether to show the project roadmaps field."   projectFieldRoadmaps: Boolean
+  "Whether to show the project initiatives field."   projectFieldInitiatives: Boolean
+  "Whether to show the project milestone field."   projectFieldMilestone: Boolean
+  "Whether to show the project description field."   projectFieldDescription: Boolean
+  "Whether to show the project predictions field."   projectFieldPredictions: Boolean
+  "Whether to show the project relations field."   projectFieldRelations: Boolean
+  "Whether to show the project rollout stage field."   projectFieldRolloutStage: Boolean
+  "Whether to show the project activity field."   projectFieldActivity: Boolean
+  "Whether to show the project customer count field."   projectFieldCustomerCount: Boolean
+  "Whether to show the project customer revenue field."   projectFieldCustomerRevenue: Boolean
+  "Whether to show the project labels field."   projectFieldLabels: Boolean
+  "Whether to show the project creation date field."   projectFieldDateCreated: Boolean
+  "Whether to show the project updated date field."   projectFieldDateUpdated: Boolean
+  "Whether to show the project completion date field."   projectFieldDateCompleted: Boolean
+  "Whether to show the project status field on the timeline."   projectFieldStatusTimeline: Boolean
+  "Whether to show the project lead field on the timeline."   projectFieldLeadTimeline: Boolean
+  "Whether to show the project health field on the timeline."   projectFieldHealthTimeline: Boolean
+  "Whether to show the project milestone field on the timeline."   projectFieldMilestoneTimeline: Boolean
+  "Whether to show the project predictions field on the timeline."   projectFieldPredictionsTimeline: Boolean
+  "Whether to show the project relations field on the timeline."   projectFieldRelationsTimeline: Boolean
+  "Whether to show the project description field on the board."   projectFieldDescriptionBoard: Boolean
+  "Whether to show the project members field on the board."   projectFieldMembersBoard: Boolean
+  "Whether to show the project members field on the list."   projectFieldMembersList: Boolean
+  "Whether to show the project members field on the timeline."   projectFieldMembersTimeline: Boolean
+  "Whether to show the project roadmaps field on the board."   projectFieldRoadmapsBoard: Boolean
+  "Whether to show the project roadmaps field on the list."   projectFieldRoadmapsList: Boolean
+  "Whether to show the project roadmaps field on the timeline."   projectFieldRoadmapsTimeline: Boolean
+  "Whether to show the project teams field on the board."   projectFieldTeamsBoard: Boolean
+  "Whether to show the project teams field on the list."   projectFieldTeamsList: Boolean
+  "Whether to show the project teams field on the timeline."   projectFieldTeamsTimeline: Boolean
+  "The zoom level for the timeline view."   projectZoomLevel: String @deprecated(reason: "Use timelineZoomScale instead.")
+  "The zoom scale for the timeline view."   timelineZoomScale: Float
+  "Selected team IDs to show cycles for in timeline chronology bar."   timelineChronologyShowCycleTeamIds: [String!]
+  "Whether to show week numbers in timeline chronology bar."   timelineChronologyShowWeekNumbers: Boolean
+  "The initiative grouping."   initiativeGrouping: String
+  "The initiative ordering."   initiativesViewOrdering: String
+  "Whether to show the initiative projects field."   initiativeFieldProjects: Boolean
+  "Whether to show the initiative teams field."   initiativeFieldTeams: Boolean
+  "Whether to show the initiative description field."   initiativeFieldDescription: Boolean
+  "Whether to show the initiative owner field."   initiativeFieldOwner: Boolean
+  "Whether to show the initiative start date field."   initiativeFieldStartDate: Boolean
+  "Whether to show the initiative target date field."   initiativeFieldTargetDate: Boolean
+  "Whether to show the initiative completed date field."   initiativeFieldDateCompleted: Boolean
+  "Whether to show the initiative updated date field."   initiativeFieldDateUpdated: Boolean
+  "Whether to show the initiative created date field."   initiativeFieldDateCreated: Boolean
+  "Whether to show the initiative status field."   initiativeFieldStatus: Boolean
+  "Whether to show the initiative activity field."   initiativeFieldActivity: Boolean
+  "Whether to show the initiative health field."   initiativeFieldInitiativeHealth: Boolean
+  "Whether to show the initiative active projects health field."   initiativeFieldHealth: Boolean
+  "Whether to show sub-initiatives nested."   showNestedInitiatives: Boolean
+  "The customers view ordering."   customersViewOrdering: String
+  "Whether to show the customer request count field."   customerFieldRequestCount: Boolean
+  "Whether to show the customer domains field."   customerFieldDomains: Boolean
+  "Whether to show the customer owner field."   customerFieldOwner: Boolean
+  "Whether to show the customer revenue field."   customerFieldRevenue: Boolean
+  "Whether to show the customer size field."   customerFieldSize: Boolean
+  "Whether to show the customer source field."   customerFieldSource: Boolean
+  "Whether to show the customer status field."   customerFieldStatus: Boolean
+  "Whether to show the customer tier field."   customerFieldTier: Boolean
+  "The customer page needs view grouping."   customerPageNeedsViewGrouping: String
+  "The customer page needs view ordering."   customerPageNeedsViewOrdering: String
+  "Whether to show important customer needs first."   customerPageNeedsShowImportantFirst: Boolean
+  "Whether to show completed issues and projects in the customer page."   customerPageNeedsShowCompletedIssuesAndProjects: String
+  "Whether to show the issue identifier field in the customer page."   customerPageNeedsFieldIssueIdentifier: Boolean
+  "Whether to show the issue priority field in the customer page."   customerPageNeedsFieldIssuePriority: Boolean
+  "Whether to show the issue status field in the customer page."   customerPageNeedsFieldIssueStatus: Boolean
+  "Whether to show the issue due date field in the customer page."   customerPageNeedsFieldIssueTargetDueDate: Boolean
+  "The embedded customer needs view ordering."   embeddedCustomerNeedsViewOrdering: String
+  "Whether to show important embedded customer needs first."   embeddedCustomerNeedsShowImportantFirst: Boolean
+  "The project customer needs view grouping."   projectCustomerNeedsViewGrouping: String
+  "The project customer needs view ordering."   projectCustomerNeedsViewOrdering: String
+  "Whether to show important project customer needs first."   projectCustomerNeedsShowImportantFirst: Boolean
+  "Whether to show completed issues last in project customer needs."   projectCustomerNeedsShowCompletedIssuesLast: Boolean
+  "The team view ordering."   teamViewOrdering: String
+  "Whether to show the team identifier field."   teamFieldIdentifier: Boolean
+  "Whether to show the team membership field."   teamFieldMembership: Boolean
+  "Whether to show the team owner field."   teamFieldOwner: Boolean
+  "Whether to show the team members field."   teamFieldMembers: Boolean
+  "Whether to show the team projects field."   teamFieldProjects: Boolean
+  "Whether to show the team cycle field."   teamFieldCycle: Boolean
+  "Whether to show the team creation date field."   teamFieldDateCreated: Boolean
+  "Whether to show the team updated date field."   teamFieldDateUpdated: Boolean
+  "The custom views ordering."   customViewsOrdering: String
+  "Whether to show the custom view owner field."   customViewFieldOwner: Boolean
+  "Whether to show the custom view visibility field."   customViewFieldVisibility: Boolean
+  "Whether to show the custom view creation date field."   customViewFieldDateCreated: Boolean
+  "Whether to show the custom view updated date field."   customViewFieldDateUpdated: Boolean
+  "The dashboards ordering."   dashboardsOrdering: String
+  "Whether to show the dashboard owner field."   dashboardFieldOwner: Boolean
+  "Whether to show the dashboard creation date field."   dashboardFieldDateCreated: Boolean
+  "Whether to show the dashboard updated date field."   dashboardFieldDateUpdated: Boolean
+  "The workspace members view ordering."   workspaceMembersViewOrdering: String
+  "Whether to show the member status field."   memberFieldStatus: Boolean
+  "Whether to show the member joined date field."   memberFieldJoined: Boolean
+  "Whether to show the member teams field."   memberFieldTeams: Boolean
+  "The release pipeline grouping."   releasePipelineGrouping: String
+  "The release pipelines view ordering."   releasePipelinesViewOrdering: String
+  "Whether to show the type field for release pipelines."   releasePipelineFieldType: Boolean
+  "Whether to show the teams field for release pipelines."   releasePipelineFieldTeams: Boolean
+  "Whether to show the releases field for release pipelines."   releasePipelineFieldReleases: Boolean
+  "Whether to show the latest release field for release pipelines."   releasePipelineFieldLatestRelease: Boolean
+  "The scheduled pipeline releases view ordering."   scheduledPipelineReleasesViewOrdering: String
+  "The scheduled pipeline releases view grouping."   scheduledPipelineReleasesViewGrouping: String
+  "Whether to show the version field for scheduled pipeline releases."   scheduledPipelineReleaseFieldVersion: Boolean
+  "Whether to show the release date field for scheduled pipeline releases."   scheduledPipelineReleaseFieldReleaseDate: Boolean
+  "Whether to show the completion field for scheduled pipeline releases."   scheduledPipelineReleaseFieldCompletion: Boolean
+  "Whether to show the description field for scheduled pipeline releases."   scheduledPipelineReleaseFieldDescription: Boolean
+  "The continuous pipeline releases view grouping."   continuousPipelineReleasesViewGrouping: String
+  "Whether to show the version field for continuous pipeline releases."   continuousPipelineReleaseFieldVersion: Boolean
+  "Whether to show the release date field for continuous pipeline releases."   continuousPipelineReleaseFieldReleaseDate: Boolean
+  "The search view ordering."   searchViewOrdering: String
+  "The search result type filter."   searchResultType: String
+  "The inbox view ordering."   inboxViewOrdering: String
+  "The triage view ordering."   triageViewOrdering: String
+  "The focus view grouping."   focusViewGrouping: String
+  "The focus view ordering."   focusViewOrdering: String
+  "The focus view ordering direction."   focusViewOrderingDirection: String
+  "The review grouping."   reviewGrouping: String
+  "The review view ordering."   reviewViewOrdering: String
+  "Whether completed reviews are shown and for how long."   showCompletedReviews: String
+  "Whether to show draft reviews."   showDraftReviews: Boolean
+  "Whether to show the review avatar field."   reviewFieldAvatar: Boolean
+  "Whether to show the review preview links field."   reviewFieldPreviewLinks: Boolean
+  "Whether to show the review repository field."   reviewFieldRepository: Boolean
+  "Whether to show the review identifier field."   reviewFieldIdentifier: Boolean
+  "Whether to show the review checks field."   reviewFieldChecks: Boolean
+  "Whether completed agent sessions are shown and for how long."   showCompletedAgentSessions: String
+}
+
+"A webhook subscription that sends HTTP POST callbacks to an external URL when events occur in Linear. Webhooks can be scoped to a specific team, multiple teams, or all public teams in the organization. They support filtering by resource type (e.g., Issue, Comment, Project) and can be created either manually by users or automatically by OAuth applications. Each webhook has a signing secret for verifying payload authenticity on the recipient side." type Webhook implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "Webhook label."   label: String
-  "Webhook URL."   url: String
-  "Whether the Webhook is enabled."   enabled: Boolean!
-  "The team that the webhook is associated with. If null, the webhook is associated with all public teams of the organization or multiple teams."   team: Team
-  "[INTERNAL] The teams that the webhook is associated with. Used to represent a webhook that targets multiple teams, potentially in addition to all public teams of the organization."   teamIds: [String!]
-  "Whether the Webhook is enabled for all public teams, including teams created after the webhook was created."   allPublicTeams: Boolean!
+  "A human-readable label for the webhook, used for identification in the UI. Null if no label has been set."   label: String
+  "The destination URL where webhook payloads will be sent via HTTP POST. Null for OAuth application webhooks, which use the webhook URL configured on the OAuth client instead."   url: String
+  "Whether the webhook is enabled. When disabled, no payloads will be delivered even if matching events occur."   enabled: Boolean!
+  "The single team that the webhook is scoped to. When null, the webhook either targets all public teams (if allPublicTeams is true), multiple specific teams (if teamIds is set), or organization-wide events."   team: Team
+  "[INTERNAL] An array of team IDs that the webhook is subscribed to. Used to represent a webhook that targets multiple specific teams, potentially in addition to all public teams (when allPublicTeams is also true). Null when the webhook targets a single team via teamId or all public teams only."   teamIds: [String!]
+  "Whether the webhook receives events from all public (non-private) teams in the organization, including teams created after the webhook was set up. When true, the webhook automatically covers new public teams without requiring reconfiguration."   allPublicTeams: Boolean!
   "The user who created the webhook."   creator: User
-  "Secret token for verifying the origin on the recipient side."   secret: String
-  "The resource types this webhook is subscribed to."   resourceTypes: [String!]!
+  "A secret token used to sign webhook payloads with HMAC-SHA256, allowing the recipient to verify that the payload originated from Linear and was not tampered with. Automatically generated if not provided during creation."   secret: String
+  "The resource types this webhook is subscribed to (e.g., 'Issue', 'Comment', 'Project', 'Cycle'). The webhook will only receive payloads for events affecting these resource types."   resourceTypes: [String!]!
   "[INTERNAL] Webhook failure events associated with the webhook (last 50)."   failures: [WebhookFailureEvent!]!
 }
 
@@ -9392,57 +10585,55 @@ type WebhookEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-"Entity representing a webhook execution failure." type WebhookFailureEvent {
+"A record of a failed webhook delivery attempt. Created when a webhook payload could not be successfully delivered to the destination URL, either due to an HTTP error response or a network failure. Each failure event captures the HTTP status code (if available), the response body or error message, and a stable execution ID that is shared across retries of the same delivery." type WebhookFailureEvent {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   "The webhook that this failure event is associated with."   webhook: Webhook!
   "The URL that the webhook was trying to push to."   url: String!
-  "The HTTP status code returned by the recipient."   httpStatus: Float
-  "The HTTP response body returned by the recipient or error occured."   responseOrError: String
-  "The unique execution ID of the webhook push. This is retained between retries of the same push."   executionId: String!
+  "The HTTP status code returned by the webhook recipient. Null if the request failed before receiving a response (e.g., DNS resolution failure, connection timeout)."   httpStatus: Float
+  "The HTTP response body returned by the recipient, or the error message if the request failed before receiving a response. Truncated to 1000 characters."   responseOrError: String
+  "A stable identifier for the webhook delivery attempt. This ID remains the same across retries of the same payload, making it useful for correlating multiple failure events that belong to the same logical delivery."   executionId: String!
 }
 
-type WebhookPayload {
+"The result of a webhook mutation." type WebhookPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The webhook entity being mutated."   webhook: Webhook!
   "Whether the operation was successful."   success: Boolean!
 }
 
-type WebhookRotateSecretPayload {
+"The result of a webhook secret rotation mutation." type WebhookRotateSecretPayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "Whether the operation was successful."   success: Boolean!
   "The new webhook signing secret."   secret: String!
 }
 
-"A welcome message for new users joining the workspace." type WelcomeMessage implements Node {
+"A welcome message configuration for the workspace. When enabled, new users joining the workspace receive a notification with this message in their inbox. Each workspace has at most one welcome message. The message body is stored in a related DocumentContent entity." type WelcomeMessage implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The title of the welcome message notification."   title: String
-  "Whether the welcome message is enabled."   enabled: Boolean!
-  "The user who last updated the welcome message."   updatedBy: User
+  "The title of the welcome message notification. Null defaults to 'Welcome to {workspace name}'."   title: String
+  "Whether the welcome message is enabled and should be sent to new users joining the workspace."   enabled: Boolean!
+  "The user who last updated the welcome message configuration. Null if the user's account has been deleted."   updatedBy: User
 }
 
-"A welcome message related notification." type WelcomeMessageNotification implements Notification & Entity & Node {
+"A notification containing a workspace welcome message, sent to newly joined users." type WelcomeMessageNotification implements Notification & Entity & Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "Notification type."   type: String!
-  "The user that caused the notification."   actor: User
-  "The external user that caused the notification."   externalUserActor: ExternalUser
-  "The user that received the notification."   user: User!
-  "The time at when the user marked the notification as read. Null, if the the user hasn't read the notification"   readAt: DateTime
-  """The time at when an email reminder for this notification was sent to the user. Null, if no email
-    reminder has been sent."""
-  emailedAt: DateTime
-  "The time until a notification will be snoozed. After that it will appear in the inbox again."   snoozedUntilAt: DateTime
-  "The time at which a notification was unsnoozed.."   unsnoozedAt: DateTime
+  "Notification type. Determines the kind of event that triggered this notification and which associated entity fields will be populated."   type: String!
+  "The user that caused the notification. Null if the notification was triggered by a non-user actor such as an integration, external user, or system event."   actor: User
+  "The external user that caused the notification. Populated when the notification was triggered by an external user (e.g., a commenter from a connected integration like Slack or GitHub) rather than a Linear workspace member."   externalUserActor: ExternalUser
+  "The recipient user of this notification."   user: User!
+  "The time at which the user marked the notification as read. Null if the notification is unread."   readAt: DateTime
+  "The time at which an email reminder for this notification was sent to the user. Null if no email reminder has been sent."   emailedAt: DateTime
+  "The time until which a notification is snoozed. After this time, the notification reappears in the user's inbox. Null if the notification is not currently snoozed."   snoozedUntilAt: DateTime
+  "The time at which a notification was unsnoozed. Null if the notification has not been unsnoozed."   unsnoozedAt: DateTime
   "The category of the notification."   category: NotificationCategory!
   "[Internal] URL to the target of the notification."   url: String!
   "[Internal] Inbox URL for the notification."   inboxUrl: String!
@@ -9461,7 +10652,7 @@ type WebhookRotateSecretPayload {
   "Related welcome message."   welcomeMessageId: String!
 }
 
-type WorkflowDefinition implements Node {
+"An automation workflow definition that executes a set of activities when triggered by specific events. Workflows can be scoped to a team, project, cycle, label, custom view, initiative, or user context. They are triggered by entity changes (e.g., issue status change, new comment) and can include conditions that filter which events actually execute the workflow. Activities define the actions taken, such as updating issue properties, sending notifications, or posting to Slack." type WorkflowDefinition implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
@@ -9471,16 +10662,16 @@ type WorkflowDefinition implements Node {
   "The name of the workflow."   name: String!
   "The name of the group that the workflow belongs to."   groupName: String
   "The description of the workflow."   description: String
-  "The type of the workflow."   type: WorkflowType!
-  "The type of the event that triggers off the workflow."   trigger: WorkflowTrigger!
-  "The object type (e.g. Issue) that triggers this workflow."   triggerType: WorkflowTriggerType!
-  "The conditions that need to be match for the workflow to be triggered."   conditions: JSONObject
-  enabled: Boolean!
-  "The team associated with the workflow. If not set, the workflow is associated with the entire organization."   team: Team
+  "The type of the workflow, such as custom automation, SLA, or auto-close."   type: WorkflowType!
+  "The event that triggers the workflow, such as entity creation, update, or a specific state change."   trigger: WorkflowTrigger!
+  "The entity type that triggers this workflow, such as Issue, Project, or Release."   triggerType: WorkflowTriggerType!
+  "The filter conditions that must match for the workflow to execute. When null, the workflow triggers on all matching events."   conditions: JSONObject
+  "Whether the workflow is enabled and will execute when its trigger conditions are met."   enabled: Boolean!
+  "The team associated with the workflow. If not set, the workflow is associated with the entire workspace."   team: Team
   "The user who created the workflow."   creator: User!
-  "An array of activities that will be executed as part of the workflow."   activities: JSONObject!
+  "The ordered list of activities (actions) that are executed when the workflow triggers, such as updating issue properties, sending notifications, or calling webhooks."   activities: JSONObject!
   "The sort order of the workflow definition within its siblings."   sortOrder: String!
-  "The date when the workflow was last executed."   lastExecutedAt: DateTime
+  "The date and time when the workflow was last triggered and executed. Null if the workflow has never been executed."   lastExecutedAt: DateTime
   "The user who last updated the workflow."   lastUpdatedBy: User
   "The contextual label view associated with the workflow."   label: IssueLabel
   "The contextual cycle view associated with the workflow."   cycle: Cycle
@@ -9490,23 +10681,24 @@ type WorkflowDefinition implements Node {
   "The context custom view associated with the workflow."   customView: CustomView
   "The type of view to which this workflow's context is associated with."   contextViewType: ContextViewType
   "The type of user view to which this workflow's context is associated with."   userContextViewType: UserContextViewType
+  "The workflow definition's unique URL slug."   slugId: String!
 }
 
-"A state in a team workflow." type WorkflowState implements Node {
+"A state in a team's workflow, representing an issue status such as Triage, Backlog, Todo, In Progress, In Review, Done, or Canceled. Each team has its own set of workflow states that define the progression of issues through the team's process. Workflow states have a type that categorizes them (triage, backlog, unstarted, started, completed, canceled), a position that determines their display order, and a color for visual identification. States can be inherited from parent teams to sub-teams." type WorkflowState implements Node {
   "The unique identifier of the entity."   id: ID!
   "The time at which the entity was created."   createdAt: DateTime!
   """The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't
     been updated after creation."""
   updatedAt: DateTime!
   "The time at which the entity was archived. Null if the entity has not been archived."   archivedAt: DateTime
-  "The state's name."   name: String!
+  "The state's human-readable name (e.g., 'In Progress', 'Done', 'Backlog')."   name: String!
   "The state's UI color as a HEX string."   color: String!
   "Description of the state."   description: String
-  "The position of the state in the team flow."   position: Float!
-  "The type of the state. One of \"triage\", \"backlog\", \"unstarted\", \"started\", \"completed\", \"canceled\"."   type: String!
-  "The team to which this state belongs to."   team: Team!
-  "The state inherited from"   inheritedFrom: WorkflowState
-  "Issues belonging in this state."   issues(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
+  "The position of the state in the team's workflow. States are displayed in ascending order of position within their type group."   position: Float!
+  "The type of the state. One of \"triage\", \"backlog\", \"unstarted\", \"started\", \"completed\", \"canceled\", \"duplicate\"."   type: String!
+  "The team that this workflow state belongs to. Each team has its own set of workflow states."   team: Team!
+  "The parent team's workflow state that this state was inherited from. Null if the state is not inherited from a parent team."   inheritedFrom: WorkflowState
+  "Issues that currently have this workflow state. Returns a paginated and filterable list of issues."   issues(filter: IssueFilter, before: String, after: String, first: Int, last: Int, includeArchived: Boolean, orderBy: PaginationOrderBy): IssueConnection!
 }
 
 "A generic payload return from entity archive mutations." type WorkflowStateArchivePayload implements ArchivePayload {
@@ -9526,7 +10718,7 @@ type WorkflowStateEdge {
   "Used in `before` and `after` args"   cursor: String!
 }
 
-type WorkflowStatePayload {
+"The result of a workflow state mutation, containing the created or updated state and a success indicator." type WorkflowStatePayload {
   "The identifier of the last sync operation."   lastSyncId: Float!
   "The state that was created or updated."   workflowState: WorkflowState!
   "Whether the operation was successful."   success: Boolean!
@@ -9534,6 +10726,12 @@ type WorkflowStatePayload {
 
 "Content for different types of agent activities." union AgentActivityContent = AgentActivityThoughtContent | AgentActivityActionContent | AgentActivityResponseContent | AgentActivityPromptContent | AgentActivityErrorContent | AgentActivityElicitationContent
 
+"A part in an AI conversation." union AiConversationPart = AiConversationPromptPart | AiConversationTextPart | AiConversationReasoningPart | AiConversationToolCallPart | AiConversationWidgetPart
+
+"The tool call." union AiConversationToolCall = AiConversationSearchEntitiesToolCall | AiConversationRetrieveEntitiesToolCall | AiConversationQueryViewToolCall | AiConversationQueryActivityToolCall | AiConversationQueryUpdatesToolCall | AiConversationSuggestValuesToolCall | AiConversationCreateEntityToolCall | AiConversationUpdateEntityToolCall | AiConversationDeleteEntityToolCall | AiConversationRestoreEntityToolCall | AiConversationResearchToolCall | AiConversationCodeIntelligenceToolCall | AiConversationGetPullRequestDiffToolCall | AiConversationGetPullRequestFileToolCall | AiConversationHandoffToCodingSessionToolCall | AiConversationTranscribeVideoToolCall | AiConversationTranscribeMediaToolCall | AiConversationSearchDocumentationToolCall | AiConversationWebSearchToolCall | AiConversationGetSlackConversationHistoryToolCall | AiConversationGetMicrosoftTeamsConversationHistoryToolCall | AiConversationNavigateToPageToolCall | AiConversationInvokeMcpToolToolCall
+
+"The widget." union AiConversationWidget = AiConversationEntityCardWidget | AiConversationEntityListWidget
+
 union ExternalEntityInfoMetadata = ExternalEntityInfoGithubMetadata | ExternalEntityInfoJiraMetadata | ExternalEntitySlackMetadata
 
 union OrganizationInviteDetailsPayload = OrganizationInviteFullDetailsPayload | OrganizationAcceptedOrExpiredInviteDetailsPayload