chore: update api ref docs and fix schemas (#5219)

docs/docs/cloud/reference/api/openapi.json

@@ -2601,8 +2601,7 @@
             "description": "Configuration to use for the graph. Useful when graph is configurable and you want to update the assistant's configuration."
           },
           "metadata": {
-            "type": "object",
-            "title": "Metadata",
+            "type": "object",            "title": "Metadata",
             "description": "Metadata to merge with existing assistant metadata."
           },
           "name": {
@@ -2708,6 +2707,13 @@
             "title": "Schedule",
             "description": "The cron schedule to execute this job on."
           },
+          "end_time": {
+            "type": "string",
+            "format": "date-time",
+            "title": "End Time",
+            "description": "The end date to stop running the cron."
+          },
+
           "assistant_id": {
             "anyOf": [
               {
@@ -2814,6 +2820,18 @@
             "description": "The number of results to skip.",
             "default": 0,
             "minimum": 0
+          },
+          "sort_by": {
+            "type": "string",
+            "enum": ["cron_id", "assistant_id", "thread_id", "next_run_date", "end_time", "created_at", "updated_at"],
+            "title": "Sort By",
+            "description": "The field to sort by."
+          },
+          "sort_order": {
+            "type": "string",
+            "enum": ["asc", "desc"],
+            "title": "Sort Order",
+            "description": "The order to sort by."
           }
         },
         "type": "object",

libs/sdk-js/src/schema.ts

@@ -178,6 +178,9 @@ export interface Cron {
   /** The ID of the cron */
   cron_id: string;
 
+  /** The ID of the assistant */
+  assistant_id: string;
+
   /** The ID of the thread */
   thread_id: Optional<string>;
 
@@ -195,6 +198,15 @@ export interface Cron {
 
   /** The run payload to use for creating new run. */
   payload: Record<string, unknown>;
+
+  /** The user ID of the cron */
+  user_id: Optional<string>;
+
+  /** The next run date of the cron */
+  next_run_date: Optional<string>;
+
+  /** The metadata of the cron */
+  metadata: Record<string, unknown>;
 }
 
 export type DefaultValues = Record<string, unknown>[] | Record<string, unknown>;

libs/sdk-py/langgraph_sdk/schema.py

@@ -319,6 +319,8 @@ class Cron(TypedDict):
 
     cron_id: str
     """The ID of the cron."""
+    assistant_id: str
+    """The ID of the assistant."""
     thread_id: str | None
     """The ID of the thread."""
     end_time: datetime | None
@@ -331,6 +333,12 @@ class Cron(TypedDict):
     """The last time the cron was updated."""
     payload: dict
     """The run payload to use for creating new run."""
+    user_id: str | None
+    """The user ID of the cron."""
+    next_run_date: datetime | None
+    """The next run date of the cron."""
+    metadata: dict
+    """The metadata of the cron."""
 
 
 class RunCreate(TypedDict):