cadenya 0.32.0 → 0.34.0

data/lib/cadenya/resources/objectives/feedback.rb

@@ -45,7 +45,7 @@ module Cadenya
         #
         # Lists all feedback submitted for an objective
         #
-        # @overload list(objective_id, workspace_id:, cursor: nil, limit: nil, request_options: {})
+        # @overload list(objective_id, workspace_id:, cursor: nil, labels: nil, limit: nil, request_options: {})
         #
         # @param objective_id [String] Path param: The ID of the objective. Supports "external_id:" prefix for external
         #
@@ -53,6 +53,8 @@ module Cadenya
         #
         # @param cursor [String] Query param: Pagination cursor from previous response
         #
+        # @param labels [String] Query param: Filters by metadata labels. Comma-separated key=value pairs,
+        #
         # @param limit [Integer] Query param: Maximum number of results to return
         #
         # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/cadenya/resources/objectives/tool_calls.rb

@@ -48,7 +48,7 @@ module Cadenya
         #
         # Lists all tool calls for an objective
         #
-        # @overload list(objective_id, workspace_id:, cursor: nil, execution_status: nil, include_info: nil, limit: nil, status: nil, request_options: {})
+        # @overload list(objective_id, workspace_id:, cursor: nil, execution_status: nil, include_info: nil, labels: nil, limit: nil, status: nil, request_options: {})
         #
         # @param objective_id [String] Path param: The objective ID to return tool calls for
         #
@@ -60,6 +60,8 @@ module Cadenya
         #
         # @param include_info [Boolean] Query param: When set to true you may use more of your alloted API rate-limit
         #
+        # @param labels [String] Query param: Filters by metadata labels. Comma-separated key=value pairs,
+        #
         # @param limit [Integer] Query param: Maximum number of results to return
         #
         # @param status [Symbol, Cadenya::Models::Objectives::ToolCallListParams::Status] Query param: Filter by tool call status

data/lib/cadenya/resources/objectives.rb

@@ -88,7 +88,7 @@ module Cadenya
       #
       # Lists all objectives in the workspace
       #
-      # @overload list(workspace_id, agent_id: nil, agent_schedule_id: nil, cursor: nil, include_info: nil, limit: nil, parent_objective_id: nil, profile_id: nil, sort_order: nil, state: nil, request_options: {})
+      # @overload list(workspace_id, agent_id: nil, agent_schedule_id: nil, cursor: nil, include_info: nil, labels: nil, limit: nil, parent_objective_id: nil, profile_id: nil, sort_order: nil, state: nil, request_options: {})
       #
       # @param workspace_id [String]
       #
@@ -100,6 +100,8 @@ module Cadenya
       #
       # @param include_info [Boolean] When set to true you may use more of your alloted API rate-limit
       #
+      # @param labels [String] Filters by metadata labels. Comma-separated key=value pairs,
+      #
       # @param limit [Integer] Maximum number of results to return
       #
       # @param parent_objective_id [String] Optional filters
@@ -238,10 +240,13 @@ module Cadenya
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::ObjectiveListContextWindowsParams} for more details.
+      #
       # Read-only list of the last five windows of execution for this objective, ordered
       # by most recent first
       #
-      # @overload list_context_windows(objective_id, workspace_id:, cursor: nil, include_info: nil, limit: nil, request_options: {})
+      # @overload list_context_windows(objective_id, workspace_id:, cursor: nil, include_info: nil, labels: nil, limit: nil, request_options: {})
       #
       # @param objective_id [String] Path param: The objective ID to return windows for
       #
@@ -251,6 +256,8 @@ module Cadenya
       #
       # @param include_info [Boolean] Query param: When set to true you may use more of your alloted API rate-limit
       #
+      # @param labels [String] Query param: Filters by metadata labels. Comma-separated key=value pairs,
+      #
       # @param limit [Integer] Query param: Maximum number of results to return
       #
       # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -275,9 +282,12 @@ module Cadenya
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::ObjectiveListEventsParams} for more details.
+      #
       # Lists all events for an objective
       #
-      # @overload list_events(objective_id, workspace_id:, cursor: nil, include_info: nil, limit: nil, since_event_id: nil, sort_order: nil, window_id: nil, request_options: {})
+      # @overload list_events(objective_id, workspace_id:, cursor: nil, include_info: nil, labels: nil, limit: nil, since_event_id: nil, sort_order: nil, window_id: nil, request_options: {})
       #
       # @param objective_id [String] Path param: Objective ID for filtering
       #
@@ -287,6 +297,8 @@ module Cadenya
       #
       # @param include_info [Boolean] Query param: When set to true you may use more of your alloted API rate-limit
       #
+      # @param labels [String] Query param: Filters by metadata labels. Comma-separated key=value pairs,
+      #
       # @param limit [Integer] Query param: Maximum number of results to return
       #
       # @param since_event_id [String] Query param: Optional string to fetch events since an ID

data/lib/cadenya/resources/tool_sets/tools.rb

@@ -128,7 +128,7 @@ module Cadenya
         #
         # Lists all tools in the tool set
         #
-        # @overload list(tool_set_id, workspace_id:, cursor: nil, include_info: nil, limit: nil, names: nil, prefix: nil, query: nil, requires_approval: nil, sort_order: nil, states: nil, request_options: {})
+        # @overload list(tool_set_id, workspace_id:, cursor: nil, include_info: nil, labels: nil, limit: nil, names: nil, prefix: nil, query: nil, requires_approval: nil, sort_order: nil, states: nil, request_options: {})
         #
         # @param tool_set_id [String] Path param: Tool set ID. Accepts the canonical ts\_… form or the
         #
@@ -138,6 +138,8 @@ module Cadenya
         #
         # @param include_info [Boolean] Query param: When set to true you may use more of your alloted API rate-limit
         #
+        # @param labels [String] Query param: Filters by metadata labels. Comma-separated key=value pairs,
+        #
         # @param limit [Integer] Query param: Maximum number of results to return
         #
         # @param names [Array<String>] Query param: Filter by tool name (exact match). Multiple values are OR'd togethe

data/lib/cadenya/resources/tool_sets.rb

@@ -125,7 +125,7 @@ module Cadenya
       #
       # Lists all tool sets in the workspace
       #
-      # @overload list(workspace_id, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, state: nil, request_options: {})
+      # @overload list(workspace_id, cursor: nil, include_info: nil, labels: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, state: nil, request_options: {})
       #
       # @param workspace_id [String] Workspace ID.
       #
@@ -133,6 +133,8 @@ module Cadenya
       #
       # @param include_info [Boolean] When set to true you may use more of your alloted API rate-limit
       #
+      # @param labels [String] Filters by metadata labels. Comma-separated key=value pairs,
+      #
       # @param limit [Integer] Maximum number of results to return
       #
       # @param prefix [String] Filter expression (query param: prefix)
@@ -261,7 +263,7 @@ module Cadenya
       #
       # Lists all events (including sync status) for a tool set
       #
-      # @overload list_events(tool_set_id, workspace_id:, cursor: nil, include_info: nil, limit: nil, sort_order: nil, request_options: {})
+      # @overload list_events(tool_set_id, workspace_id:, cursor: nil, include_info: nil, labels: nil, limit: nil, sort_order: nil, request_options: {})
       #
       # @param tool_set_id [String] Path param: Tool set ID. Accepts the canonical ts\_… form or the
       #
@@ -271,6 +273,8 @@ module Cadenya
       #
       # @param include_info [Boolean] Query param: When set to true you may use more of your alloted API rate-limit
       #
+      # @param labels [String] Query param: Filters by metadata labels. Comma-separated key=value pairs,
+      #
       # @param limit [Integer] Query param: Maximum number of results to return
       #
       # @param sort_order [String] Query param: Sort order for results (asc or desc by creation time)

data/lib/cadenya/resources/workspace_admin/profiles.rb

@@ -16,10 +16,12 @@ module Cadenya
         # Searches the account's profiles for a member picker, with free-form name/email
         # search and an optional type filter. Account-scoped; admin only.
         #
-        # @overload list(cursor: nil, limit: nil, query: nil, request_options: {})
+        # @overload list(cursor: nil, labels: nil, limit: nil, query: nil, request_options: {})
         #
         # @param cursor [String] Pagination cursor from previous response
         #
+        # @param labels [String] Filters by metadata labels. Comma-separated key=value pairs,
+        #
         # @param limit [Integer] Maximum number of results to return
         #
         # @param query [String] Free-form search over profile name and email. Case-insensitive substring

data/lib/cadenya/resources/workspace_admin.rb

@@ -111,12 +111,14 @@ module Cadenya
       # Lists every workspace in the account, optionally including archived ones. Admin
       # only.
       #
-      # @overload list(cursor: nil, include_archived: nil, limit: nil, request_options: {})
+      # @overload list(cursor: nil, include_archived: nil, labels: nil, limit: nil, request_options: {})
       #
       # @param cursor [String] Pagination cursor from previous response
       #
       # @param include_archived [Boolean] When true, archived workspaces are included in the results. Defaults to
       #
+      # @param labels [String] Filters by metadata labels. Comma-separated key=value pairs,
+      #
       # @param limit [Integer] Maximum number of results to return
       #
       # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/cadenya/resources/workspace_secrets.rb

@@ -96,9 +96,12 @@ module Cadenya
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::WorkspaceSecretListParams} for more details.
+      #
       # Lists all workspace secrets in the workspace
       #
-      # @overload list(workspace_id, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, request_options: {})
+      # @overload list(workspace_id, cursor: nil, include_info: nil, labels: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, request_options: {})
       #
       # @param workspace_id [String] The workspace whose secrets will be listed.
       #
@@ -106,6 +109,8 @@ module Cadenya
       #
       # @param include_info [Boolean] When set to true you may use more of your alloted API rate-limit
       #
+      # @param labels [String] Filters by metadata labels. Comma-separated key=value pairs,
+      #
       # @param limit [Integer] Maximum number of results to return
       #
       # @param prefix [String] Filter expression (query param: prefix)

data/lib/cadenya/resources/workspaces.rb

@@ -9,14 +9,19 @@ module Cadenya
     # (create / archive workspaces, manage members) live in WorkspaceAdminService
     # under /v1/account/workspaces and require the admin role.
     class Workspaces
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::WorkspaceListParams} for more details.
+      #
       # Lists all workspaces for the current account
       #
-      # @overload list(cursor: nil, include_info: nil, limit: nil, sort_order: nil, request_options: {})
+      # @overload list(cursor: nil, include_info: nil, labels: nil, limit: nil, sort_order: nil, request_options: {})
       #
       # @param cursor [String] Pagination cursor from previous response
       #
       # @param include_info [Boolean] When set to true you may use more of your alloted API rate-limit
       #
+      # @param labels [String] Filters by metadata labels. Comma-separated key=value pairs,
+      #
       # @param limit [Integer] Maximum number of results to return
       #
       # @param sort_order [String] Sort order for results (asc or desc by creation time)

data/lib/cadenya/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cadenya
-  VERSION = "0.32.0"
+  VERSION = "0.34.0"
 end

data/rbi/cadenya/models/account_resource_metadata.rbi

@@ -20,8 +20,11 @@ module Cadenya
       sig { params(external_id: String).void }
       attr_writer :external_id
 
-      # Arbitrary key-value pairs for categorization and filtering Examples:
-      # {"environment": "production", "team": "platform", "version": "v2"}
+      # Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric
+      # characters with "-", "\_", or "." allowed between; keys follow the same shape
+      # and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/")
+      # of at most 253 characters. Examples: {"environment": "production", "team":
+      # "platform", "version": "v2"}
       sig { returns(T.nilable(T::Hash[Symbol, String])) }
       attr_reader :labels
 
@@ -70,8 +73,11 @@ module Cadenya
         created_at: nil,
         # External ID for the resource (e.g., a workflow ID from an external system)
         external_id: nil,
-        # Arbitrary key-value pairs for categorization and filtering Examples:
-        # {"environment": "production", "team": "platform", "version": "v2"}
+        # Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric
+        # characters with "-", "\_", or "." allowed between; keys follow the same shape
+        # and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/")
+        # of at most 253 characters. Examples: {"environment": "production", "team":
+        # "platform", "version": "v2"}
         labels: nil
       )
       end

data/rbi/cadenya/models/agent_list_params.rbi

@@ -29,6 +29,15 @@ module Cadenya
       sig { params(include_info: T::Boolean).void }
       attr_writer :include_info
 
+      # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+      # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+      # semantics).
+      sig { returns(T.nilable(String)) }
+      attr_reader :labels
+
+      sig { params(labels: String).void }
+      attr_writer :labels
+
       # Maximum number of results to return
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
@@ -85,6 +94,7 @@ module Cadenya
           workspace_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           prefix: String,
           query: String,
@@ -102,6 +112,10 @@ module Cadenya
         # When true, the `info` field on each returned agent is populated. Requests with
         # this flag count more against your rate limit.
         include_info: nil,
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        labels: nil,
         # Maximum number of results to return
         limit: nil,
         # Filter expression (query param: prefix)
@@ -124,6 +138,7 @@ module Cadenya
             workspace_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             prefix: String,
             query: String,

data/rbi/cadenya/models/agents/feedback_list_params.rbi

@@ -57,6 +57,15 @@ module Cadenya
         sig { params(include_info: T::Boolean).void }
         attr_writer :include_info
 
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        sig { returns(T.nilable(String)) }
+        attr_reader :labels
+
+        sig { params(labels: String).void }
+        attr_writer :labels
+
         # Maximum number of results to return.
         sig { returns(T.nilable(Integer)) }
         attr_reader :limit
@@ -96,6 +105,7 @@ module Cadenya
             created_before: Time,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             query: String,
             sentiment: Cadenya::Agents::FeedbackListParams::Sentiment::OrSymbol,
@@ -116,6 +126,10 @@ module Cadenya
           cursor: nil,
           # When set to true you may use more of your alloted API rate-limit
           include_info: nil,
+          # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+          # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+          # semantics).
+          labels: nil,
           # Maximum number of results to return.
           limit: nil,
           # Free-text search applied to the feedback comment. Case-insensitive substring
@@ -137,6 +151,7 @@ module Cadenya
               created_before: Time,
               cursor: String,
               include_info: T::Boolean,
+              labels: String,
               limit: Integer,
               query: String,
               sentiment:

data/rbi/cadenya/models/agents/schedule_list_params.rbi

@@ -36,6 +36,15 @@ module Cadenya
         sig { params(include_info: T::Boolean).void }
         attr_writer :include_info
 
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        sig { returns(T.nilable(String)) }
+        attr_reader :labels
+
+        sig { params(labels: String).void }
+        attr_writer :labels
+
         # Maximum number of results to return.
         sig { returns(T.nilable(Integer)) }
         attr_reader :limit
@@ -70,6 +79,7 @@ module Cadenya
             agent_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             prefix: String,
             query: String,
@@ -85,6 +95,10 @@ module Cadenya
           # When true, the `info` field on each returned schedule is populated. Requests
           # with this flag count more against your rate limit.
           include_info: nil,
+          # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+          # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+          # semantics).
+          labels: nil,
           # Maximum number of results to return.
           limit: nil,
           # Filter expression (query param: prefix).
@@ -104,6 +118,7 @@ module Cadenya
               agent_id: String,
               cursor: String,
               include_info: T::Boolean,
+              labels: String,
               limit: Integer,
               prefix: String,
               query: String,

data/rbi/cadenya/models/agents/variation_list_params.rbi

@@ -36,6 +36,15 @@ module Cadenya
         sig { params(include_info: T::Boolean).void }
         attr_writer :include_info
 
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        sig { returns(T.nilable(String)) }
+        attr_reader :labels
+
+        sig { params(labels: String).void }
+        attr_writer :labels
+
         # Maximum number of results to return
         sig { returns(T.nilable(Integer)) }
         attr_reader :limit
@@ -56,6 +65,7 @@ module Cadenya
             agent_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             sort_order: String,
             request_options: Cadenya::RequestOptions::OrHash
@@ -69,6 +79,10 @@ module Cadenya
           # When true, the `info` field on each returned variation is populated. Requests
           # with this flag count more against your rate limit.
           include_info: nil,
+          # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+          # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+          # semantics).
+          labels: nil,
           # Maximum number of results to return
           limit: nil,
           # Sort order for results (asc or desc by creation time)
@@ -84,6 +98,7 @@ module Cadenya
               agent_id: String,
               cursor: String,
               include_info: T::Boolean,
+              labels: String,
               limit: Integer,
               sort_order: String,
               request_options: Cadenya::RequestOptions

data/rbi/cadenya/models/agents/webhook_delivery_list_params.rbi

@@ -46,6 +46,15 @@ module Cadenya
         end
         attr_writer :event_type
 
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        sig { returns(T.nilable(String)) }
+        attr_reader :labels
+
+        sig { params(labels: String).void }
+        attr_writer :labels
+
         # Maximum number of results to return
         sig { returns(T.nilable(Integer)) }
         attr_reader :limit
@@ -67,6 +76,7 @@ module Cadenya
             cursor: String,
             event_type:
               Cadenya::Agents::WebhookDeliveryListParams::EventType::OrSymbol,
+            labels: String,
             limit: Integer,
             objective_id: String,
             request_options: Cadenya::RequestOptions::OrHash
@@ -79,6 +89,10 @@ module Cadenya
           cursor: nil,
           # Optional filter by event type
           event_type: nil,
+          # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+          # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+          # semantics).
+          labels: nil,
           # Maximum number of results to return
           limit: nil,
           # Optional filter by objective ID
@@ -95,6 +109,7 @@ module Cadenya
               cursor: String,
               event_type:
                 Cadenya::Agents::WebhookDeliveryListParams::EventType::OrSymbol,
+              labels: String,
               limit: Integer,
               objective_id: String,
               request_options: Cadenya::RequestOptions

data/rbi/cadenya/models/ai_provider_key_list_params.rbi

@@ -29,6 +29,15 @@ module Cadenya
       sig { params(include_info: T::Boolean).void }
       attr_writer :include_info
 
+      # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+      # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+      # semantics).
+      sig { returns(T.nilable(String)) }
+      attr_reader :labels
+
+      sig { params(labels: String).void }
+      attr_writer :labels
+
       # Maximum number of results to return
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
@@ -71,6 +80,7 @@ module Cadenya
           workspace_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           prefix: String,
           promotional: T::Boolean,
@@ -86,6 +96,10 @@ module Cadenya
         # When true, populate each item's info (model counts), at the cost of extra
         # lookups.
         include_info: nil,
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        labels: nil,
         # Maximum number of results to return
         limit: nil,
         # Filter expression (query param: prefix)
@@ -108,6 +122,7 @@ module Cadenya
             workspace_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             prefix: String,
             promotional: T::Boolean,

data/rbi/cadenya/models/api_key_create_params.rbi

@@ -93,8 +93,11 @@ module Cadenya
         sig { params(external_id: String).void }
         attr_writer :external_id
 
-        # Arbitrary key-value pairs for categorization and filtering Examples:
-        # {"environment": "production", "team": "platform", "version": "v2"}
+        # Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric
+        # characters with "-", "\_", or "." allowed between; keys follow the same shape
+        # and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/")
+        # of at most 253 characters. Examples: {"environment": "production", "team":
+        # "platform", "version": "v2"}
         sig { returns(T.nilable(T::Hash[Symbol, String])) }
         attr_reader :labels
 
@@ -117,8 +120,11 @@ module Cadenya
           name:,
           # External ID for the resource (e.g., a workflow ID from an external system)
           external_id: nil,
-          # Arbitrary key-value pairs for categorization and filtering Examples:
-          # {"environment": "production", "team": "platform", "version": "v2"}
+          # Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric
+          # characters with "-", "\_", or "." allowed between; keys follow the same shape
+          # and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/")
+          # of at most 253 characters. Examples: {"environment": "production", "team":
+          # "platform", "version": "v2"}
           labels: nil
         )
         end

data/rbi/cadenya/models/api_key_list_params.rbi

@@ -26,6 +26,15 @@ module Cadenya
       sig { params(include_info: T::Boolean).void }
       attr_writer :include_info
 
+      # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+      # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+      # semantics).
+      sig { returns(T.nilable(String)) }
+      attr_reader :labels
+
+      sig { params(labels: String).void }
+      attr_writer :labels
+
       # Maximum number of results to return.
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
@@ -58,6 +67,7 @@ module Cadenya
         params(
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           prefix: String,
           query: String,
@@ -71,6 +81,10 @@ module Cadenya
         # When true, included info fields are populated. Requests with this flag count
         # more against your rate limit.
         include_info: nil,
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        labels: nil,
         # Maximum number of results to return.
         limit: nil,
         # Filter by ID prefix.
@@ -88,6 +102,7 @@ module Cadenya
           {
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             prefix: String,
             query: String,

data/rbi/cadenya/models/api_key_update_params.rbi

@@ -97,8 +97,11 @@ module Cadenya
         sig { params(external_id: String).void }
         attr_writer :external_id
 
-        # Arbitrary key-value pairs for categorization and filtering Examples:
-        # {"environment": "production", "team": "platform", "version": "v2"}
+        # Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric
+        # characters with "-", "\_", or "." allowed between; keys follow the same shape
+        # and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/")
+        # of at most 253 characters. Examples: {"environment": "production", "team":
+        # "platform", "version": "v2"}
         sig { returns(T.nilable(T::Hash[Symbol, String])) }
         attr_reader :labels
 
@@ -121,8 +124,11 @@ module Cadenya
           name:,
           # External ID for the resource (e.g., a workflow ID from an external system)
           external_id: nil,
-          # Arbitrary key-value pairs for categorization and filtering Examples:
-          # {"environment": "production", "team": "platform", "version": "v2"}
+          # Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric
+          # characters with "-", "\_", or "." allowed between; keys follow the same shape
+          # and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/")
+          # of at most 253 characters. Examples: {"environment": "production", "team":
+          # "platform", "version": "v2"}
           labels: nil
         )
         end