langgraph-api 0.5.4__py3-none-any.whl → 0.7.3__py3-none-any.whl

openapi.json

@@ -45,9 +45,7 @@
   "paths": {
     "/assistants": {
       "post": {
-        "tags": [
-          "Assistants"
-        ],
+        "tags": ["Assistants"],
         "summary": "Create Assistant",
         "description": "Create an assistant.\n\nAn initial version of the assistant will be created and the assistant is set to that version. To change versions, use the `POST /assistants/{assistant_id}/latest` endpoint.",
         "operationId": "create_assistant_assistants_post",
@@ -107,9 +105,7 @@
     },
     "/assistants/search": {
       "post": {
-        "tags": [
-          "Assistants"
-        ],
+        "tags": ["Assistants"],
         "summary": "Search Assistants",
         "description": "Search for assistants.\n\nThis endpoint also functions as the endpoint to list all assistants.",
         "operationId": "search_assistants_assistants_search_post",
@@ -163,9 +159,7 @@
     },
     "/assistants/count": {
       "post": {
-        "tags": [
-          "Assistants"
-        ],
+        "tags": ["Assistants"],
         "summary": "Count Assistants",
         "description": "Get the count of assistants matching the specified criteria.",
         "operationId": "count_assistants_assistants_count_post",
@@ -216,9 +210,7 @@
     },
     "/assistants/{assistant_id}": {
       "get": {
-        "tags": [
-          "Assistants"
-        ],
+        "tags": ["Assistants"],
         "summary": "Get Assistant",
         "description": "Get an assistant by ID.",
         "operationId": "get_assistant_assistants__assistant_id__get",
@@ -260,9 +252,7 @@
         }
       },
       "delete": {
-        "tags": [
-          "Assistants"
-        ],
+        "tags": ["Assistants"],
         "summary": "Delete Assistant",
         "description": "Delete an assistant by ID.\n\nAll versions of the assistant will be deleted as well.",
         "operationId": "delete_assistant_assistants__assistant_id__delete",
@@ -278,6 +268,17 @@
             },
             "name": "assistant_id",
             "in": "path"
+          },
+          {
+            "description": "If true, delete all threads with metadata.assistant_id matching this assistant, along with runs and checkpoints belonging to those threads. Auth filters are applied, so threads not visible to the user will not be deleted.",
+            "required": false,
+            "schema": {
+              "type": "boolean",
+              "default": false,
+              "title": "Delete Threads"
+            },
+            "name": "delete_threads",
+            "in": "query"
           }
         ],
         "responses": {
@@ -312,9 +313,7 @@
         }
       },
       "patch": {
-        "tags": [
-          "Assistants"
-        ],
+        "tags": ["Assistants"],
         "summary": "Patch Assistant",
         "description": "Update an assistant.",
         "operationId": "patch_assistant_assistants__assistant_id__patch",
@@ -378,9 +377,7 @@
     },
     "/assistants/{assistant_id}/graph": {
       "get": {
-        "tags": [
-          "Assistants"
-        ],
+        "tags": ["Assistants"],
         "summary": "Get Assistant Graph",
         "description": "Get an assistant by ID.",
         "operationId": "get_assistant_graph_assistants__assistant_id__graph_get",
@@ -469,9 +466,7 @@
     },
     "/assistants/{assistant_id}/subgraphs": {
       "get": {
-        "tags": [
-          "Assistants"
-        ],
+        "tags": ["Assistants"],
         "summary": "Get Assistant Subgraphs",
         "description": "Get an assistant's subgraphs.",
         "operationId": "get_assistant_subgraphs_assistants__assistant_id__subgraphs_get",
@@ -535,9 +530,7 @@
     },
     "/assistants/{assistant_id}/subgraphs/{namespace}": {
       "get": {
-        "tags": [
-          "Assistants"
-        ],
+        "tags": ["Assistants"],
         "summary": "Get Assistant Subgraphs by Namespace",
         "description": "Get an assistant's subgraphs filtered by namespace.",
         "operationId": "get_assistant_subgraphs_assistants__assistant_id__subgraphs__namespace__get",
@@ -601,9 +594,7 @@
     },
     "/assistants/{assistant_id}/schemas": {
       "get": {
-        "tags": [
-          "Assistants"
-        ],
+        "tags": ["Assistants"],
         "summary": "Get Assistant Schemas",
         "description": "Get an assistant by ID.",
         "operationId": "get_assistant_schemas_assistants__assistant_id__schemas_get",
@@ -657,9 +648,7 @@
     },
     "/assistants/{assistant_id}/versions": {
       "post": {
-        "tags": [
-          "Assistants"
-        ],
+        "tags": ["Assistants"],
         "summary": "Get Assistant Versions",
         "description": "Get all versions of an assistant.",
         "operationId": "get_assistant_versions_assistants__assistant_id__versions_get",
@@ -707,9 +696,7 @@
     },
     "/assistants/{assistant_id}/latest": {
       "post": {
-        "tags": [
-          "Assistants"
-        ],
+        "tags": ["Assistants"],
         "summary": "Set Latest Assistant Version",
         "description": "Set the latest version for an assistant.",
         "operationId": "set_latest_assistant_version_assistants__assistant_id__versions_post",
@@ -774,9 +761,7 @@
     },
     "/threads": {
       "post": {
-        "tags": [
-          "Threads"
-        ],
+        "tags": ["Threads"],
         "summary": "Create Thread",
         "description": "Create a thread.",
         "operationId": "create_thread_threads_post",
@@ -826,9 +811,7 @@
     },
     "/threads/search": {
       "post": {
-        "tags": [
-          "Threads"
-        ],
+        "tags": ["Threads"],
         "summary": "Search Threads",
         "description": "Search for threads.\n\nThis endpoint also functions as the endpoint to list all threads.",
         "operationId": "search_threads_threads_search_post",
@@ -872,9 +855,7 @@
     },
     "/threads/count": {
       "post": {
-        "tags": [
-          "Threads"
-        ],
+        "tags": ["Threads"],
         "summary": "Count Threads",
         "description": "Get the count of threads matching the specified criteria.",
         "operationId": "count_threads_threads_count_post",
@@ -923,11 +904,49 @@
         }
       }
     },
+    "/threads/prune": {
+      "post": {
+        "tags": ["Threads"],
+        "summary": "Prune Threads",
+        "description": "Prune threads by ID. The 'delete' strategy removes threads entirely. The 'keep_latest' strategy prunes old checkpoints but keeps threads and their latest state (requires FF_USE_CORE_API=true).",
+        "operationId": "prune_threads_threads_prune_post",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ThreadPruneRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ThreadPruneResponse"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation Error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/threads/{thread_id}/state": {
       "get": {
-        "tags": [
-          "Threads"
-        ],
+        "tags": ["Threads"],
         "summary": "Get Thread State",
         "description": "Get state for a thread.\n\nThe latest state of the thread (i.e. latest checkpoint) is returned.",
         "operationId": "get_latest_thread_state_threads__thread_id__state_get",
@@ -980,9 +999,7 @@
         }
       },
       "post": {
-        "tags": [
-          "Threads"
-        ],
+        "tags": ["Threads"],
         "summary": "Update Thread State",
         "description": "Add state to a thread.",
         "operationId": "update_thread_state_threads__thread_id__state_post",
@@ -1036,9 +1053,7 @@
     },
     "/threads/{thread_id}/state/{checkpoint_id}": {
       "get": {
-        "tags": [
-          "Threads"
-        ],
+        "tags": ["Threads"],
         "summary": "Get Thread State At Checkpoint",
         "description": "Get state for a thread at a specific checkpoint.",
         "operationId": "get_thread_state_at_checkpoint_threads__thread_id__state__checkpoint_id__get",
@@ -1105,9 +1120,7 @@
     },
     "/threads/{thread_id}/state/checkpoint": {
       "post": {
-        "tags": [
-          "Threads"
-        ],
+        "tags": ["Threads"],
         "summary": "Get Thread State At Checkpoint",
         "description": "Get state for a thread at a specific checkpoint.",
         "operationId": "post_thread_state_at_checkpoint_threads__thread_id__state__checkpoint_id__get",
@@ -1171,9 +1184,7 @@
     },
     "/threads/{thread_id}/history": {
       "get": {
-        "tags": [
-          "Threads"
-        ],
+        "tags": ["Threads"],
         "summary": "Get Thread History",
         "description": "Get all past states for a thread.",
         "operationId": "get_thread_history_threads__thread_id__history_get",
@@ -1238,9 +1249,7 @@
         }
       },
       "post": {
-        "tags": [
-          "Threads"
-        ],
+        "tags": ["Threads"],
         "summary": "Get Thread History Post",
         "description": "Get all past states for a thread.",
         "operationId": "get_thread_history_post_threads__thread_id__history_post",
@@ -1298,9 +1307,7 @@
     },
     "/threads/{thread_id}/copy": {
       "post": {
-        "tags": [
-          "Threads"
-        ],
+        "tags": ["Threads"],
         "summary": "Copy Thread",
         "description": "Create a new thread with a copy of the state and checkpoints from an existing thread.",
         "operationId": "copy_thread_post_threads__thread_id__copy_post",
@@ -1354,9 +1361,7 @@
     },
     "/threads/{thread_id}": {
       "get": {
-        "tags": [
-          "Threads"
-        ],
+        "tags": ["Threads"],
         "summary": "Get Thread",
         "description": "Get a thread by ID.",
         "operationId": "get_thread_threads__thread_id__get",
@@ -1372,6 +1377,17 @@
             },
             "name": "thread_id",
             "in": "path"
+          },
+          {
+            "description": "Comma-separated list of additional fields to include. Supported values: ttl",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "title": "Include",
+              "description": "Comma-separated list of additional fields to include."
+            },
+            "name": "include",
+            "in": "query"
           }
         ],
         "responses": {
@@ -1408,9 +1424,7 @@
         }
       },
       "delete": {
-        "tags": [
-          "Threads"
-        ],
+        "tags": ["Threads"],
         "summary": "Delete Thread",
         "description": "Delete a thread by ID.",
         "operationId": "delete_thread_threads__thread_id__delete",
@@ -1460,9 +1474,7 @@
         }
       },
       "patch": {
-        "tags": [
-          "Threads"
-        ],
+        "tags": ["Threads"],
         "summary": "Patch Thread",
         "description": "Update a thread.",
         "operationId": "patch_thread_threads__thread_id__patch",
@@ -1526,9 +1538,7 @@
     },
     "/threads/{thread_id}/stream": {
       "get": {
-        "tags": [
-          "Threads"
-        ],
+        "tags": ["Threads"],
         "summary": "Join Thread Stream",
         "description": "This endpoint streams output in real-time from a thread. The stream will include the output of each run executed sequentially on the thread and will remain open indefinitely. It is the responsibility of the calling client to close the connection.",
         "operationId": "join_thread_stream_threads__thread_id__stream_get",
@@ -1616,9 +1626,7 @@
     },
     "/threads/{thread_id}/runs": {
       "get": {
-        "tags": [
-          "Thread Runs"
-        ],
+        "tags": ["Thread Runs"],
         "summary": "List Runs",
         "description": "List runs for a thread.",
         "operationId": "list_runs_http_threads__thread_id__runs_get",
@@ -1659,13 +1667,7 @@
             "required": false,
             "schema": {
               "type": "string",
-              "enum": [
-                "pending",
-                "error",
-                "success",
-                "timeout",
-                "interrupted"
-              ]
+              "enum": ["pending", "error", "success", "timeout", "interrupted"]
             },
             "name": "status",
             "in": "query"
@@ -1732,9 +1734,7 @@
         }
       },
       "post": {
-        "tags": [
-          "Thread Runs"
-        ],
+        "tags": ["Thread Runs"],
         "summary": "Create Background Run",
         "description": "Create a run in existing thread, return the run ID immediately. Don't wait for the final run output.",
         "operationId": "create_run_threads__thread_id__runs_post",
@@ -1816,9 +1816,7 @@
     },
     "/threads/{thread_id}/runs/crons": {
       "post": {
-        "tags": [
-          "Crons (Plus tier)"
-        ],
+        "tags": ["Crons (Plus tier)"],
         "summary": "Create Thread Cron",
         "description": "Create a cron to schedule runs on a thread.",
         "operationId": "create_thread_cron_threads__thread_id__runs_crons_post",
@@ -1840,7 +1838,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/CronCreate"
+                "$ref": "#/components/schemas/ThreadCronCreate"
               }
             }
           },
@@ -1882,9 +1880,7 @@
     },
     "/threads/{thread_id}/runs/stream": {
       "post": {
-        "tags": [
-          "Thread Runs"
-        ],
+        "tags": ["Thread Runs"],
         "summary": "Create Run, Stream Output",
         "description": "Create a run in existing thread. Stream the output.",
         "operationId": "stream_run_threads__thread_id__runs_stream_post",
@@ -1967,9 +1963,7 @@
     },
     "/threads/{thread_id}/runs/wait": {
       "post": {
-        "tags": [
-          "Thread Runs"
-        ],
+        "tags": ["Thread Runs"],
         "summary": "Create Run, Wait for Output",
         "description": "Create a run in existing thread. Wait for the final output and then return it.",
         "operationId": "wait_run_threads__thread_id__runs_wait_post",
@@ -2049,9 +2043,7 @@
     },
     "/threads/{thread_id}/runs/{run_id}": {
       "get": {
-        "tags": [
-          "Thread Runs"
-        ],
+        "tags": ["Thread Runs"],
         "summary": "Get Run",
         "description": "Get a run by ID.",
         "operationId": "get_run_http_threads__thread_id__runs__run_id__get",
@@ -2115,9 +2107,7 @@
         }
       },
       "delete": {
-        "tags": [
-          "Thread Runs"
-        ],
+        "tags": ["Thread Runs"],
         "summary": "Delete Run",
         "description": "Delete a run by ID.",
         "operationId": "delete_run_threads__thread_id__runs__run_id__delete",
@@ -2181,9 +2171,7 @@
     },
     "/threads/{thread_id}/runs/{run_id}/join": {
       "get": {
-        "tags": [
-          "Thread Runs"
-        ],
+        "tags": ["Thread Runs"],
         "summary": "Join Run",
         "description": "Wait for a run to finish.",
         "operationId": "join_run_http_threads__thread_id__runs__run_id__join_get",
@@ -2258,9 +2246,7 @@
     },
     "/threads/{thread_id}/runs/{run_id}/stream": {
       "get": {
-        "tags": [
-          "Thread Runs"
-        ],
+        "tags": ["Thread Runs"],
         "summary": "Join Run Stream",
         "description": "Join a run stream. This endpoint streams output in real-time from a run similar to the /threads/__THREAD_ID__/runs/stream endpoint. If the run has been created with `stream_resumable=true`, the stream can be resumed from the last seen event ID.",
         "operationId": "stream_run_http_threads__thread_id__runs__run_id__join_get",
@@ -2358,9 +2344,7 @@
     },
     "/threads/{thread_id}/runs/{run_id}/cancel": {
       "post": {
-        "tags": [
-          "Thread Runs"
-        ],
+        "tags": ["Thread Runs"],
         "summary": "Cancel Run",
         "operationId": "cancel_run_http_threads__thread_id__runs__run_id__cancel_post",
         "parameters": [
@@ -2403,10 +2387,7 @@
             "required": false,
             "schema": {
               "type": "string",
-              "enum": [
-                "interrupt",
-                "rollback"
-              ],
+              "enum": ["interrupt", "rollback"],
               "title": "Action",
               "default": "interrupt"
             },
@@ -2448,9 +2429,7 @@
     },
     "/runs/crons": {
       "post": {
-        "tags": [
-          "Crons (Plus tier)"
-        ],
+        "tags": ["Crons (Plus tier)"],
         "summary": "Create Cron",
         "description": "Create a cron to schedule runs on new threads.",
         "operationId": "create_cron_runs_crons_post",
@@ -2500,9 +2479,7 @@
     },
     "/runs/crons/search": {
       "post": {
-        "tags": [
-          "Crons (Plus tier)"
-        ],
+        "tags": ["Crons (Plus tier)"],
         "summary": "Search Crons",
         "description": "Search all active crons",
         "operationId": "search_crons_runs_crons_post",
@@ -2546,9 +2523,7 @@
     },
     "/runs/crons/count": {
       "post": {
-        "tags": [
-          "Crons (Plus tier)"
-        ],
+        "tags": ["Crons (Plus tier)"],
         "summary": "Count Crons",
         "description": "Get the count of crons matching the specified criteria.",
         "operationId": "count_crons_runs_crons_count_post",
@@ -2599,11 +2574,9 @@
     },
     "/runs/stream": {
       "post": {
-        "tags": [
-          "Stateless Runs"
-        ],
+        "tags": ["Stateless Runs"],
         "summary": "Create Run, Stream Output",
-        "description": "Create a run in a new thread, stream the output.",
+        "description": "Create a run and stream the output.",
         "operationId": "stream_run_stateless_runs_stream_post",
         "requestBody": {
           "content": {
@@ -2670,9 +2643,7 @@
     },
     "/runs/cancel": {
       "post": {
-        "tags": [
-          "Thread Runs"
-        ],
+        "tags": ["Thread Runs"],
         "summary": "Cancel Runs",
         "description": "Cancel one or more runs. Can cancel runs by thread ID and run IDs, or by status filter.",
         "operationId": "cancel_runs_post",
@@ -2682,10 +2653,7 @@
             "required": false,
             "schema": {
               "type": "string",
-              "enum": [
-                "interrupt",
-                "rollback"
-              ],
+              "enum": ["interrupt", "rollback"],
               "title": "Action",
               "default": "interrupt"
             },
@@ -2732,11 +2700,9 @@
     },
     "/runs/wait": {
       "post": {
-        "tags": [
-          "Stateless Runs"
-        ],
+        "tags": ["Stateless Runs"],
         "summary": "Create Run, Wait for Output",
-        "description": "Create a run in a new thread. Wait for the final output and then return it.",
+        "description": "Create a run, wait for the final output and then return it.",
         "operationId": "wait_run_stateless_runs_wait_post",
         "requestBody": {
           "content": {
@@ -2800,11 +2766,9 @@
     },
     "/runs": {
       "post": {
-        "tags": [
-          "Stateless Runs"
-        ],
+        "tags": ["Stateless Runs"],
         "summary": "Create Background Run",
-        "description": "Create a run in a new thread, return the run ID immediately. Don't wait for the final run output.",
+        "description": "Create a run and return the run ID immediately. Don't wait for the final run output.",
         "operationId": "run_stateless_runs_post",
         "requestBody": {
           "content": {
@@ -2868,11 +2832,9 @@
     },
     "/runs/batch": {
       "post": {
-        "tags": [
-          "Stateless Runs"
-        ],
+        "tags": ["Stateless Runs"],
         "summary": "Create Run Batch",
-        "description": "Create a batch of runs in new threads, return immediately.",
+        "description": "Create a batch of runs and return immediately.",
         "operationId": "run_batch_stateless_runs_post",
         "requestBody": {
           "content": {
@@ -2928,9 +2890,7 @@
     },
     "/runs/crons/{cron_id}": {
       "delete": {
-        "tags": [
-          "Crons (Plus tier)"
-        ],
+        "tags": ["Crons (Plus tier)"],
         "summary": "Delete Cron",
         "description": "Delete a cron by ID.",
         "operationId": "delete_cron_runs_crons__cron_id__delete",
@@ -2980,9 +2940,7 @@
     },
     "/store/items": {
       "put": {
-        "tags": [
-          "Store"
-        ],
+        "tags": ["Store"],
         "summary": "Store or update an item.",
         "operationId": "put_item",
         "requestBody": {
@@ -3012,9 +2970,7 @@
         }
       },
       "delete": {
-        "tags": [
-          "Store"
-        ],
+        "tags": ["Store"],
         "summary": "Delete an item.",
         "operationId": "delete_item",
         "requestBody": {
@@ -3044,9 +3000,7 @@
         }
       },
       "get": {
-        "tags": [
-          "Store"
-        ],
+        "tags": ["Store"],
         "summary": "Retrieve a single item.",
         "operationId": "get_item",
         "parameters": [
@@ -3106,9 +3060,7 @@
     },
     "/store/items/search": {
       "post": {
-        "tags": [
-          "Store"
-        ],
+        "tags": ["Store"],
         "summary": "Search for items within a namespace prefix.",
         "operationId": "search_items",
         "requestBody": {
@@ -3147,9 +3099,7 @@
     },
     "/store/namespaces": {
       "post": {
-        "tags": [
-          "Store"
-        ],
+        "tags": ["Store"],
         "summary": "List namespaces with optional match conditions.",
         "operationId": "list_namespaces",
         "requestBody": {
@@ -3189,8 +3139,8 @@
     "/a2a/{assistant_id}": {
       "post": {
         "operationId": "post_a2a",
-        "summary": "A2A Post",
-        "description": "Communicate with an assistant using the Agent-to-Agent Protocol.\nSends a JSON-RPC 2.0 message to the assistant.\n\n- **Request**: Provide an object with `jsonrpc`, `id`, `method`, and optional `params`.\n- **Response**: Returns a JSON-RPC response with task information or error.\n\n**Supported Methods:**\n- `message/send`: Send a message to the assistant\n- `tasks/get`: Get the status and result of a task\n\n**Notes:**\n- Supports threaded conversations via thread context\n- Messages can contain text and data parts\n- Tasks run asynchronously and return completion status\n",
+        "summary": "A2A JSON-RPC",
+        "description": "Communicate with an assistant using the Agent-to-Agent (A2A) Protocol over JSON-RPC 2.0.\nThis endpoint accepts a JSON-RPC envelope and dispatches based on `method`.\n\n**Supported Methods:**\n- `message/send`: Send a message and wait for the final Task result.\n- `message/stream`: Send a message and receive Server-Sent Events (SSE) JSON-RPC responses.\n- `tasks/get`: Fetch the current state of a Task by ID.\n- `tasks/cancel`: Request cancellation (currently not supported; returns an error).\n\n**LangGraph Mapping:**\n- `message.contextId` maps to LangGraph `thread_id`.\n\n**Notes:**\n- Only `text` and `data` parts are supported; `file` parts are not.\n- If `message.contextId` is omitted, a new context is created.\n- Text parts require the assistant input schema to include a `messages` field.\n",
         "parameters": [
           {
             "name": "assistant_id",
@@ -3207,10 +3157,9 @@
             "in": "header",
             "required": true,
             "schema": {
-              "type": "string",
-              "enum": ["application/json"]
+              "type": "string"
             },
-            "description": "Must be application/json"
+            "description": "For `message/stream`, must include `text/event-stream`. For all other methods, use `application/json`."
           }
         ],
         "requestBody": {
@@ -3231,23 +3180,29 @@
                   },
                   "method": {
                     "type": "string",
-                    "enum": ["message/send", "tasks/get"],
+                    "enum": [
+                      "message/send",
+                      "message/stream",
+                      "tasks/get",
+                      "tasks/cancel"
+                    ],
                     "description": "The method to invoke"
                   },
                   "params": {
                     "type": "object",
-                    "description": "Method parameters",
+                    "description": "Method parameters; shape depends on the method.",
                     "oneOf": [
                       {
-                        "title": "Message Send Parameters",
+                        "title": "Message Send/Stream Parameters",
+                        "type": "object",
                         "properties": {
                           "message": {
                             "type": "object",
                             "properties": {
                               "role": {
                                 "type": "string",
-                                "enum": ["user", "assistant"],
-                                "description": "Message role"
+                                "enum": ["user", "agent"],
+                                "description": "A2A role for the message sender."
                               },
                               "parts": {
                                 "type": "array",
@@ -3262,13 +3217,14 @@
                                           "enum": ["text"]
                                         },
                                         "text": {
-                                          "type": "string"
+                                          "type": "string",
+                                          "description": "Text content."
                                         }
                                       },
                                       "required": ["kind", "text"]
                                     },
                                     {
-                                      "title": "Data Part", 
+                                      "title": "Data Part",
                                       "type": "object",
                                       "properties": {
                                         "kind": {
@@ -3276,56 +3232,156 @@
                                           "enum": ["data"]
                                         },
                                         "data": {
-                                          "type": "object"
+                                          "type": "object",
+                                          "description": "Structured JSON merged into the assistant input."
                                         }
                                       },
                                       "required": ["kind", "data"]
                                     }
                                   ]
                                 },
-                                "description": "Message parts"
+                                "description": "Message parts (text/data only)."
                               },
                               "messageId": {
                                 "type": "string",
-                                "description": "Unique message identifier"
-                              }
-                            },
-                            "required": ["role", "parts", "messageId"]
-                          },
-                          "thread": {
-                            "type": "object",
-                            "properties": {
-                              "threadId": {
+                                "description": "Client-generated message identifier."
+                              },
+                              "contextId": {
+                                "type": "string",
+                                "description": "Conversation context ID; maps to LangGraph thread_id."
+                              },
+                              "taskId": {
                                 "type": "string",
-                                "description": "Thread identifier for conversation context"
+                                "description": "Optional task ID. Currently ignored by this implementation."
                               }
                             },
-                            "description": "Optional thread context"
+                            "required": ["role", "parts", "messageId"]
                           }
                         },
                         "required": ["message"]
                       },
                       {
                         "title": "Task Get Parameters",
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string",
+                            "description": "Task (run) identifier to retrieve."
+                          },
+                          "contextId": {
+                            "type": "string",
+                            "description": "Context identifier (thread_id) for the task."
+                          },
+                          "historyLength": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 10,
+                            "description": "Maximum number of history messages to include."
+                          }
+                        },
+                        "required": ["id", "contextId"]
+                      },
+                      {
+                        "title": "Task Cancel Parameters",
+                        "type": "object",
                         "properties": {
-                          "taskId": {
+                          "id": {
+                            "type": "string",
+                            "description": "Task (run) identifier to cancel."
+                          },
+                          "contextId": {
                             "type": "string",
-                            "description": "Task identifier to retrieve"
+                            "description": "Context identifier (thread_id) for the task."
                           }
                         },
-                        "required": ["taskId"]
+                        "required": ["id", "contextId"]
                       }
                     ]
                   }
                 },
                 "required": ["jsonrpc", "id", "method"]
+              },
+              "examples": {
+                "message_send": {
+                  "summary": "Send a message (synchronous)",
+                  "value": {
+                    "jsonrpc": "2.0",
+                    "id": "1",
+                    "method": "message/send",
+                    "params": {
+                      "message": {
+                        "role": "user",
+                        "parts": [
+                          {
+                            "kind": "text",
+                            "text": "Hello from A2A"
+                          },
+                          {
+                            "kind": "data",
+                            "data": {
+                              "locale": "en-US"
+                            }
+                          }
+                        ],
+                        "messageId": "msg-1",
+                        "contextId": "f5bd2a40-74b6-4f7a-b649-ea3f09890003"
+                      }
+                    }
+                  }
+                },
+                "message_stream": {
+                  "summary": "Send a message (streaming)",
+                  "value": {
+                    "jsonrpc": "2.0",
+                    "id": "2",
+                    "method": "message/stream",
+                    "params": {
+                      "message": {
+                        "role": "user",
+                        "parts": [
+                          {
+                            "kind": "text",
+                            "text": "Stream this response"
+                          }
+                        ],
+                        "messageId": "msg-2",
+                        "contextId": "f5bd2a40-74b6-4f7a-b649-ea3f09890003"
+                      }
+                    }
+                  }
+                },
+                "tasks_get": {
+                  "summary": "Get a task",
+                  "value": {
+                    "jsonrpc": "2.0",
+                    "id": "3",
+                    "method": "tasks/get",
+                    "params": {
+                      "id": "run-uuid",
+                      "contextId": "f5bd2a40-74b6-4f7a-b649-ea3f09890003",
+                      "historyLength": 10
+                    }
+                  }
+                },
+                "tasks_cancel": {
+                  "summary": "Cancel a task (currently unsupported)",
+                  "value": {
+                    "jsonrpc": "2.0",
+                    "id": "4",
+                    "method": "tasks/cancel",
+                    "params": {
+                      "id": "run-uuid",
+                      "contextId": "f5bd2a40-74b6-4f7a-b649-ea3f09890003"
+                    }
+                  }
+                }
               }
             }
           }
         },
         "responses": {
           "200": {
-            "description": "JSON-RPC response",
+            "description": "JSON-RPC response for non-streaming methods. For `message/stream`, the response is an SSE stream of JSON-RPC envelopes.",
             "content": {
               "application/json": {
                 "schema": {
@@ -3356,12 +3412,64 @@
                     }
                   },
                   "required": ["jsonrpc", "id"]
+                },
+                "examples": {
+                  "task_result": {
+                    "summary": "Task result (message/send)",
+                    "value": {
+                      "jsonrpc": "2.0",
+                      "id": "1",
+                      "result": {
+                        "kind": "task",
+                        "id": "run-uuid",
+                        "contextId": "f5bd2a40-74b6-4f7a-b649-ea3f09890003",
+                        "status": {
+                          "state": "completed"
+                        },
+                        "artifacts": [
+                          {
+                            "artifactId": "artifact-uuid",
+                            "name": "Assistant Response",
+                            "parts": [
+                              {
+                                "kind": "text",
+                                "text": "Hello back"
+                              }
+                            ]
+                          }
+                        ]
+                      }
+                    }
+                  },
+                  "error_result": {
+                    "summary": "Error response",
+                    "value": {
+                      "jsonrpc": "2.0",
+                      "id": "1",
+                      "error": {
+                        "code": -32602,
+                        "message": "Invalid request: Missing required parameter: contextId"
+                      }
+                    }
+                  }
+                }
+              },
+              "text/event-stream": {
+                "schema": {
+                  "type": "string",
+                  "description": "SSE stream of JSON-RPC response objects."
+                },
+                "examples": {
+                  "stream_event": {
+                    "summary": "SSE data chunk (JSON-RPC)",
+                    "value": "data: {\"jsonrpc\":\"2.0\",\"id\":\"2\",\"result\":{\"kind\":\"status-update\",\"taskId\":\"run-uuid\",\"contextId\":\"f5bd2a40-74b6-4f7a-b649-ea3f09890003\",\"status\":{\"state\":\"working\"},\"final\":false}}\n\n"
+                  }
                 }
               }
             }
           },
           "400": {
-            "description": "Bad request - invalid JSON-RPC or missing Accept header"
+            "description": "Bad Request (invalid JSON-RPC, invalid params, or missing Accept header)."
           },
           "404": {
             "description": "Assistant not found"
@@ -3370,9 +3478,7 @@
             "description": "Internal server error"
           }
         },
-        "tags": [
-          "A2A"
-        ]
+        "tags": ["A2A"]
       }
     },
     "/mcp/": {
@@ -3387,9 +3493,7 @@
             "required": true,
             "schema": {
               "type": "string",
-              "enum": [
-                "application/json, text/event-stream"
-              ]
+              "enum": ["application/json, text/event-stream"]
             },
             "description": "Accept header must include both 'application/json' and 'text/event-stream' media types."
           }
@@ -3399,9 +3503,9 @@
           "content": {
             "application/json": {
               "schema": {
-                "type": "object"
+                "type": "object",
+                "description": "A JSON-RPC 2.0 request, notification, or response object."
               },
-              "description": "A JSON-RPC 2.0 request, notification, or response object.",
               "example": {
                 "jsonrpc": "2.0",
                 "id": "1",
@@ -3442,9 +3546,7 @@
             "description": "Internal server error or unexpected failure."
           }
         },
-        "tags": [
-          "MCP"
-        ]
+        "tags": ["MCP"]
       },
       "get": {
         "operationId": "get_mcp",
@@ -3455,27 +3557,23 @@
             "description": "GET method not allowed; streaming not supported."
           }
         },
-        "tags": [
-          "MCP"
-        ]
+        "tags": ["MCP"]
       },
       "delete": {
         "operationId": "delete_mcp",
         "summary": "Terminate Session",
         "description": "Implemented according to the Streamable HTTP Transport specification.\nTerminate an MCP session. The server implementation is stateless, so this is a no-op.\n\n",
         "responses": {
-          "404": {}
+          "404": {
+            "description": "Session not found"
+          }
         },
-        "tags": [
-          "MCP"
-        ]
+        "tags": ["MCP"]
       }
     },
     "/info": {
       "get": {
-        "tags": [
-          "System"
-        ],
+        "tags": ["System"],
         "summary": "Server Information",
         "description": "Get server version information, feature flags, and metadata.",
         "operationId": "server_info_info_get",
@@ -3508,7 +3606,12 @@
                       "description": "Server deployment metadata"
                     }
                   },
-                  "required": ["version", "langgraph_py_version", "flags", "metadata"],
+                  "required": [
+                    "version",
+                    "langgraph_py_version",
+                    "flags",
+                    "metadata"
+                  ],
                   "title": "ServerInfo"
                 }
               }
@@ -3519,9 +3622,7 @@
     },
     "/metrics": {
       "get": {
-        "tags": [
-          "System"
-        ],
+        "tags": ["System"],
         "summary": "System Metrics",
         "description": "Get system metrics in Prometheus or JSON format for monitoring and observability.",
         "operationId": "system_metrics_metrics_get",
@@ -3564,9 +3665,7 @@
     },
     "/ok": {
       "get": {
-        "tags": [
-          "System"
-        ],
+        "tags": ["System"],
         "summary": "Health Check",
         "description": "Check the health status of the server. Optionally check database connectivity.",
         "operationId": "health_check_ok_get",
@@ -3689,10 +3788,7 @@
             "description": "The name of the assistant"
           },
           "description": {
-            "type": [
-              "string",
-              "null"
-            ],
+            "type": ["string", "null"],
             "title": "Assistant Description",
             "description": "The description of the assistant"
           }
@@ -3738,10 +3834,7 @@
           },
           "if_exists": {
             "type": "string",
-            "enum": [
-              "raise",
-              "do_nothing"
-            ],
+            "enum": ["raise", "do_nothing"],
             "title": "If Exists",
             "description": "How to handle duplicate creation. Must be either 'raise' (raise error if duplicate), or 'do_nothing' (return existing assistant).",
             "default": "raise"
@@ -3752,18 +3845,13 @@
             "description": "The name of the assistant. Defaults to 'Untitled'."
           },
           "description": {
-            "type": [
-              "string",
-              "null"
-            ],
+            "type": ["string", "null"],
             "title": "Description",
             "description": "The description of the assistant. Defaults to null."
           }
         },
         "type": "object",
-        "required": [
-          "graph_id"
-        ],
+        "required": ["graph_id"],
         "title": "AssistantCreate",
         "description": "Payload for creating an assistant."
       },
@@ -4001,9 +4089,7 @@
             "anyOf": [
               {
                 "type": "string",
-                "enum": [
-                  "*"
-                ]
+                "enum": ["*"]
               },
               {
                 "items": {
@@ -4019,9 +4105,7 @@
             "anyOf": [
               {
                 "type": "string",
-                "enum": [
-                  "*"
-                ]
+                "enum": ["*"]
               },
               {
                 "items": {
@@ -4033,26 +4117,19 @@
             "title": "Interrupt After",
             "description": "Nodes to interrupt immediately after they get executed."
           },
-          "multitask_strategy": {
+          "on_run_completed": {
             "type": "string",
-            "enum": [
-              "reject",
-              "rollback",
-              "interrupt",
-              "enqueue"
-            ],
-            "title": "Multitask Strategy",
-            "description": "Multitask strategy to use. Must be one of 'reject', 'interrupt', 'rollback', or 'enqueue'.",
-            "default": "enqueue"
+            "enum": ["delete", "keep"],
+            "default": "delete",
+            "title": "On Run Completed",
+            "description": "What to do with the thread after the run completes. 'delete' removes the thread after execution. 'keep' creates a new thread for each execution but does not clean them up."
           }
         },
         "type": "object",
-        "required": [
-          "assistant_id",
-          "schedule"
-        ],
+        "required": ["assistant_id", "schedule"],
+        "additionalProperties": true,
         "title": "CronCreate",
-        "description": "Payload for creating a cron job."
+        "description": "Payload for creating a stateless cron job (creates a new thread for each execution)."
       },
       "CronSearch": {
         "properties": {
@@ -4088,7 +4165,15 @@
             "title": "Sort By",
             "description": "The field to sort by.",
             "default": "created_at",
-            "enum": ["cron_id", "assistant_id", "thread_id", "next_run_date", "end_time", "created_at", "updated_at"]
+            "enum": [
+              "cron_id",
+              "assistant_id",
+              "thread_id",
+              "next_run_date",
+              "end_time",
+              "created_at",
+              "updated_at"
+            ]
           },
           "sort_order": {
             "type": "string",
@@ -4105,6 +4190,7 @@
                 "cron_id",
                 "assistant_id",
                 "thread_id",
+                "on_run_completed",
                 "end_time",
                 "schedule",
                 "created_at",
@@ -4112,8 +4198,7 @@
                 "user_id",
                 "payload",
                 "next_run_date",
-                "metadata",
-                "now"
+                "metadata"
               ]
             },
             "title": "Select",
@@ -4178,10 +4263,7 @@
           }
         },
         "type": "object",
-        "required": [
-          "graph_id",
-          "state_schema"
-        ],
+        "required": ["graph_id", "state_schema"],
         "title": "GraphSchema",
         "description": "Defines the structure and properties of a graph."
       },
@@ -4214,11 +4296,7 @@
           }
         },
         "type": "object",
-        "required": [
-          "input_schema",
-          "output_schema",
-          "state_schema"
-        ],
+        "required": ["input_schema", "output_schema", "state_schema"],
         "title": "GraphSchemaNoId",
         "description": "Defines the structure and properties of a graph without an ID."
       },
@@ -4286,12 +4364,7 @@
           },
           "multitask_strategy": {
             "type": "string",
-            "enum": [
-              "reject",
-              "rollback",
-              "interrupt",
-              "enqueue"
-            ],
+            "enum": ["reject", "rollback", "interrupt", "enqueue"],
             "title": "Multitask Strategy",
             "description": "Strategy to handle concurrent runs on the same thread."
           }
@@ -4321,22 +4394,12 @@
             "description": "The node to send the message to."
           },
           "input": {
-            "type": [
-              "object",
-              "array",
-              "number",
-              "string",
-              "boolean",
-              "null"
-            ],
+            "type": ["object", "array", "number", "string", "boolean", "null"],
             "title": "Message",
             "description": "The message to send."
           }
         },
-        "required": [
-          "node",
-          "input"
-        ]
+        "required": ["node", "input"]
       },
       "Command": {
         "type": "object",
@@ -4344,23 +4407,12 @@
         "description": "The command to run.",
         "properties": {
           "update": {
-            "type": [
-              "object",
-              "array",
-              "null"
-            ],
+            "type": ["object", "array", "null"],
             "title": "Update",
             "description": "An update to the state."
           },
           "resume": {
-            "type": [
-              "object",
-              "array",
-              "number",
-              "string",
-              "boolean",
-              "null"
-            ],
+            "type": ["object", "array", "number", "string", "boolean", "null"],
             "title": "Resume",
             "description": "A value to pass to an interrupted node."
           },
@@ -4495,9 +4547,7 @@
             "anyOf": [
               {
                 "type": "string",
-                "enum": [
-                  "*"
-                ]
+                "enum": ["*"]
               },
               {
                 "items": {
@@ -4513,9 +4563,7 @@
             "anyOf": [
               {
                 "type": "string",
-                "enum": [
-                  "*"
-                ]
+                "enum": ["*"]
               },
               {
                 "items": {
@@ -4563,9 +4611,7 @@
             ],
             "title": "Stream Mode",
             "description": "The stream mode(s) to use.",
-            "default": [
-              "values"
-            ]
+            "default": ["values"]
           },
           "stream_subgraphs": {
             "type": "boolean",
@@ -4581,13 +4627,10 @@
           },
           "on_disconnect": {
             "type": "string",
-            "enum": [
-              "cancel",
-              "continue"
-            ],
+            "enum": ["cancel", "continue"],
             "title": "On Disconnect",
             "description": "The disconnect mode to use. Must be one of 'cancel' or 'continue'.",
-            "default": "cancel"
+            "default": "continue"
           },
           "feedback_keys": {
             "items": {
@@ -4599,22 +4642,14 @@
           },
           "multitask_strategy": {
             "type": "string",
-            "enum": [
-              "reject",
-              "rollback",
-              "interrupt",
-              "enqueue"
-            ],
+            "enum": ["reject", "rollback", "interrupt", "enqueue"],
             "title": "Multitask Strategy",
             "description": "Multitask strategy to use. Must be one of 'reject', 'interrupt', 'rollback', or 'enqueue'.",
             "default": "enqueue"
           },
           "if_not_exists": {
             "type": "string",
-            "enum": [
-              "create",
-              "reject"
-            ],
+            "enum": ["create", "reject"],
             "title": "If Not Exists",
             "description": "How to handle missing thread. Must be either 'reject' (raise error if missing), or 'create' (create new thread).",
             "default": "reject"
@@ -4632,20 +4667,14 @@
           },
           "durability": {
             "type": "string",
-            "enum": [
-              "sync",
-              "async",
-              "exit"
-            ],
+            "enum": ["sync", "async", "exit"],
             "title": "Durability",
             "description": "Durability level for the run. Must be one of 'sync', 'async', or 'exit'.",
             "default": "async"
           }
         },
         "type": "object",
-        "required": [
-          "assistant_id"
-        ],
+        "required": ["assistant_id"],
         "title": "RunCreateStateful",
         "description": "Payload for creating a run."
       },
@@ -4750,58 +4779,22 @@
             "title": "Webhook",
             "description": "Webhook to call after LangGraph API call is done."
           },
-          "interrupt_before": {
+          "stream_mode": {
             "anyOf": [
-              {
-                "type": "string",
-                "enum": [
-                  "*"
-                ]
-              },
               {
                 "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              }
-            ],
-            "title": "Interrupt Before",
-            "description": "Nodes to interrupt immediately before they get executed."
-          },
-          "interrupt_after": {
-            "anyOf": [
-              {
-                "type": "string",
-                "enum": [
-                  "*"
-                ]
-              },
-              {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              }
-            ],
-            "title": "Interrupt After",
-            "description": "Nodes to interrupt immediately after they get executed."
-          },
-          "stream_mode": {
-            "anyOf": [
-              {
-                "items": {
-                  "type": "string",
-                  "enum": [
-                    "values",
-                    "messages",
-                    "messages-tuple",
-                    "tasks",
-                    "checkpoints",
-                    "updates",
-                    "events",
-                    "debug",
-                    "custom"
-                  ]
+                  "type": "string",
+                  "enum": [
+                    "values",
+                    "messages",
+                    "messages-tuple",
+                    "tasks",
+                    "checkpoints",
+                    "updates",
+                    "events",
+                    "debug",
+                    "custom"
+                  ]
                 },
                 "type": "array"
               },
@@ -4822,9 +4815,7 @@
             ],
             "title": "Stream Mode",
             "description": "The stream mode(s) to use.",
-            "default": [
-              "values"
-            ]
+            "default": ["values"]
           },
           "feedback_keys": {
             "items": {
@@ -4848,23 +4839,17 @@
           },
           "on_completion": {
             "type": "string",
-            "enum": [
-              "delete",
-              "keep"
-            ],
+            "enum": ["delete", "keep"],
             "title": "On Completion",
             "description": "Whether to delete or keep the thread created for a stateless run. Must be one of 'delete' or 'keep'.",
             "default": "delete"
           },
           "on_disconnect": {
             "type": "string",
-            "enum": [
-              "cancel",
-              "continue"
-            ],
+            "enum": ["cancel", "continue"],
             "title": "On Disconnect",
             "description": "The disconnect mode to use. Must be one of 'cancel' or 'continue'.",
-            "default": "cancel"
+            "default": "continue"
           },
           "after_seconds": {
             "type": "number",
@@ -4879,20 +4864,14 @@
           },
           "durability": {
             "type": "string",
-            "enum": [
-              "sync",
-              "async",
-              "exit"
-            ],
+            "enum": ["sync", "async", "exit"],
             "title": "Durability",
             "description": "Durability level for the run. Must be one of 'sync', 'async', or 'exit'.",
             "default": "async"
           }
         },
         "type": "object",
-        "required": [
-          "assistant_id"
-        ],
+        "required": ["assistant_id"],
         "title": "RunCreateStateless",
         "description": "Payload for creating a run."
       },
@@ -4908,6 +4887,11 @@
             "title": "Graph Id",
             "description": "The ID of the graph to filter by. The graph ID is normally set in your langgraph.json configuration."
           },
+          "name": {
+            "type": "string",
+            "title": "Name",
+            "description": "Name of the assistant to filter by. The filtering logic will match (case insensitive) assistants where 'name' is a substring of the assistant name."
+          },
           "limit": {
             "type": "integer",
             "title": "Limit",
@@ -4937,10 +4921,7 @@
           },
           "sort_order": {
             "type": "string",
-            "enum": [
-              "asc",
-              "desc"
-            ],
+            "enum": ["asc", "desc"],
             "title": "Sort Order",
             "description": "The order to sort by."
           },
@@ -4950,7 +4931,7 @@
               "type": "string",
               "enum": [
                 "assistant_id",
-                "graph_id", 
+                "graph_id",
                 "name",
                 "description",
                 "config",
@@ -4980,6 +4961,11 @@
             "type": "string",
             "title": "Graph Id",
             "description": "The ID of the graph to filter by. The graph ID is normally set in your langgraph.json configuration."
+          },
+          "name": {
+            "type": "string",
+            "title": "Name",
+            "description": "Name of the assistant to filter by. The filtering logic will match (case insensitive) assistants where 'name' is a substring of the assistant name."
           }
         },
         "type": "object",
@@ -5017,7 +5003,10 @@
         "properties": {
           "ids": {
             "type": "array",
-            "items": {"type": "string", "format": "uuid"},
+            "items": {
+              "type": "string",
+              "format": "uuid"
+            },
             "title": "Ids",
             "description": "List of thread IDs to include. Others are excluded."
           },
@@ -5033,12 +5022,7 @@
           },
           "status": {
             "type": "string",
-            "enum": [
-              "idle",
-              "busy",
-              "interrupted",
-              "error"
-            ],
+            "enum": ["idle", "busy", "interrupted", "error"],
             "title": "Status",
             "description": "Thread status to filter on."
           },
@@ -5059,21 +5043,13 @@
           },
           "sort_by": {
             "type": "string",
-            "enum": [
-              "thread_id",
-              "status",
-              "created_at",
-              "updated_at"
-            ],
+            "enum": ["thread_id", "status", "created_at", "updated_at"],
             "title": "Sort By",
             "description": "Sort by field."
           },
           "sort_order": {
             "type": "string",
-            "enum": [
-              "asc",
-              "desc"
-            ],
+            "enum": ["asc", "desc"],
             "title": "Sort Order",
             "description": "Sort order."
           },
@@ -5087,7 +5063,6 @@
                 "updated_at",
                 "metadata",
                 "config",
-                "context",
                 "status",
                 "values",
                 "interrupts"
@@ -5115,12 +5090,7 @@
           },
           "status": {
             "type": "string",
-            "enum": [
-              "idle",
-              "busy",
-              "interrupted",
-              "error"
-            ],
+            "enum": ["idle", "busy", "interrupted", "error"],
             "title": "Status",
             "description": "Thread status to filter on."
           }
@@ -5161,12 +5131,7 @@
           },
           "status": {
             "type": "string",
-            "enum": [
-              "idle",
-              "busy",
-              "interrupted",
-              "error"
-            ],
+            "enum": ["idle", "busy", "interrupted", "error"],
             "title": "Status",
             "description": "The status of the thread."
           },
@@ -5179,6 +5144,27 @@
             "type": "object",
             "title": "Interrupts",
             "description": "The current interrupts of the thread."
+          },
+          "ttl": {
+            "type": "object",
+            "title": "TTL Info",
+            "description": "TTL information if set for this thread. Only present when ?include=ttl is passed.",
+            "properties": {
+              "strategy": {
+                "type": "string",
+                "enum": ["delete", "keep_latest"],
+                "description": "The TTL strategy."
+              },
+              "ttl_minutes": {
+                "type": "number",
+                "description": "The TTL in minutes."
+              },
+              "expires_at": {
+                "type": "string",
+                "format": "date-time",
+                "description": "When the thread will expire."
+              }
+            }
           }
         },
         "type": "object",
@@ -5206,10 +5192,7 @@
           },
           "if_exists": {
             "type": "string",
-            "enum": [
-              "raise",
-              "do_nothing"
-            ],
+            "enum": ["raise", "do_nothing"],
             "title": "If Exists",
             "description": "How to handle duplicate creation. Must be either 'raise' (raise error if duplicate), or 'do_nothing' (return existing thread).",
             "default": "raise"
@@ -5221,10 +5204,8 @@
             "properties": {
               "strategy": {
                 "type": "string",
-                "enum": [
-                  "delete"
-                ],
-                "description": "The TTL strategy. 'delete' removes the entire thread.",
+                "enum": ["delete", "keep_latest"],
+                "description": "The TTL strategy. 'delete' removes the entire thread. 'keep_latest' prunes old checkpoints but keeps the thread and its latest state (requires FF_USE_CORE_API=true).",
                 "default": "delete"
               },
               "ttl": {
@@ -5245,9 +5226,7 @@
                   }
                 }
               },
-              "required": [
-                "updates"
-              ]
+              "required": ["updates"]
             }
           }
         },
@@ -5269,10 +5248,8 @@
             "properties": {
               "strategy": {
                 "type": "string",
-                "enum": [
-                  "delete"
-                ],
-                "description": "The TTL strategy. 'delete' removes the entire thread.",
+                "enum": ["delete", "keep_latest"],
+                "description": "The TTL strategy. 'delete' removes the entire thread. 'keep_latest' prunes old checkpoints but keeps the thread and its latest state (requires FF_USE_CORE_API=true).",
                 "default": "delete"
               },
               "ttl": {
@@ -5286,6 +5263,43 @@
         "title": "ThreadPatch",
         "description": "Payload for updating a thread."
       },
+      "ThreadPruneRequest": {
+        "properties": {
+          "thread_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid"
+            },
+            "title": "Thread IDs",
+            "description": "List of thread IDs to prune."
+          },
+          "strategy": {
+            "type": "string",
+            "enum": ["delete", "keep_latest"],
+            "title": "Strategy",
+            "description": "The prune strategy. 'delete' removes threads entirely. 'keep_latest' prunes old checkpoints but keeps threads and their latest state (requires FF_USE_CORE_API=true).",
+            "default": "delete"
+          }
+        },
+        "required": ["thread_ids"],
+        "type": "object",
+        "title": "ThreadPruneRequest",
+        "description": "Payload for pruning threads."
+      },
+      "ThreadPruneResponse": {
+        "properties": {
+          "pruned_count": {
+            "type": "integer",
+            "title": "Pruned Count",
+            "description": "Number of threads successfully pruned."
+          }
+        },
+        "required": ["pruned_count"],
+        "type": "object",
+        "title": "ThreadPruneResponse",
+        "description": "Response from pruning threads."
+      },
       "ThreadStateCheckpointRequest": {
         "properties": {
           "checkpoint": {
@@ -5299,9 +5313,7 @@
             "description": "Include subgraph states."
           }
         },
-        "required": [
-          "checkpoint"
-        ],
+        "required": ["checkpoint"],
         "type": "object",
         "title": "ThreadStateCheckpointRequest",
         "description": "Payload for getting the state of a thread at a checkpoint."
@@ -5359,10 +5371,7 @@
                   "$ref": "#/components/schemas/ThreadState"
                 }
               },
-              "required": [
-                "id",
-                "name"
-              ]
+              "required": ["id", "name"]
             },
             "type": "array",
             "title": "Tasks"
@@ -5391,13 +5400,7 @@
           }
         },
         "type": "object",
-        "required": [
-          "values",
-          "next",
-          "checkpoint",
-          "metadata",
-          "created_at"
-        ],
+        "required": ["values", "next", "checkpoint", "metadata", "created_at"],
         "title": "ThreadState"
       },
       "ThreadStateSearch": {
@@ -5496,9 +5499,7 @@
             "description": "Update the state as if this node had just executed."
           }
         },
-        "required": [
-          "as_node"
-        ],
+        "required": ["as_node"],
         "type": "object"
       },
       "ThreadStateUpdateResponse": {
@@ -5537,11 +5538,7 @@
       },
       "StorePutRequest": {
         "type": "object",
-        "required": [
-          "namespace",
-          "key",
-          "value"
-        ],
+        "required": ["namespace", "key", "value"],
         "properties": {
           "namespace": {
             "type": "array",
@@ -5567,9 +5564,7 @@
       },
       "StoreDeleteRequest": {
         "type": "object",
-        "required": [
-          "key"
-        ],
+        "required": ["key"],
         "properties": {
           "namespace": {
             "type": "array",
@@ -5592,10 +5587,7 @@
         "type": "object",
         "properties": {
           "namespace_prefix": {
-            "type": [
-              "array",
-              "null"
-            ],
+            "type": ["array", "null"],
             "items": {
               "type": "string"
             },
@@ -5603,10 +5595,7 @@
             "description": "List of strings representing the namespace prefix."
           },
           "filter": {
-            "type": [
-              "object",
-              "null"
-            ],
+            "type": ["object", "null"],
             "additionalProperties": true,
             "title": "Filter",
             "description": "Optional dictionary of key-value pairs to filter results."
@@ -5624,10 +5613,7 @@
             "description": "Number of items to skip before returning results (default is 0)."
           },
           "query": {
-            "type": [
-              "string",
-              "null"
-            ],
+            "type": ["string", "null"],
             "title": "Query",
             "description": "Query string for semantic/vector search."
           }
@@ -5675,13 +5661,7 @@
       },
       "Item": {
         "type": "object",
-        "required": [
-          "namespace",
-          "key",
-          "value",
-          "created_at",
-          "updated_at"
-        ],
+        "required": ["namespace", "key", "value", "created_at", "updated_at"],
         "properties": {
           "namespace": {
             "type": "array",
@@ -5718,11 +5698,7 @@
         "properties": {
           "status": {
             "type": "string",
-            "enum": [
-              "pending",
-              "running",
-              "all"
-            ],
+            "enum": ["pending", "running", "all"],
             "title": "Status",
             "description": "Filter runs by status to cancel. Must be one of 'pending', 'running', or 'all'."
           },
@@ -5744,23 +5720,16 @@
         },
         "oneOf": [
           {
-            "required": [
-              "status"
-            ]
+            "required": ["status"]
           },
           {
-            "required": [
-              "thread_id",
-              "run_ids"
-            ]
+            "required": ["thread_id", "run_ids"]
           }
         ]
       },
       "SearchItemsResponse": {
         "type": "object",
-        "required": [
-          "items"
-        ],
+        "required": ["items"],
         "properties": {
           "items": {
             "type": "array",
@@ -5780,9 +5749,156 @@
         }
       },
       "ErrorResponse": {
-        "type": "string",
+        "type": "object",
+        "required": ["detail"],
+        "properties": {
+          "detail": {
+            "type": "string",
+            "description": "Human-readable error message"
+          }
+        },
         "title": "ErrorResponse",
-        "description": "Error message returned from the server"
+        "description": "Error response returned from the server"
+      },
+      "ThreadCronCreate": {
+        "properties": {
+          "schedule": {
+            "type": "string",
+            "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": [
+              {
+                "type": "string",
+                "format": "uuid",
+                "title": "Assistant Id"
+              },
+              {
+                "type": "string",
+                "title": "Graph Id"
+              }
+            ],
+            "description": "The assistant ID or graph name to run. If using graph name, will default to the assistant automatically created from that graph by the server."
+          },
+          "input": {
+            "anyOf": [
+              {
+                "items": {
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              {
+                "type": "object"
+              }
+            ],
+            "title": "Input",
+            "description": "The input to the graph."
+          },
+          "metadata": {
+            "type": "object",
+            "title": "Metadata",
+            "description": "Metadata to assign to the cron job runs."
+          },
+          "config": {
+            "properties": {
+              "tags": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array",
+                "title": "Tags"
+              },
+              "recursion_limit": {
+                "type": "integer",
+                "title": "Recursion Limit"
+              },
+              "configurable": {
+                "type": "object",
+                "title": "Configurable"
+              }
+            },
+            "type": "object",
+            "title": "Config",
+            "description": "The configuration for the assistant."
+          },
+          "context": {
+            "type": "object",
+            "title": "Context",
+            "description": "Static context added to the assistant."
+          },
+          "webhook": {
+            "type": "string",
+            "maxLength": 65536,
+            "minLength": 1,
+            "format": "uri-reference",
+            "title": "Webhook",
+            "description": "Webhook to call after LangGraph API call is done."
+          },
+          "interrupt_before": {
+            "anyOf": [
+              {
+                "type": "string",
+                "enum": ["*"]
+              },
+              {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              }
+            ],
+            "title": "Interrupt Before",
+            "description": "Nodes to interrupt immediately before they get executed."
+          },
+          "interrupt_after": {
+            "anyOf": [
+              {
+                "type": "string",
+                "enum": ["*"]
+              },
+              {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              }
+            ],
+            "title": "Interrupt After",
+            "description": "Nodes to interrupt immediately after they get executed."
+          },
+          "multitask_strategy": {
+            "type": "string",
+            "enum": ["reject", "rollback", "interrupt", "enqueue"],
+            "title": "Multitask Strategy",
+            "description": "Multitask strategy to use. Must be one of 'reject', 'interrupt', 'rollback', or 'enqueue'.",
+            "default": "enqueue"
+          }
+        },
+        "type": "object",
+        "required": ["assistant_id", "schedule"],
+        "title": "ThreadCronCreate",
+        "description": "Payload for creating a thread-specific cron job (runs on the same thread)."
+      },
+      "Interrupt": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": ["string", "null"]
+          },
+          "value": {
+            "type": "object"
+          }
+        },
+        "title": "Interrupt",
+        "required": ["value"]
       }
     },
     "responses": {
@@ -5833,24 +5949,6 @@
             }
           }
         }
-      },
-      "Interrupt": {
-        "type": "object",
-        "properties": {
-          "id": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "value": {
-            "type": "object"
-          }
-        },
-        "title": "Interrupt",
-        "required": [
-          "value"
-        ]
       }
     }
   }