From 5db65e0281175938ec424764582690ab6ffe3c6d Mon Sep 17 00:00:00 2001 From: William FH <13333726+hinthornw@users.noreply.github.com> Date: Wed, 3 Sep 2025 06:25:52 +0800 Subject: [PATCH] chore(docs): Update OpenAPI spec from LangGraph API v0.4.8 (#6065) This PR updates the OpenAPI specification with changes detected from the LangGraph API server. **Changes detected as of LangGraph API version 0.4.8** This update was automatically generated by the sync workflow in the langgraph-api repository. Co-authored-by: hinthornw --- docs/docs/cloud/reference/api/openapi.json | 193 +++++++++++++++++++++ 1 file changed, 193 insertions(+) diff --git a/docs/docs/cloud/reference/api/openapi.json b/docs/docs/cloud/reference/api/openapi.json index d322f5ee0..fd1147f3a 100644 --- a/docs/docs/cloud/reference/api/openapi.json +++ b/docs/docs/cloud/reference/api/openapi.json @@ -29,6 +29,10 @@ "name": "Store", "description": "Store is an API for managing persistent key-value store (long-term memory) that is available from any thread." }, + { + "name": "A2A", + "description": "Agent-to-Agent Protocol related endpoints for exposing assistants as A2A-compliant agents." + }, { "name": "MCP", "description": "Model Context Protocol related endpoints for exposing an agent as an MCP server." @@ -3182,6 +3186,195 @@ } } }, + "/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", + "parameters": [ + { + "name": "assistant_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "format": "uuid" + }, + "description": "The ID of the assistant to communicate with" + }, + { + "name": "Accept", + "in": "header", + "required": true, + "schema": { + "type": "string", + "enum": ["application/json"] + }, + "description": "Must be application/json" + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "jsonrpc": { + "type": "string", + "enum": ["2.0"], + "description": "JSON-RPC version" + }, + "id": { + "type": "string", + "description": "Request identifier" + }, + "method": { + "type": "string", + "enum": ["message/send", "tasks/get"], + "description": "The method to invoke" + }, + "params": { + "type": "object", + "description": "Method parameters", + "oneOf": [ + { + "title": "Message Send Parameters", + "properties": { + "message": { + "type": "object", + "properties": { + "role": { + "type": "string", + "enum": ["user", "assistant"], + "description": "Message role" + }, + "parts": { + "type": "array", + "items": { + "oneOf": [ + { + "title": "Text Part", + "type": "object", + "properties": { + "kind": { + "type": "string", + "enum": ["text"] + }, + "text": { + "type": "string" + } + }, + "required": ["kind", "text"] + }, + { + "title": "Data Part", + "type": "object", + "properties": { + "kind": { + "type": "string", + "enum": ["data"] + }, + "data": { + "type": "object" + } + }, + "required": ["kind", "data"] + } + ] + }, + "description": "Message parts" + }, + "messageId": { + "type": "string", + "description": "Unique message identifier" + } + }, + "required": ["role", "parts", "messageId"] + }, + "thread": { + "type": "object", + "properties": { + "threadId": { + "type": "string", + "description": "Thread identifier for conversation context" + } + }, + "description": "Optional thread context" + } + }, + "required": ["message"] + }, + { + "title": "Task Get Parameters", + "properties": { + "taskId": { + "type": "string", + "description": "Task identifier to retrieve" + } + }, + "required": ["taskId"] + } + ] + } + }, + "required": ["jsonrpc", "id", "method"] + } + } + } + }, + "responses": { + "200": { + "description": "JSON-RPC response", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "jsonrpc": { + "type": "string", + "enum": ["2.0"] + }, + "id": { + "type": "string" + }, + "result": { + "type": "object", + "description": "Success result containing task information or task details" + }, + "error": { + "type": "object", + "properties": { + "code": { + "type": "integer" + }, + "message": { + "type": "string" + } + }, + "description": "Error information if request failed" + } + }, + "required": ["jsonrpc", "id"] + } + } + } + }, + "400": { + "description": "Bad request - invalid JSON-RPC or missing Accept header" + }, + "404": { + "description": "Assistant not found" + }, + "500": { + "description": "Internal server error" + } + }, + "tags": [ + "A2A" + ] + } + }, "/mcp/": { "post": { "operationId": "post_mcp",