langgraph-api 0.2.17__py3-none-any.whl → 0.2.19__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of langgraph-api might be problematic. Click here for more details.

openapi.json CHANGED
@@ -33,9 +33,7 @@
33
33
  "paths": {
34
34
  "/assistants": {
35
35
  "post": {
36
- "tags": [
37
- "Assistants"
38
- ],
36
+ "tags": ["Assistants"],
39
37
  "summary": "Create Assistant",
40
38
  "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.",
41
39
  "operationId": "create_assistant_assistants_post",
@@ -95,9 +93,7 @@
95
93
  },
96
94
  "/assistants/search": {
97
95
  "post": {
98
- "tags": [
99
- "Assistants"
100
- ],
96
+ "tags": ["Assistants"],
101
97
  "summary": "Search Assistants",
102
98
  "description": "Search for assistants.\n\nThis endpoint also functions as the endpoint to list all assistants.",
103
99
  "operationId": "search_assistants_assistants_search_post",
@@ -151,9 +147,7 @@
151
147
  },
152
148
  "/assistants/{assistant_id}": {
153
149
  "get": {
154
- "tags": [
155
- "Assistants"
156
- ],
150
+ "tags": ["Assistants"],
157
151
  "summary": "Get Assistant",
158
152
  "description": "Get an assistant by ID.",
159
153
  "operationId": "get_assistant_assistants__assistant_id__get",
@@ -195,9 +189,7 @@
195
189
  }
196
190
  },
197
191
  "delete": {
198
- "tags": [
199
- "Assistants"
200
- ],
192
+ "tags": ["Assistants"],
201
193
  "summary": "Delete Assistant",
202
194
  "description": "Delete an assistant by ID.\n\nAll versions of the assistant will be deleted as well.",
203
195
  "operationId": "delete_assistant_assistants__assistant_id__delete",
@@ -247,9 +239,7 @@
247
239
  }
248
240
  },
249
241
  "patch": {
250
- "tags": [
251
- "Assistants"
252
- ],
242
+ "tags": ["Assistants"],
253
243
  "summary": "Patch Assistant",
254
244
  "description": "Update an assistant.",
255
245
  "operationId": "patch_assistant_assistants__assistant_id__patch",
@@ -313,9 +303,7 @@
313
303
  },
314
304
  "/assistants/{assistant_id}/graph": {
315
305
  "get": {
316
- "tags": [
317
- "Assistants"
318
- ],
306
+ "tags": ["Assistants"],
319
307
  "summary": "Get Assistant Graph",
320
308
  "description": "Get an assistant by ID.",
321
309
  "operationId": "get_assistant_graph_assistants__assistant_id__graph_get",
@@ -404,9 +392,7 @@
404
392
  },
405
393
  "/assistants/{assistant_id}/subgraphs": {
406
394
  "get": {
407
- "tags": [
408
- "Assistants"
409
- ],
395
+ "tags": ["Assistants"],
410
396
  "summary": "Get Assistant Subgraphs",
411
397
  "description": "Get an assistant's subgraphs.",
412
398
  "operationId": "get_assistant_subgraphs_assistants__assistant_id__subgraphs_get",
@@ -470,9 +456,7 @@
470
456
  },
471
457
  "/assistants/{assistant_id}/subgraphs/{namespace}": {
472
458
  "get": {
473
- "tags": [
474
- "Assistants"
475
- ],
459
+ "tags": ["Assistants"],
476
460
  "summary": "Get Assistant Subgraphs by Namespace",
477
461
  "description": "Get an assistant's subgraphs filtered by namespace.",
478
462
  "operationId": "get_assistant_subgraphs_assistants__assistant_id__subgraphs__namespace__get",
@@ -536,9 +520,7 @@
536
520
  },
537
521
  "/assistants/{assistant_id}/schemas": {
538
522
  "get": {
539
- "tags": [
540
- "Assistants"
541
- ],
523
+ "tags": ["Assistants"],
542
524
  "summary": "Get Assistant Schemas",
543
525
  "description": "Get an assistant by ID.",
544
526
  "operationId": "get_assistant_schemas_assistants__assistant_id__schemas_get",
@@ -592,9 +574,7 @@
592
574
  },
593
575
  "/assistants/{assistant_id}/versions": {
594
576
  "post": {
595
- "tags": [
596
- "Assistants"
597
- ],
577
+ "tags": ["Assistants"],
598
578
  "summary": "Get Assistant Versions",
599
579
  "description": "Get all versions of an assistant.",
600
580
  "operationId": "get_assistant_versions_assistants__assistant_id__versions_get",
@@ -642,9 +622,7 @@
642
622
  },
643
623
  "/assistants/{assistant_id}/latest": {
644
624
  "post": {
645
- "tags": [
646
- "Assistants"
647
- ],
625
+ "tags": ["Assistants"],
648
626
  "summary": "Set Latest Assistant Version",
649
627
  "description": "Set the latest version for an assistant.",
650
628
  "operationId": "set_latest_assistant_version_assistants__assistant_id__versions_post",
@@ -709,9 +687,7 @@
709
687
  },
710
688
  "/threads": {
711
689
  "post": {
712
- "tags": [
713
- "Threads"
714
- ],
690
+ "tags": ["Threads"],
715
691
  "summary": "Create Thread",
716
692
  "description": "Create a thread.",
717
693
  "operationId": "create_thread_threads_post",
@@ -761,9 +737,7 @@
761
737
  },
762
738
  "/threads/search": {
763
739
  "post": {
764
- "tags": [
765
- "Threads"
766
- ],
740
+ "tags": ["Threads"],
767
741
  "summary": "Search Threads",
768
742
  "description": "Search for threads.\n\nThis endpoint also functions as the endpoint to list all threads.",
769
743
  "operationId": "search_threads_threads_search_post",
@@ -807,9 +781,7 @@
807
781
  },
808
782
  "/threads/state/bulk": {
809
783
  "post": {
810
- "tags": [
811
- "Threads"
812
- ],
784
+ "tags": ["Threads"],
813
785
  "summary": "Bulk Update Thread State",
814
786
  "description": "Create a new thread from a batch of state updates.",
815
787
  "operationId": "bulk_update_thread_state_post",
@@ -859,9 +831,7 @@
859
831
  },
860
832
  "/threads/{thread_id}/state": {
861
833
  "get": {
862
- "tags": [
863
- "Threads"
864
- ],
834
+ "tags": ["Threads"],
865
835
  "summary": "Get Thread State",
866
836
  "description": "Get state for a thread.\n\nThe latest state of the thread (i.e. latest checkpoint) is returned.",
867
837
  "operationId": "get_latest_thread_state_threads__thread_id__state_get",
@@ -903,9 +873,7 @@
903
873
  }
904
874
  },
905
875
  "post": {
906
- "tags": [
907
- "Threads"
908
- ],
876
+ "tags": ["Threads"],
909
877
  "summary": "Update Thread State",
910
878
  "description": "Add state to a thread.",
911
879
  "operationId": "update_thread_state_threads__thread_id__state_post",
@@ -959,9 +927,7 @@
959
927
  },
960
928
  "/threads/{thread_id}/state/checkpoint": {
961
929
  "post": {
962
- "tags": [
963
- "Threads"
964
- ],
930
+ "tags": ["Threads"],
965
931
  "summary": "Get Thread State At Checkpoint",
966
932
  "description": "Get state for a thread at a specific checkpoint.",
967
933
  "operationId": "post_thread_state_at_checkpoint_threads__thread_id__state__checkpoint_id__get",
@@ -1001,9 +967,7 @@
1001
967
  },
1002
968
  "/threads/{thread_id}/history": {
1003
969
  "get": {
1004
- "tags": [
1005
- "Threads"
1006
- ],
970
+ "tags": ["Threads"],
1007
971
  "summary": "Get Thread History",
1008
972
  "description": "Get all past states for a thread.",
1009
973
  "operationId": "get_thread_history_threads__thread_id__history_get",
@@ -1068,9 +1032,7 @@
1068
1032
  }
1069
1033
  },
1070
1034
  "post": {
1071
- "tags": [
1072
- "Threads"
1073
- ],
1035
+ "tags": ["Threads"],
1074
1036
  "summary": "Get Thread History Post",
1075
1037
  "description": "Get all past states for a thread.",
1076
1038
  "operationId": "get_thread_history_post_threads__thread_id__history_post",
@@ -1128,9 +1090,7 @@
1128
1090
  },
1129
1091
  "/threads/{thread_id}/copy": {
1130
1092
  "post": {
1131
- "tags": [
1132
- "Threads"
1133
- ],
1093
+ "tags": ["Threads"],
1134
1094
  "summary": "Copy Thread",
1135
1095
  "description": "Create a new thread with a copy of the state and checkpoints from an existing thread.",
1136
1096
  "operationId": "copy_thread_post_threads__thread_id__copy_post",
@@ -1184,9 +1144,7 @@
1184
1144
  },
1185
1145
  "/threads/{thread_id}": {
1186
1146
  "get": {
1187
- "tags": [
1188
- "Threads"
1189
- ],
1147
+ "tags": ["Threads"],
1190
1148
  "summary": "Get Thread",
1191
1149
  "description": "Get a thread by ID.",
1192
1150
  "operationId": "get_thread_threads__thread_id__get",
@@ -1238,9 +1196,7 @@
1238
1196
  }
1239
1197
  },
1240
1198
  "delete": {
1241
- "tags": [
1242
- "Threads"
1243
- ],
1199
+ "tags": ["Threads"],
1244
1200
  "summary": "Delete Thread",
1245
1201
  "description": "Delete a thread by ID.",
1246
1202
  "operationId": "delete_thread_threads__thread_id__delete",
@@ -1290,9 +1246,7 @@
1290
1246
  }
1291
1247
  },
1292
1248
  "patch": {
1293
- "tags": [
1294
- "Threads"
1295
- ],
1249
+ "tags": ["Threads"],
1296
1250
  "summary": "Patch Thread",
1297
1251
  "description": "Update a thread.",
1298
1252
  "operationId": "patch_thread_threads__thread_id__patch",
@@ -1356,9 +1310,7 @@
1356
1310
  },
1357
1311
  "/threads/{thread_id}/runs": {
1358
1312
  "get": {
1359
- "tags": [
1360
- "Thread Runs"
1361
- ],
1313
+ "tags": ["Thread Runs"],
1362
1314
  "summary": "List Runs",
1363
1315
  "description": "List runs for a thread.",
1364
1316
  "operationId": "list_runs_http_threads__thread_id__runs_get",
@@ -1399,13 +1351,7 @@
1399
1351
  "required": false,
1400
1352
  "schema": {
1401
1353
  "type": "string",
1402
- "enum": [
1403
- "pending",
1404
- "error",
1405
- "success",
1406
- "timeout",
1407
- "interrupted"
1408
- ]
1354
+ "enum": ["pending", "error", "success", "timeout", "interrupted"]
1409
1355
  },
1410
1356
  "name": "status",
1411
1357
  "in": "query"
@@ -1448,9 +1394,7 @@
1448
1394
  }
1449
1395
  },
1450
1396
  "post": {
1451
- "tags": [
1452
- "Thread Runs"
1453
- ],
1397
+ "tags": ["Thread Runs"],
1454
1398
  "summary": "Create Background Run",
1455
1399
  "description": "Create a run in existing thread, return the run ID immediately. Don't wait for the final run output.",
1456
1400
  "operationId": "create_run_threads__thread_id__runs_post",
@@ -1524,9 +1468,7 @@
1524
1468
  },
1525
1469
  "/threads/{thread_id}/runs/crons": {
1526
1470
  "post": {
1527
- "tags": [
1528
- "Crons (Plus tier)"
1529
- ],
1471
+ "tags": ["Crons (Plus tier)"],
1530
1472
  "summary": "Create Thread Cron",
1531
1473
  "description": "Create a cron to schedule runs on a thread.",
1532
1474
  "operationId": "create_thread_cron_threads__thread_id__runs_crons_post",
@@ -1590,9 +1532,7 @@
1590
1532
  },
1591
1533
  "/threads/{thread_id}/runs/stream": {
1592
1534
  "post": {
1593
- "tags": [
1594
- "Thread Runs"
1595
- ],
1535
+ "tags": ["Thread Runs"],
1596
1536
  "summary": "Create Run, Stream Output",
1597
1537
  "description": "Create a run in existing thread. Stream the output.",
1598
1538
  "operationId": "stream_run_threads__thread_id__runs_stream_post",
@@ -1667,9 +1607,7 @@
1667
1607
  },
1668
1608
  "/threads/{thread_id}/runs/wait": {
1669
1609
  "post": {
1670
- "tags": [
1671
- "Thread Runs"
1672
- ],
1610
+ "tags": ["Thread Runs"],
1673
1611
  "summary": "Create Run, Wait for Output",
1674
1612
  "description": "Create a run in existing thread. Wait for the final output and then return it.",
1675
1613
  "operationId": "wait_run_threads__thread_id__runs_wait_post",
@@ -1741,9 +1679,7 @@
1741
1679
  },
1742
1680
  "/threads/{thread_id}/runs/{run_id}": {
1743
1681
  "get": {
1744
- "tags": [
1745
- "Thread Runs"
1746
- ],
1682
+ "tags": ["Thread Runs"],
1747
1683
  "summary": "Get Run",
1748
1684
  "description": "Get a run by ID.",
1749
1685
  "operationId": "get_run_http_threads__thread_id__runs__run_id__get",
@@ -1807,9 +1743,7 @@
1807
1743
  }
1808
1744
  },
1809
1745
  "delete": {
1810
- "tags": [
1811
- "Thread Runs"
1812
- ],
1746
+ "tags": ["Thread Runs"],
1813
1747
  "summary": "Delete Run",
1814
1748
  "description": "Delete a run by ID.",
1815
1749
  "operationId": "delete_run_threads__thread_id__runs__run_id__delete",
@@ -1873,9 +1807,7 @@
1873
1807
  },
1874
1808
  "/threads/{thread_id}/runs/{run_id}/join": {
1875
1809
  "get": {
1876
- "tags": [
1877
- "Thread Runs"
1878
- ],
1810
+ "tags": ["Thread Runs"],
1879
1811
  "summary": "Join Run",
1880
1812
  "description": "Wait for a run to finish.",
1881
1813
  "operationId": "join_run_http_threads__thread_id__runs__run_id__join_get",
@@ -1950,9 +1882,7 @@
1950
1882
  },
1951
1883
  "/threads/{thread_id}/runs/{run_id}/stream": {
1952
1884
  "get": {
1953
- "tags": [
1954
- "Thread Runs"
1955
- ],
1885
+ "tags": ["Thread Runs"],
1956
1886
  "summary": "Join Run Stream",
1957
1887
  "description": "Join a run stream. This endpoint streams output in real-time from a run similar to the /threads/__THREAD_ID__/runs/stream endpoint. Only output produced after this endpoint is called will be streamed.",
1958
1888
  "operationId": "stream_run_http_threads__thread_id__runs__run_id__join_get",
@@ -2019,9 +1949,7 @@
2019
1949
  },
2020
1950
  "/threads/{thread_id}/runs/{run_id}/cancel": {
2021
1951
  "post": {
2022
- "tags": [
2023
- "Thread Runs"
2024
- ],
1952
+ "tags": ["Thread Runs"],
2025
1953
  "summary": "Cancel Run",
2026
1954
  "operationId": "cancel_run_http_threads__thread_id__runs__run_id__cancel_post",
2027
1955
  "parameters": [
@@ -2064,10 +1992,7 @@
2064
1992
  "required": false,
2065
1993
  "schema": {
2066
1994
  "type": "string",
2067
- "enum": [
2068
- "interrupt",
2069
- "rollback"
2070
- ],
1995
+ "enum": ["interrupt", "rollback"],
2071
1996
  "title": "Action",
2072
1997
  "default": "interrupt"
2073
1998
  },
@@ -2109,9 +2034,7 @@
2109
2034
  },
2110
2035
  "/runs/crons": {
2111
2036
  "post": {
2112
- "tags": [
2113
- "Crons (Plus tier)"
2114
- ],
2037
+ "tags": ["Crons (Plus tier)"],
2115
2038
  "summary": "Create Cron",
2116
2039
  "description": "Create a cron to schedule runs on new threads.",
2117
2040
  "operationId": "create_cron_runs_crons_post",
@@ -2161,9 +2084,7 @@
2161
2084
  },
2162
2085
  "/runs/crons/search": {
2163
2086
  "post": {
2164
- "tags": [
2165
- "Crons (Plus tier)"
2166
- ],
2087
+ "tags": ["Crons (Plus tier)"],
2167
2088
  "summary": "Search Crons",
2168
2089
  "description": "Search all active crons",
2169
2090
  "operationId": "search_crons_runs_crons_post",
@@ -2207,9 +2128,7 @@
2207
2128
  },
2208
2129
  "/runs/stream": {
2209
2130
  "post": {
2210
- "tags": [
2211
- "Stateless Runs"
2212
- ],
2131
+ "tags": ["Stateless Runs"],
2213
2132
  "summary": "Create Run, Stream Output",
2214
2133
  "description": "Create a run in a new thread, stream the output.",
2215
2134
  "operationId": "stream_run_stateless_runs_stream_post",
@@ -2270,9 +2189,7 @@
2270
2189
  },
2271
2190
  "/runs/cancel": {
2272
2191
  "post": {
2273
- "tags": [
2274
- "Thread Runs"
2275
- ],
2192
+ "tags": ["Thread Runs"],
2276
2193
  "summary": "Cancel Runs",
2277
2194
  "description": "Cancel one or more runs. Can cancel runs by thread ID and run IDs, or by status filter.",
2278
2195
  "operationId": "cancel_runs_post",
@@ -2282,10 +2199,7 @@
2282
2199
  "required": false,
2283
2200
  "schema": {
2284
2201
  "type": "string",
2285
- "enum": [
2286
- "interrupt",
2287
- "rollback"
2288
- ],
2202
+ "enum": ["interrupt", "rollback"],
2289
2203
  "title": "Action",
2290
2204
  "default": "interrupt"
2291
2205
  },
@@ -2332,9 +2246,7 @@
2332
2246
  },
2333
2247
  "/runs/wait": {
2334
2248
  "post": {
2335
- "tags": [
2336
- "Stateless Runs"
2337
- ],
2249
+ "tags": ["Stateless Runs"],
2338
2250
  "summary": "Create Run, Wait for Output",
2339
2251
  "description": "Create a run in a new thread. Wait for the final output and then return it.",
2340
2252
  "operationId": "wait_run_stateless_runs_wait_post",
@@ -2392,9 +2304,7 @@
2392
2304
  },
2393
2305
  "/runs": {
2394
2306
  "post": {
2395
- "tags": [
2396
- "Stateless Runs"
2397
- ],
2307
+ "tags": ["Stateless Runs"],
2398
2308
  "summary": "Create Background Run",
2399
2309
  "description": "Create a run in a new thread, return the run ID immediately. Don't wait for the final run output.",
2400
2310
  "operationId": "run_stateless_runs_post",
@@ -2452,9 +2362,7 @@
2452
2362
  },
2453
2363
  "/runs/batch": {
2454
2364
  "post": {
2455
- "tags": [
2456
- "Stateless Runs"
2457
- ],
2365
+ "tags": ["Stateless Runs"],
2458
2366
  "summary": "Create Run Batch",
2459
2367
  "description": "Create a batch of runs in new threads, return immediately.",
2460
2368
  "operationId": "run_batch_stateless_runs_post",
@@ -2512,9 +2420,7 @@
2512
2420
  },
2513
2421
  "/runs/crons/{cron_id}": {
2514
2422
  "delete": {
2515
- "tags": [
2516
- "Crons (Plus tier)"
2517
- ],
2423
+ "tags": ["Crons (Plus tier)"],
2518
2424
  "summary": "Delete Cron",
2519
2425
  "description": "Delete a cron by ID.",
2520
2426
  "operationId": "delete_cron_runs_crons__cron_id__delete",
@@ -2564,9 +2470,7 @@
2564
2470
  },
2565
2471
  "/store/items": {
2566
2472
  "put": {
2567
- "tags": [
2568
- "Store"
2569
- ],
2473
+ "tags": ["Store"],
2570
2474
  "summary": "Store or update an item.",
2571
2475
  "operationId": "put_item",
2572
2476
  "requestBody": {
@@ -2596,9 +2500,7 @@
2596
2500
  }
2597
2501
  },
2598
2502
  "delete": {
2599
- "tags": [
2600
- "Store"
2601
- ],
2503
+ "tags": ["Store"],
2602
2504
  "summary": "Delete an item.",
2603
2505
  "operationId": "delete_item",
2604
2506
  "requestBody": {
@@ -2628,9 +2530,7 @@
2628
2530
  }
2629
2531
  },
2630
2532
  "get": {
2631
- "tags": [
2632
- "Store"
2633
- ],
2533
+ "tags": ["Store"],
2634
2534
  "summary": "Retrieve a single item.",
2635
2535
  "operationId": "get_item",
2636
2536
  "parameters": [
@@ -2690,9 +2590,7 @@
2690
2590
  },
2691
2591
  "/store/items/search": {
2692
2592
  "post": {
2693
- "tags": [
2694
- "Store"
2695
- ],
2593
+ "tags": ["Store"],
2696
2594
  "summary": "Search for items within a namespace prefix.",
2697
2595
  "operationId": "search_items",
2698
2596
  "requestBody": {
@@ -2731,9 +2629,7 @@
2731
2629
  },
2732
2630
  "/store/namespaces": {
2733
2631
  "post": {
2734
- "tags": [
2735
- "Store"
2736
- ],
2632
+ "tags": ["Store"],
2737
2633
  "summary": "List namespaces with optional match conditions.",
2738
2634
  "operationId": "list_namespaces",
2739
2635
  "requestBody": {
@@ -2769,6 +2665,88 @@
2769
2665
  }
2770
2666
  }
2771
2667
  }
2668
+ },
2669
+ "/mcp/": {
2670
+ "get": {
2671
+ "operationId": "get_mcp",
2672
+ "summary": "MCP Get",
2673
+ "description": "Implemented according to the Streamable HTTP Transport specification.",
2674
+ "responses": {
2675
+ "405": {
2676
+ "description": "GET method not allowed; streaming not supported."
2677
+ }
2678
+ },
2679
+ "tags": ["MCP"]
2680
+ },
2681
+ "post": {
2682
+ "operationId": "post_mcp",
2683
+ "summary": "MCP Post",
2684
+ "description": "Implemented according to the Streamable HTTP Transport specification.\nSends a JSON-RPC 2.0 message to the server.\n\n- **Request**: Provide an object with `jsonrpc`, `id`, `method`, and optional `params`.\n- **Response**: Returns a JSON-RPC response or acknowledgment.\n\n**Notes:**\n- Stateless: Sessions are not persisted across requests.\n",
2685
+ "parameters": [
2686
+ {
2687
+ "name": "Accept",
2688
+ "in": "header",
2689
+ "required": true,
2690
+ "schema": {
2691
+ "type": "string",
2692
+ "enum": ["application/json, text/event-stream"]
2693
+ },
2694
+ "description": "Accept header must include both 'application/json' and 'text/event-stream' media types."
2695
+ }
2696
+ ],
2697
+ "requestBody": {
2698
+ "required": true,
2699
+ "content": {
2700
+ "application/json": {
2701
+ "schema": { "type": "object" },
2702
+ "description": "A JSON-RPC 2.0 request, notification, or response object.",
2703
+ "example": {
2704
+ "jsonrpc": "2.0",
2705
+ "id": "1",
2706
+ "method": "initialize",
2707
+ "params": {
2708
+ "clientInfo": {
2709
+ "name": "test_client",
2710
+ "version": "1.0.0"
2711
+ },
2712
+ "protocolVersion": "2024-11-05",
2713
+ "capabilities": {}
2714
+ }
2715
+ }
2716
+ }
2717
+ }
2718
+ },
2719
+ "responses": {
2720
+ "200": {
2721
+ "description": "Successful JSON-RPC response.",
2722
+ "content": {
2723
+ "application/json": { "schema": { "type": "object" } }
2724
+ }
2725
+ },
2726
+ "202": {
2727
+ "description": "Notification or response accepted; no content body."
2728
+ },
2729
+ "400": {
2730
+ "description": "Bad request: invalid JSON or message format, or unacceptable Accept header."
2731
+ },
2732
+ "405": {
2733
+ "description": "HTTP method not allowed."
2734
+ },
2735
+ "500": {
2736
+ "description": "Internal server error or unexpected failure."
2737
+ }
2738
+ },
2739
+ "tags": ["MCP"]
2740
+ },
2741
+ "delete": {
2742
+ "operationId": "delete_mcp",
2743
+ "summary": "Terminate Session",
2744
+ "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",
2745
+ "responses": {
2746
+ "404": {}
2747
+ },
2748
+ "tags": ["MCP"]
2749
+ }
2772
2750
  }
2773
2751
  },
2774
2752
  "components": {
@@ -2877,10 +2855,7 @@
2877
2855
  },
2878
2856
  "if_exists": {
2879
2857
  "type": "string",
2880
- "enum": [
2881
- "raise",
2882
- "do_nothing"
2883
- ],
2858
+ "enum": ["raise", "do_nothing"],
2884
2859
  "title": "If Exists",
2885
2860
  "description": "How to handle duplicate creation. Must be either 'raise' (raise error if duplicate), or 'do_nothing' (return existing assistant).",
2886
2861
  "default": "raise"
@@ -2897,9 +2872,7 @@
2897
2872
  }
2898
2873
  },
2899
2874
  "type": "object",
2900
- "required": [
2901
- "graph_id"
2902
- ],
2875
+ "required": ["graph_id"],
2903
2876
  "title": "AssistantCreate",
2904
2877
  "description": "Payload for creating an assistant."
2905
2878
  },
@@ -3099,9 +3072,7 @@
3099
3072
  "anyOf": [
3100
3073
  {
3101
3074
  "type": "string",
3102
- "enum": [
3103
- "*"
3104
- ]
3075
+ "enum": ["*"]
3105
3076
  },
3106
3077
  {
3107
3078
  "items": {
@@ -3117,9 +3088,7 @@
3117
3088
  "anyOf": [
3118
3089
  {
3119
3090
  "type": "string",
3120
- "enum": [
3121
- "*"
3122
- ]
3091
+ "enum": ["*"]
3123
3092
  },
3124
3093
  {
3125
3094
  "items": {
@@ -3133,22 +3102,14 @@
3133
3102
  },
3134
3103
  "multitask_strategy": {
3135
3104
  "type": "string",
3136
- "enum": [
3137
- "reject",
3138
- "rollback",
3139
- "interrupt",
3140
- "enqueue"
3141
- ],
3105
+ "enum": ["reject", "rollback", "interrupt", "enqueue"],
3142
3106
  "title": "Multitask Strategy",
3143
3107
  "description": "Multitask strategy to use. Must be one of 'reject', 'interrupt', 'rollback', or 'enqueue'.",
3144
3108
  "default": "reject"
3145
3109
  }
3146
3110
  },
3147
3111
  "type": "object",
3148
- "required": [
3149
- "assistant_id",
3150
- "schedule"
3151
- ],
3112
+ "required": ["assistant_id", "schedule"],
3152
3113
  "title": "CronCreate",
3153
3114
  "description": "Payload for creating a cron job."
3154
3115
  },
@@ -3216,11 +3177,7 @@
3216
3177
  }
3217
3178
  },
3218
3179
  "type": "object",
3219
- "required": [
3220
- "graph_id",
3221
- "state_schema",
3222
- "config_schema"
3223
- ],
3180
+ "required": ["graph_id", "state_schema", "config_schema"],
3224
3181
  "title": "GraphSchema",
3225
3182
  "description": "Defines the structure and properties of a graph."
3226
3183
  },
@@ -3299,13 +3256,7 @@
3299
3256
  },
3300
3257
  "status": {
3301
3258
  "type": "string",
3302
- "enum": [
3303
- "pending",
3304
- "error",
3305
- "success",
3306
- "timeout",
3307
- "interrupted"
3308
- ],
3259
+ "enum": ["pending", "error", "success", "timeout", "interrupted"],
3309
3260
  "title": "Status",
3310
3261
  "description": "The status of the run. One of 'pending', 'error', 'success', 'timeout', 'interrupted'."
3311
3262
  },
@@ -3320,12 +3271,7 @@
3320
3271
  },
3321
3272
  "multitask_strategy": {
3322
3273
  "type": "string",
3323
- "enum": [
3324
- "reject",
3325
- "rollback",
3326
- "interrupt",
3327
- "enqueue"
3328
- ],
3274
+ "enum": ["reject", "rollback", "interrupt", "enqueue"],
3329
3275
  "title": "Multitask Strategy",
3330
3276
  "description": "Strategy to handle concurrent runs on the same thread."
3331
3277
  }
@@ -3355,22 +3301,12 @@
3355
3301
  "description": "The node to send the message to."
3356
3302
  },
3357
3303
  "input": {
3358
- "type": [
3359
- "object",
3360
- "array",
3361
- "number",
3362
- "string",
3363
- "boolean",
3364
- "null"
3365
- ],
3304
+ "type": ["object", "array", "number", "string", "boolean", "null"],
3366
3305
  "title": "Message",
3367
3306
  "description": "The message to send."
3368
3307
  }
3369
3308
  },
3370
- "required": [
3371
- "node",
3372
- "input"
3373
- ]
3309
+ "required": ["node", "input"]
3374
3310
  },
3375
3311
  "Command": {
3376
3312
  "type": "object",
@@ -3378,23 +3314,12 @@
3378
3314
  "description": "The command to run.",
3379
3315
  "properties": {
3380
3316
  "update": {
3381
- "type": [
3382
- "object",
3383
- "array",
3384
- "null"
3385
- ],
3317
+ "type": ["object", "array", "null"],
3386
3318
  "title": "Update",
3387
3319
  "description": "An update to the state."
3388
3320
  },
3389
3321
  "resume": {
3390
- "type": [
3391
- "object",
3392
- "array",
3393
- "number",
3394
- "string",
3395
- "boolean",
3396
- "null"
3397
- ],
3322
+ "type": ["object", "array", "number", "string", "boolean", "null"],
3398
3323
  "title": "Resume",
3399
3324
  "description": "A value to pass to an interrupted node."
3400
3325
  },
@@ -3524,9 +3449,7 @@
3524
3449
  "anyOf": [
3525
3450
  {
3526
3451
  "type": "string",
3527
- "enum": [
3528
- "*"
3529
- ]
3452
+ "enum": ["*"]
3530
3453
  },
3531
3454
  {
3532
3455
  "items": {
@@ -3542,9 +3465,7 @@
3542
3465
  "anyOf": [
3543
3466
  {
3544
3467
  "type": "string",
3545
- "enum": [
3546
- "*"
3547
- ]
3468
+ "enum": ["*"]
3548
3469
  },
3549
3470
  {
3550
3471
  "items": {
@@ -3588,9 +3509,7 @@
3588
3509
  ],
3589
3510
  "title": "Stream Mode",
3590
3511
  "description": "The stream mode(s) to use.",
3591
- "default": [
3592
- "values"
3593
- ]
3512
+ "default": ["values"]
3594
3513
  },
3595
3514
  "stream_subgraphs": {
3596
3515
  "type": "boolean",
@@ -3600,10 +3519,7 @@
3600
3519
  },
3601
3520
  "on_disconnect": {
3602
3521
  "type": "string",
3603
- "enum": [
3604
- "cancel",
3605
- "continue"
3606
- ],
3522
+ "enum": ["cancel", "continue"],
3607
3523
  "title": "On Disconnect",
3608
3524
  "description": "The disconnect mode to use. Must be one of 'cancel' or 'continue'.",
3609
3525
  "default": "cancel"
@@ -3618,22 +3534,14 @@
3618
3534
  },
3619
3535
  "multitask_strategy": {
3620
3536
  "type": "string",
3621
- "enum": [
3622
- "reject",
3623
- "rollback",
3624
- "interrupt",
3625
- "enqueue"
3626
- ],
3537
+ "enum": ["reject", "rollback", "interrupt", "enqueue"],
3627
3538
  "title": "Multitask Strategy",
3628
3539
  "description": "Multitask strategy to use. Must be one of 'reject', 'interrupt', 'rollback', or 'enqueue'.",
3629
3540
  "default": "reject"
3630
3541
  },
3631
3542
  "if_not_exists": {
3632
3543
  "type": "string",
3633
- "enum": [
3634
- "create",
3635
- "reject"
3636
- ],
3544
+ "enum": ["create", "reject"],
3637
3545
  "title": "If Not Exists",
3638
3546
  "description": "How to handle missing thread. Must be either 'reject' (raise error if missing), or 'create' (create new thread).",
3639
3547
  "default": "reject"
@@ -3651,9 +3559,7 @@
3651
3559
  }
3652
3560
  },
3653
3561
  "type": "object",
3654
- "required": [
3655
- "assistant_id"
3656
- ],
3562
+ "required": ["assistant_id"],
3657
3563
  "title": "RunCreateStateful",
3658
3564
  "description": "Payload for creating a run."
3659
3565
  },
@@ -3757,9 +3663,7 @@
3757
3663
  "anyOf": [
3758
3664
  {
3759
3665
  "type": "string",
3760
- "enum": [
3761
- "*"
3762
- ]
3666
+ "enum": ["*"]
3763
3667
  },
3764
3668
  {
3765
3669
  "items": {
@@ -3775,9 +3679,7 @@
3775
3679
  "anyOf": [
3776
3680
  {
3777
3681
  "type": "string",
3778
- "enum": [
3779
- "*"
3780
- ]
3682
+ "enum": ["*"]
3781
3683
  },
3782
3684
  {
3783
3685
  "items": {
@@ -3821,9 +3723,7 @@
3821
3723
  ],
3822
3724
  "title": "Stream Mode",
3823
3725
  "description": "The stream mode(s) to use.",
3824
- "default": [
3825
- "values"
3826
- ]
3726
+ "default": ["values"]
3827
3727
  },
3828
3728
  "feedback_keys": {
3829
3729
  "items": {
@@ -3841,20 +3741,14 @@
3841
3741
  },
3842
3742
  "on_completion": {
3843
3743
  "type": "string",
3844
- "enum": [
3845
- "delete",
3846
- "keep"
3847
- ],
3744
+ "enum": ["delete", "keep"],
3848
3745
  "title": "On Completion",
3849
3746
  "description": "Whether to delete or keep the thread created for a stateless run. Must be one of 'delete' or 'keep'.",
3850
3747
  "default": "delete"
3851
3748
  },
3852
3749
  "on_disconnect": {
3853
3750
  "type": "string",
3854
- "enum": [
3855
- "cancel",
3856
- "continue"
3857
- ],
3751
+ "enum": ["cancel", "continue"],
3858
3752
  "title": "On Disconnect",
3859
3753
  "description": "The disconnect mode to use. Must be one of 'cancel' or 'continue'.",
3860
3754
  "default": "cancel"
@@ -3868,13 +3762,11 @@
3868
3762
  "type": "boolean",
3869
3763
  "title": "Checkpoint During",
3870
3764
  "description": "Whether to checkpoint during the run.",
3871
- "default": false
3765
+ "default": false
3872
3766
  }
3873
3767
  },
3874
3768
  "type": "object",
3875
- "required": [
3876
- "assistant_id"
3877
- ],
3769
+ "required": ["assistant_id"],
3878
3770
  "title": "RunCreateStateless",
3879
3771
  "description": "Payload for creating a run."
3880
3772
  },
@@ -3919,10 +3811,7 @@
3919
3811
  },
3920
3812
  "sort_order": {
3921
3813
  "type": "string",
3922
- "enum": [
3923
- "asc",
3924
- "desc"
3925
- ],
3814
+ "enum": ["asc", "desc"],
3926
3815
  "title": "Sort Order",
3927
3816
  "description": "The order to sort by."
3928
3817
  }
@@ -3972,12 +3861,7 @@
3972
3861
  },
3973
3862
  "status": {
3974
3863
  "type": "string",
3975
- "enum": [
3976
- "idle",
3977
- "busy",
3978
- "interrupted",
3979
- "error"
3980
- ],
3864
+ "enum": ["idle", "busy", "interrupted", "error"],
3981
3865
  "title": "Status",
3982
3866
  "description": "Thread status to filter on."
3983
3867
  },
@@ -3998,21 +3882,13 @@
3998
3882
  },
3999
3883
  "sort_by": {
4000
3884
  "type": "string",
4001
- "enum": [
4002
- "thread_id",
4003
- "status",
4004
- "created_at",
4005
- "updated_at"
4006
- ],
3885
+ "enum": ["thread_id", "status", "created_at", "updated_at"],
4007
3886
  "title": "Sort By",
4008
3887
  "description": "Sort by field."
4009
3888
  },
4010
3889
  "sort_order": {
4011
3890
  "type": "string",
4012
- "enum": [
4013
- "asc",
4014
- "desc"
4015
- ],
3891
+ "enum": ["asc", "desc"],
4016
3892
  "title": "Sort Order",
4017
3893
  "description": "Sort order."
4018
3894
  }
@@ -4048,12 +3924,7 @@
4048
3924
  },
4049
3925
  "status": {
4050
3926
  "type": "string",
4051
- "enum": [
4052
- "idle",
4053
- "busy",
4054
- "interrupted",
4055
- "error"
4056
- ],
3927
+ "enum": ["idle", "busy", "interrupted", "error"],
4057
3928
  "title": "Status",
4058
3929
  "description": "The status of the thread."
4059
3930
  },
@@ -4088,10 +3959,7 @@
4088
3959
  },
4089
3960
  "if_exists": {
4090
3961
  "type": "string",
4091
- "enum": [
4092
- "raise",
4093
- "do_nothing"
4094
- ],
3962
+ "enum": ["raise", "do_nothing"],
4095
3963
  "title": "If Exists",
4096
3964
  "description": "How to handle duplicate creation. Must be either 'raise' (raise error if duplicate), or 'do_nothing' (return existing thread).",
4097
3965
  "default": "raise"
@@ -4120,7 +3988,9 @@
4120
3988
  "properties": {
4121
3989
  "updates": {
4122
3990
  "type": "array",
4123
- "items": { "$ref": "#/components/schemas/ThreadSuperstepUpdate" }
3991
+ "items": {
3992
+ "$ref": "#/components/schemas/ThreadSuperstepUpdate"
3993
+ }
4124
3994
  }
4125
3995
  },
4126
3996
  "required": ["updates"]
@@ -4156,9 +4026,7 @@
4156
4026
  "description": "Include subgraph states."
4157
4027
  }
4158
4028
  },
4159
- "required": [
4160
- "checkpoint"
4161
- ],
4029
+ "required": ["checkpoint"],
4162
4030
  "type": "object",
4163
4031
  "title": "ThreadStateCheckpointRequest",
4164
4032
  "description": "Payload for getting the state of a thread at a checkpoint."
@@ -4214,10 +4082,7 @@
4214
4082
  "$ref": "#/components/schemas/ThreadState"
4215
4083
  }
4216
4084
  },
4217
- "required": [
4218
- "id",
4219
- "name"
4220
- ]
4085
+ "required": ["id", "name"]
4221
4086
  },
4222
4087
  "type": "array",
4223
4088
  "title": "Tasks"
@@ -4240,13 +4105,7 @@
4240
4105
  }
4241
4106
  },
4242
4107
  "type": "object",
4243
- "required": [
4244
- "values",
4245
- "next",
4246
- "checkpoint",
4247
- "metadata",
4248
- "created_at"
4249
- ],
4108
+ "required": ["values", "next", "checkpoint", "metadata", "created_at"],
4250
4109
  "title": "ThreadState"
4251
4110
  },
4252
4111
  "ThreadStateSearch": {
@@ -4386,11 +4245,7 @@
4386
4245
  },
4387
4246
  "StorePutRequest": {
4388
4247
  "type": "object",
4389
- "required": [
4390
- "namespace",
4391
- "key",
4392
- "value"
4393
- ],
4248
+ "required": ["namespace", "key", "value"],
4394
4249
  "properties": {
4395
4250
  "namespace": {
4396
4251
  "type": "array",
@@ -4416,9 +4271,7 @@
4416
4271
  },
4417
4272
  "StoreDeleteRequest": {
4418
4273
  "type": "object",
4419
- "required": [
4420
- "key"
4421
- ],
4274
+ "required": ["key"],
4422
4275
  "properties": {
4423
4276
  "namespace": {
4424
4277
  "type": "array",
@@ -4441,10 +4294,7 @@
4441
4294
  "type": "object",
4442
4295
  "properties": {
4443
4296
  "namespace_prefix": {
4444
- "type": [
4445
- "array",
4446
- "null"
4447
- ],
4297
+ "type": ["array", "null"],
4448
4298
  "items": {
4449
4299
  "type": "string"
4450
4300
  },
@@ -4452,10 +4302,7 @@
4452
4302
  "description": "List of strings representing the namespace prefix."
4453
4303
  },
4454
4304
  "filter": {
4455
- "type": [
4456
- "object",
4457
- "null"
4458
- ],
4305
+ "type": ["object", "null"],
4459
4306
  "additionalProperties": true,
4460
4307
  "title": "Filter",
4461
4308
  "description": "Optional dictionary of key-value pairs to filter results."
@@ -4516,13 +4363,7 @@
4516
4363
  },
4517
4364
  "Item": {
4518
4365
  "type": "object",
4519
- "required": [
4520
- "namespace",
4521
- "key",
4522
- "value",
4523
- "created_at",
4524
- "updated_at"
4525
- ],
4366
+ "required": ["namespace", "key", "value", "created_at", "updated_at"],
4526
4367
  "properties": {
4527
4368
  "namespace": {
4528
4369
  "type": "array",
@@ -4590,9 +4431,7 @@
4590
4431
  },
4591
4432
  "SearchItemsResponse": {
4592
4433
  "type": "object",
4593
- "required": [
4594
- "items"
4595
- ],
4434
+ "required": ["items"],
4596
4435
  "properties": {
4597
4436
  "items": {
4598
4437
  "type": "array",