cadenya 0.32.0 → 0.33.0

data/rbi/cadenya/models/tool_set_list_events_params.rbi

@@ -31,6 +31,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
@@ -51,6 +60,7 @@ module Cadenya
           tool_set_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           sort_order: String,
           request_options: Cadenya::RequestOptions::OrHash
@@ -63,6 +73,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,
         # Sort order for results (asc or desc by creation time)
@@ -78,6 +92,7 @@ module Cadenya
             tool_set_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             sort_order: String,
             request_options: Cadenya::RequestOptions

data/rbi/cadenya/models/tool_set_list_params.rbi

@@ -28,6 +28,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
@@ -69,6 +78,7 @@ module Cadenya
           workspace_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           prefix: String,
           query: String,
@@ -83,6 +93,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,
         # Filter expression (query param: prefix)
@@ -104,6 +118,7 @@ module Cadenya
             workspace_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             prefix: String,
             query: String,

data/rbi/cadenya/models/tool_sets/tool_list_params.rbi

@@ -32,6 +32,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
@@ -98,6 +107,7 @@ module Cadenya
             tool_set_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             names: T::Array[String],
             prefix: String,
@@ -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,
           # Filter by tool name (exact match). Multiple values are OR'd together.
@@ -142,6 +156,7 @@ module Cadenya
               tool_set_id: String,
               cursor: String,
               include_info: T::Boolean,
+              labels: String,
               limit: Integer,
               names: T::Array[String],
               prefix: String,

data/rbi/cadenya/models/workspace_admin/profile_list_params.rbi

@@ -22,6 +22,15 @@ module Cadenya
         sig { params(cursor: String).void }
         attr_writer :cursor
 
+        # 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
@@ -40,6 +49,7 @@ module Cadenya
         sig do
           params(
             cursor: String,
+            labels: String,
             limit: Integer,
             query: String,
             request_options: Cadenya::RequestOptions::OrHash
@@ -48,6 +58,10 @@ module Cadenya
         def self.new(
           # Pagination cursor from previous response
           cursor: 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-form search over profile name and email. Case-insensitive substring match;
@@ -61,6 +75,7 @@ module Cadenya
           override.returns(
             {
               cursor: String,
+              labels: String,
               limit: Integer,
               query: String,
               request_options: Cadenya::RequestOptions

data/rbi/cadenya/models/workspace_admin_list_params.rbi

@@ -26,6 +26,15 @@ module Cadenya
       sig { params(include_archived: T::Boolean).void }
       attr_writer :include_archived
 
+      # 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
@@ -37,6 +46,7 @@ module Cadenya
         params(
           cursor: String,
           include_archived: T::Boolean,
+          labels: String,
           limit: Integer,
           request_options: Cadenya::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -47,6 +57,10 @@ module Cadenya
         # When true, archived workspaces are included in the results. Defaults to false
         # (active workspaces only).
         include_archived: 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,
         request_options: {}
@@ -58,6 +72,7 @@ module Cadenya
           {
             cursor: String,
             include_archived: T::Boolean,
+            labels: String,
             limit: Integer,
             request_options: Cadenya::RequestOptions
           }

data/rbi/cadenya/models/workspace_list_params.rbi

@@ -25,6 +25,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
@@ -43,6 +52,7 @@ module Cadenya
         params(
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           sort_order: String,
           request_options: Cadenya::RequestOptions::OrHash
@@ -53,6 +63,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,
         # Sort order for results (asc or desc by creation time)
@@ -66,6 +80,7 @@ module Cadenya
           {
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             sort_order: String,
             request_options: Cadenya::RequestOptions

data/rbi/cadenya/models/workspace_secret_list_params.rbi

@@ -28,6 +28,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
@@ -61,6 +70,7 @@ module Cadenya
           workspace_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           prefix: String,
           query: String,
@@ -74,6 +84,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,
         # Filter expression (query param: prefix)
@@ -92,6 +106,7 @@ module Cadenya
             workspace_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             prefix: String,
             query: String,

data/rbi/cadenya/resources/agents/feedback.rbi

@@ -17,6 +17,7 @@ module Cadenya
             created_before: Time,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             query: String,
             sentiment: Cadenya::Agents::FeedbackListParams::Sentiment::OrSymbol,
@@ -44,6 +45,10 @@ module Cadenya
           cursor: nil,
           # Query param: When set to true you may use more of your alloted API rate-limit
           include_info: nil,
+          # Query param: 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,
           # Query param: Maximum number of results to return.
           limit: nil,
           # Query param: Free-text search applied to the feedback comment. Case-insensitive

data/rbi/cadenya/resources/agents/schedules.rbi

@@ -96,6 +96,7 @@ module Cadenya
             workspace_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             prefix: String,
             query: String,
@@ -116,6 +117,10 @@ module Cadenya
           # Query param: When true, the `info` field on each returned schedule is populated.
           # Requests with this flag count more against your rate limit.
           include_info: nil,
+          # Query param: 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,
           # Query param: Maximum number of results to return.
           limit: nil,
           # Query param: Filter expression (query param: prefix).

data/rbi/cadenya/resources/agents/variations.rbi

@@ -98,6 +98,7 @@ module Cadenya
             workspace_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             sort_order: String,
             request_options: Cadenya::RequestOptions::OrHash
@@ -116,6 +117,10 @@ module Cadenya
           # Query param: When true, the `info` field on each returned variation is
           # populated. Requests with this flag count more against your rate limit.
           include_info: nil,
+          # Query param: 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,
           # Query param: Maximum number of results to return
           limit: nil,
           # Query param: Sort order for results (asc or desc by creation time)

data/rbi/cadenya/resources/agents/webhook_deliveries.rbi

@@ -13,6 +13,7 @@ module Cadenya
             cursor: String,
             event_type:
               Cadenya::Agents::WebhookDeliveryListParams::EventType::OrSymbol,
+            labels: String,
             limit: Integer,
             objective_id: String,
             request_options: Cadenya::RequestOptions::OrHash
@@ -31,6 +32,10 @@ module Cadenya
           cursor: nil,
           # Query param: Optional filter by event type
           event_type: nil,
+          # Query param: 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,
           # Query param: Maximum number of results to return
           limit: nil,
           # Query param: Optional filter by objective ID

data/rbi/cadenya/resources/agents.rbi

@@ -102,6 +102,7 @@ module Cadenya
           workspace_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           prefix: String,
           query: String,
@@ -120,6 +121,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)

data/rbi/cadenya/resources/ai_provider_keys.rbi

@@ -76,6 +76,7 @@ module Cadenya
           workspace_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           prefix: String,
           promotional: T::Boolean,
@@ -92,6 +93,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)

data/rbi/cadenya/resources/api_keys/access.rbi

@@ -11,6 +11,7 @@ module Cadenya
           params(
             id: String,
             cursor: String,
+            labels: String,
             limit: Integer,
             request_options: Cadenya::RequestOptions::OrHash
           ).returns(Cadenya::Internal::CursorPagination[Cadenya::Workspace])
@@ -20,6 +21,10 @@ module Cadenya
           id,
           # Pagination cursor from previous response.
           cursor: 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,
           request_options: {}

data/rbi/cadenya/resources/api_keys.rbi

@@ -78,6 +78,7 @@ module Cadenya
         params(
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           prefix: String,
           query: String,
@@ -91,6 +92,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.

data/rbi/cadenya/resources/memory_layers/entries.rbi

@@ -101,6 +101,7 @@ module Cadenya
             workspace_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             prefix: String,
             query: String,
@@ -122,6 +123,10 @@ module Cadenya
           cursor: nil,
           # Query param: When set to true you may use more of your alloted API rate-limit
           include_info: nil,
+          # Query param: 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,
           # Query param: Maximum number of results to return
           limit: nil,
           # Query param: Filter by key prefix (e.g., "skills/postmortem/" to list all

data/rbi/cadenya/resources/memory_layers.rbi

@@ -88,6 +88,7 @@ module Cadenya
           cursor: String,
           episodic_key_prefix: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           prefix: String,
           query: String,
@@ -108,6 +109,10 @@ module Cadenya
         episodic_key_prefix: 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,
         # Filter expression (query param: prefix)

data/rbi/cadenya/resources/models.rbi

@@ -31,6 +31,7 @@ module Cadenya
           cursor: String,
           include_info: T::Boolean,
           is_assigned: T::Boolean,
+          labels: String,
           limit: Integer,
           prefix: String,
           query: String,
@@ -54,6 +55,10 @@ module Cadenya
         # agents count as assigned; archived agents do not. Assignment does not imply
         # recent traffic — see ModelInfo.last_used_at for that.
         is_assigned: 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 name prefix

data/rbi/cadenya/resources/objectives/feedback.rbi

@@ -37,6 +37,7 @@ module Cadenya
             objective_id: String,
             workspace_id: String,
             cursor: String,
+            labels: String,
             limit: Integer,
             request_options: Cadenya::RequestOptions::OrHash
           ).returns(
@@ -53,6 +54,10 @@ module Cadenya
           workspace_id:,
           # Query param: Pagination cursor from previous response
           cursor: nil,
+          # Query param: 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,
           # Query param: Maximum number of results to return
           limit: nil,
           request_options: {}

data/rbi/cadenya/resources/objectives/tool_calls.rbi

@@ -33,6 +33,7 @@ module Cadenya
             execution_status:
               Cadenya::Objectives::ToolCallListParams::ExecutionStatus::OrSymbol,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             status: Cadenya::Objectives::ToolCallListParams::Status::OrSymbol,
             request_options: Cadenya::RequestOptions::OrHash
@@ -55,6 +56,10 @@ module Cadenya
           execution_status: nil,
           # Query param: When set to true you may use more of your alloted API rate-limit
           include_info: nil,
+          # Query param: 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,
           # Query param: Maximum number of results to return
           limit: nil,
           # Query param: Filter by tool call status

data/rbi/cadenya/resources/objectives.rbi

@@ -98,6 +98,7 @@ module Cadenya
           agent_schedule_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           parent_objective_id: String,
           profile_id: String,
@@ -117,6 +118,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,
         # Optional filters
@@ -211,6 +216,7 @@ module Cadenya
           workspace_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           request_options: Cadenya::RequestOptions::OrHash
         ).returns(
@@ -226,6 +232,10 @@ module Cadenya
         cursor: nil,
         # Query param: When set to true you may use more of your alloted API rate-limit
         include_info: nil,
+        # Query param: 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,
         # Query param: Maximum number of results to return
         limit: nil,
         request_options: {}
@@ -239,6 +249,7 @@ module Cadenya
           workspace_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           since_event_id: String,
           sort_order: String,
@@ -255,6 +266,10 @@ module Cadenya
         cursor: nil,
         # Query param: When set to true you may use more of your alloted API rate-limit
         include_info: nil,
+        # Query param: 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,
         # Query param: Maximum number of results to return
         limit: nil,
         # Query param: Optional string to fetch events since an ID

data/rbi/cadenya/resources/tool_sets/tools.rbi

@@ -97,6 +97,7 @@ module Cadenya
             workspace_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             names: T::Array[String],
             prefix: String,
@@ -120,6 +121,10 @@ module Cadenya
           cursor: nil,
           # Query param: When set to true you may use more of your alloted API rate-limit
           include_info: nil,
+          # Query param: 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,
           # Query param: Maximum number of results to return
           limit: nil,
           # Query param: Filter by tool name (exact match). Multiple values are OR'd

data/rbi/cadenya/resources/tool_sets.rbi

@@ -98,6 +98,7 @@ module Cadenya
           workspace_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           prefix: String,
           query: String,
@@ -113,6 +114,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,
         # Filter expression (query param: prefix)
@@ -191,6 +196,7 @@ module Cadenya
           workspace_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           sort_order: String,
           request_options: Cadenya::RequestOptions::OrHash
@@ -206,6 +212,10 @@ module Cadenya
         cursor: nil,
         # Query param: When set to true you may use more of your alloted API rate-limit
         include_info: nil,
+        # Query param: 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,
         # Query param: Maximum number of results to return
         limit: nil,
         # Query param: Sort order for results (asc or desc by creation time)