{"items":[{"type":"link","label":"CDQ Genius - A2A (JSON-RPC 2.0) API","link":"/apis/genius-a2a/api-v1","routeSlug":"/apis/genius-a2a/api-v1","content":{"contentType":"overview","meta":{"name":"CDQ Genius - A2A (JSON-RPC 2.0) API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"api-v1.json","url":"/_bundle/apis/genius-a2a/@genius-a2a-v1/api-v1.json?download"},{"kind":"download","label":"api-v1.yaml","url":"/_bundle/apis/genius-a2a/@genius-a2a-v1/api-v1.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://api.cdq.com/a2a/cdq-genius","description":"CDQ Genius A2A base URL. The Agent Card is served at /.well-known/agent-card.json and all JSON-RPC operations are POSTed to /."}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"CDQ Genius - A2A (JSON-RPC 2.0) API (1.0)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This document describes "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"CDQ Genius"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'s Agent2Agent (A2A) protocol"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"JSON-RPC 2.0 binding, per the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://a2a-protocol.org/latest/specification/#9-json-rpc-protocol-binding"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A2A 1.0 specification, §9"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"sectionId":"/apis/genius-a2a/api-v1"}],"sectionId":"/apis/genius-a2a/api-v1"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"section/how-the-transport-works"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How the transport works"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The A2A JSON-RPC binding exposes "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"one physical HTTP endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Every"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"operation is a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of a JSON-RPC 2.0 envelope to the base URL, and the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"server dispatches on the envelope's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"method"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field:"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"POST https://api.cdq.com/a2a/cdq-genius/\nContent-Type: application/json\nA2A-Version: 1.0\nX-API-KEY: {YOUR_API_KEY}\n"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"POST https://api.cdq.com/a2a/cdq-genius/\nContent-Type: application/json\nA2A-Version: 1.0\nX-API-KEY: {YOUR_API_KEY}\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supported methods are shown as selectable request examples on the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operation below ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SendMessage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GetTask"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CancelTask"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://api.cdq.com/a2a/cdq-genius/.well-known/agent-card.json"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Agent Card"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(served by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operation below) is the authoritative source for the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"endpoint URL, transport, and capabilities."},"children":[]}]}]}]}],"sectionId":"/apis/genius-a2a/api-v1/section/how-the-transport-works"}]}]}},{"type":"link","label":"How the transport works","link":"/apis/genius-a2a/api-v1/section/how-the-transport-works","routeSlug":"/apis/genius-a2a/api-v1/section/how-the-transport-works","content":null},{"type":"group","label":"Agent Card","link":"/apis/genius-a2a/api-v1/agent-card","routeSlug":"/apis/genius-a2a/api-v1/agent-card","items":[{"label":"Read Agent Card","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/genius-a2a/api-v1/agent-card/paths/~1.well-known~1agent-card.json/get","routeSlug":"/apis/genius-a2a/api-v1/agent-card/paths/~1.well-known~1agent-card.json/get","metadata":{"seo":{"title":"Read Agent Card","description":"Returns the A2A Agent Card — the discovery document that declares this agent's name, endpoint URL, transport binding, capabilities and skills. Clients read this first to learn where and how to call the agent."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"name":"Read Agent Card","isWebhook":false,"pointer":"/paths/~1.well-known~1agent-card.json/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Read Agent Card","badges":[{"name":"BETA","color":"blue","position":"after"}],"isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the A2A Agent Card — the discovery document that declares this agent's name, endpoint URL, transport binding, capabilities and skills. Clients read this first to learn where and how to call the agent."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"apiKey","scopes":[],"type":"apiKey","in":"header","paramName":"X-API-KEY"}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/.well-known/agent-card.json","servers":[{"url":"https://api.cdq.com/a2a/cdq-genius","description":"CDQ Genius A2A base URL. The Agent Card is served at /.well-known/agent-card.json and all JSON-RPC operations are POSTed to /."}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"apiKey","type":"apiKey","name":"X-API-KEY","in":"header"}],"scopes":[]}],"responseCodes":["200","500"],"pointer":"/.well-known/agent-card.json","href":"agent-card/paths/~1.well-known~1agent-card.json/get","summary":"Read Agent Card"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.cdq.com/a2a/cdq-genius","description":"CDQ Genius A2A base URL. The Agent Card is served at /.well-known/agent-card.json and all JSON-RPC operations are POSTed to /."}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The Agent Card describing CDQ Genius.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AgentCard"}},"schemaId":"components/schemas/AgentCard"},{"code":"500","description":"Internal server error while producing the Agent Card."}],"pointer":"/paths/~1.well-known~1agent-card.json/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/AgentCard","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AgentCard"}}},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/agent-card/paths/~1.well-known~1agent-card.json/get"}],"panels":[]}]},"badges":[{"name":"BETA","color":"blue","position":"after"}],"httpPath":"/.well-known/agent-card.json"}],"content":{"contentType":"group","meta":{"name":"Agent Card"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Agent Card","showPageActions":true},{"nodeType":"markdoc","content":"Agent discovery document describing this agent's endpoint, transport, and capabilities."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/.well-known/agent-card.json","summary":"Read Agent Card","prefix":{"name":"get","color":"get"},"badges":[{"name":"BETA","color":"blue","position":"after"}],"link":"/agent-card/paths/~1.well-known~1agent-card.json/get","deprecated":false}]}]}]}]}},{"type":"group","label":"JSON-RPC","link":"/apis/genius-a2a/api-v1/json-rpc","routeSlug":"/apis/genius-a2a/api-v1/json-rpc","items":[{"label":"Send JSON-RPC Request","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/genius-a2a/api-v1/json-rpc/paths/~1/post","routeSlug":"/apis/genius-a2a/api-v1/json-rpc/paths/~1/post","metadata":{"seo":{"title":"Send JSON-RPC Request","description":"Single A2A JSON-RPC 2.0 transport endpoint. The body is a JSON-RPC envelope whose method field selects the operation. Choose a request example (SendMessage, GetTask, CancelTask) to see the payload for each method. On success the response result holds a Task or a Message. All failures — including request-validation errors such as an invalid enum value — are returned as a JSON-RPC error object with HTTP status 200, per the A2A JSON-RPC binding; the endpoint does not use HTTP 4xx status codes to signal application or validation errors."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"name":"Send JSON-RPC Request","isWebhook":false,"pointer":"/paths/~1/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Send JSON-RPC Request","badges":[{"name":"BETA","color":"blue","position":"after"}],"isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Single A2A JSON-RPC 2.0 transport endpoint. The body is a JSON-RPC envelope whose "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"method"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field selects the operation. Choose a request example ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SendMessage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GetTask"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CancelTask"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") to see the payload for each method. On success the response "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"result"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" holds a Task or a Message. All failures — including request-validation errors such as an invalid enum value — are returned as a JSON-RPC "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object with HTTP status 200, per the A2A JSON-RPC binding; the endpoint does not use HTTP 4xx status codes to signal application or validation errors."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"apiKey","scopes":[],"type":"apiKey","in":"header","paramName":"X-API-KEY"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"A2A-Version","in":"header","schemaId":"schema_0","description":"A2A protocol version the client targets."}],"pointer":"/paths/~1/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/JSONRPCRequest","exampleIds":["paths/~1/post/requestBody/content/application~1json/examples/SendMessage","paths/~1/post/requestBody/content/application~1json/examples/GetTask","paths/~1/post/requestBody/content/application~1json/examples/CancelTask"]}},"schemaId":"components/schemas/JSONRPCRequest","exampleIds":["paths/~1/post/requestBody/content/application~1json/examples/SendMessage","paths/~1/post/requestBody/content/application~1json/examples/GetTask","paths/~1/post/requestBody/content/application~1json/examples/CancelTask"],"pointer":"/paths/~1/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/","servers":[{"url":"https://api.cdq.com/a2a/cdq-genius","description":"CDQ Genius A2A base URL. The Agent Card is served at /.well-known/agent-card.json and all JSON-RPC operations are POSTed to /."}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"A2A-Version","in":"header","required":false,"example":"1.0","schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"apiKey","type":"apiKey","name":"X-API-KEY","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/JSONRPCRequest","exampleIds":["paths/~1/post/requestBody/content/application~1json/examples/SendMessage","paths/~1/post/requestBody/content/application~1json/examples/GetTask","paths/~1/post/requestBody/content/application~1json/examples/CancelTask"]}},"responseCodes":["200"],"pointer":"/","href":"json-rpc/paths/~1/post","summary":"Send JSON-RPC Request"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.cdq.com/a2a/cdq-genius","description":"CDQ Genius A2A base URL. The Agent Card is served at /.well-known/agent-card.json and all JSON-RPC operations are POSTed to /."}],"schemaId":"components/schemas/JSONRPCRequest","exampleIds":["paths/~1/post/requestBody/content/application~1json/examples/SendMessage","paths/~1/post/requestBody/content/application~1json/examples/GetTask","paths/~1/post/requestBody/content/application~1json/examples/CancelTask"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/JSONRPCRequest","exampleIds":["paths/~1/post/requestBody/content/application~1json/examples/SendMessage","paths/~1/post/requestBody/content/application~1json/examples/GetTask","paths/~1/post/requestBody/content/application~1json/examples/CancelTask"]}},"examples":[{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"JSON-RPC 2.0 response. On success "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"result"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a Task or a Message; on any failure — including validation errors — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is populated (see JSONRPCError). This endpoint always responds with HTTP 200; it does not return HTTP 4xx codes for application or validation errors."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1","exampleIds":["paths/~1/post/responses/200/content/application~1json/examples/taskCompleted","paths/~1/post/responses/200/content/application~1json/examples/invalidParams","paths/~1/post/responses/200/content/application~1json/examples/taskNotFound"]}},"schemaId":"schema_1","exampleIds":["paths/~1/post/responses/200/content/application~1json/examples/taskCompleted","paths/~1/post/responses/200/content/application~1json/examples/invalidParams","paths/~1/post/responses/200/content/application~1json/examples/taskNotFound"]}],"pointer":"/paths/~1/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1","exampleIds":["paths/~1/post/responses/200/content/application~1json/examples/taskCompleted","paths/~1/post/responses/200/content/application~1json/examples/invalidParams","paths/~1/post/responses/200/content/application~1json/examples/taskNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1","exampleIds":["paths/~1/post/responses/200/content/application~1json/examples/taskCompleted","paths/~1/post/responses/200/content/application~1json/examples/invalidParams","paths/~1/post/responses/200/content/application~1json/examples/taskNotFound"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/json-rpc/paths/~1/post"}],"panels":[]}]},"badges":[{"name":"BETA","color":"blue","position":"after"}],"httpPath":"/"}],"content":{"contentType":"group","meta":{"name":"JSON-RPC"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"JSON-RPC","showPageActions":true},{"nodeType":"markdoc","content":"The single JSON-RPC 2.0 transport endpoint that dispatches all A2A methods on the envelope's method field."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/","summary":"Send JSON-RPC Request","prefix":{"name":"post","color":"post"},"badges":[{"name":"BETA","color":"blue","position":"after"}],"link":"/json-rpc/paths/~1/post","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/JSONRPCRequest":{"id":"components/schemas/JSONRPCRequest","kind":"json-schema","title":"JSONRPCRequest","data":{"type":"object","description":"JSON-RPC 2.0 request envelope. The method field selects the A2A operation and params carries its method-specific parameters.","required":["jsonrpc","id","method","params"],"properties":{"jsonrpc":{"type":"string","description":"JSON-RPC protocol version. Always \"2.0\".","const":"2.0","example":"2.0"},"id":{"description":"Client-chosen request identifier, echoed back in the response.","oneOf":[{"type":"string"},{"type":"integer"}],"example":1},"method":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The A2A method to invoke. Supported values: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SendMessage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GetTask"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CancelTask"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Confirm the exact literals against the Agent Card before use, as additional methods may be added over time."},"children":[]}]}]}],"example":"SendMessage"},"params":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Method-specific parameters. The shape depends on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"method"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — see the request examples on the POST operation for each supported method."},"children":[]}]}]}],"example":{"message":{"messageId":"9229e770-767c-417b-a0b0-f0741243c581","role":"ROLE_USER","parts":[{"text":"Provide me data to help onboarding my business partner Name: Boehringer Ingelheim GmbH, Country: DE, City: Bieberach"}]},"metadata":{}}}}}},"components/schemas/JSONRPCSuccessResponse":{"id":"components/schemas/JSONRPCSuccessResponse","kind":"json-schema","title":"JSONRPCSuccessResponse","data":{"type":"object","description":"JSON-RPC 2.0 success response envelope.","required":["jsonrpc","id","result"],"properties":{"jsonrpc":{"type":"string","description":"JSON-RPC protocol version. Always \"2.0\".","const":"2.0","example":"2.0"},"id":{"description":"The request identifier echoed back from the request.","oneOf":[{"type":"string"},{"type":"integer"}],"example":1},"result":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The successful result — a Task (for asynchronous processing) or a direct Message."},"children":[]}]}]}],"oneOf":[{"$ref":"#/components/schemas/Task"},{"$ref":"#/components/schemas/Message"}]}}}},"components/schemas/JSONRPCErrorResponse":{"id":"components/schemas/JSONRPCErrorResponse","kind":"json-schema","title":"JSONRPCErrorResponse","data":{"type":"object","description":"JSON-RPC 2.0 error response envelope.","required":["jsonrpc","id","error"],"properties":{"jsonrpc":{"type":"string","description":"JSON-RPC protocol version. Always \"2.0\".","const":"2.0","example":"2.0"},"id":{"description":"The request identifier echoed back from the request.","oneOf":[{"type":"string"},{"type":"integer"}],"example":1},"error":{"description":"The error object describing the failure.","$ref":"#/components/schemas/JSONRPCError"}}}},"components/schemas/JSONRPCError":{"id":"components/schemas/JSONRPCError","kind":"json-schema","title":"JSONRPCError","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"JSON-RPC 2.0 error object. Standard JSON-RPC errors use codes"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-32700..-32603; A2A-specific errors use codes -32001..-32009"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see the A2A specification §3.3.2 / §9.5)."},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Code"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Meaning"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-32700"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ParseError"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Invalid JSON was received; the payload could not be parsed."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-32600"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"InvalidRequest"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payload is not a valid JSON-RPC 2.0 request object."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-32601"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"MethodNotFound"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The requested "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"method"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" does not exist or is not supported."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-32602"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"InvalidParams"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"params"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are invalid, e.g. a bad enum value or missing field."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-32603"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"InternalError"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An internal error occurred while processing the request."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-32001"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"TaskNotFoundError"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The referenced task does not exist."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-32002"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"TaskNotCancelableError"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The task exists but is in a state that cannot be canceled."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-32003"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"PushNotificationNotSupportedError"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The agent does not support push notifications."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-32004"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"UnsupportedOperationError"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The requested operation is not supported by the agent."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-32005"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ContentTypeNotSupportedError"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A content type in the request is not supported."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-32006"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"InvalidAgentResponseError"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The agent produced an invalid response."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-32007"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ExtendedAgentCardNotConfiguredError"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An authenticated extended Agent Card was requested but is not configured."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-32008"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ExtensionSupportRequiredError"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A required A2A extension is not supported by the client."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-32009"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"VersionNotSupportedError"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The requested A2A protocol version is not supported."},"children":[]}]}]}]}]}]}],"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32","description":"The JSON-RPC or A2A error code. See the table in this object's description for the full list of values and their meanings.","example":-32602},"message":{"type":"string","description":"A short human-readable description of the error.","example":"Task not found."},"data":{"type":"array","description":"Optional structured error details, following the google.rpc error detail model. Present for validation errors and other cases where the agent can supply machine-readable context.\n","items":{"$ref":"#/components/schemas/ErrorDetail"}}}}},"components/schemas/ErrorDetail":{"id":"components/schemas/ErrorDetail","kind":"json-schema","title":"ErrorDetail","data":{"type":"object","description":"A single structured error detail providing machine-readable context about a failure, following the reason/domain/metadata error model.\n","properties":{"reason":{"type":"string","description":"A short, uppercase reason code identifying the cause of the error.","example":"INVALID_PARAMS"},"domain":{"type":"string","description":"The logical domain that owns the reason code.","example":"a2a-protocol.org"},"metadata":{"type":"object","description":"Additional key-value context about the error.","example":{}}}}},"components/schemas/Role":{"id":"components/schemas/Role","kind":"json-schema","title":"Role","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The role of the message sender."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of values:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ROLE_UNSPECIFIED: The role is not specified."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ROLE_USER: The message was produced by the client (user)."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ROLE_AGENT: The message was produced by the agent."},"children":[]}]}]}]}],"example":"ROLE_USER","enum":["ROLE_UNSPECIFIED","ROLE_USER","ROLE_AGENT"],"x-enumDescriptions":{"ROLE_UNSPECIFIED":"The role is not specified.","ROLE_USER":"The message was produced by the client.","ROLE_AGENT":"The message was produced by the agent."}}},"components/schemas/Part":{"id":"components/schemas/Part","kind":"json-schema","title":"Part","data":{"type":"object","description":"One content unit of a Message or Artifact. Exactly one of text, raw, url or data is set.","properties":{"text":{"type":"string","description":"Plain-text content of the part.","example":"What's the weather in Berlin?"},"raw":{"type":"string","format":"byte","description":"Base64-encoded raw bytes of a file.","example":"SGVsbG8gd29ybGQ="},"url":{"type":"string","format":"uri","description":"URL pointing to the content of the part.","example":"https://files.cdq.com/example.pdf"},"data":{"description":"Arbitrary structured JSON value.","example":{"key":"value"}},"metadata":{"type":"object","description":"Optional metadata about the part.","example":{}},"filename":{"type":"string","description":"File name for file parts.","example":"report.pdf"},"mediaType":{"type":"string","description":"MIME type of the part content, e.g. \"text/plain\", \"application/json\", \"image/png\".","example":"text/plain"}}}},"components/schemas/Message":{"id":"components/schemas/Message","kind":"json-schema","title":"Message","data":{"type":"object","description":"A message exchanged between a client and the agent.","required":["messageId","role","parts"],"properties":{"messageId":{"type":"string","description":"Unique identifier of the message, chosen by the sender.","example":"9229e770-767c-417b-a0b0-f0741243c581"},"contextId":{"type":"string","description":"Identifier of the conversation context this message belongs to.","example":"ctx-xyz789"},"taskId":{"type":"string","description":"Identifier of the task this message relates to, if any.","example":"task-abc123"},"role":{"description":"Role of the message sender.","$ref":"#/components/schemas/Role"},"parts":{"type":"array","description":"Ordered content parts that make up the message.","items":{"$ref":"#/components/schemas/Part"}},"metadata":{"type":"object","description":"Optional metadata about the message.","example":{}},"extensions":{"type":"array","description":"URIs of A2A extensions active for this message.","items":{"type":"string","example":"https://a2a-protocol.org/ext/example/v1"}},"referenceTaskIds":{"type":"array","description":"Identifiers of tasks referenced by this message.","items":{"type":"string","example":"task-abc123"}}}}},"components/schemas/Artifact":{"id":"components/schemas/Artifact","kind":"json-schema","title":"Artifact","data":{"type":"object","description":"An output produced by the agent as part of a task.","required":["artifactId","parts"],"properties":{"artifactId":{"type":"string","description":"Unique identifier of the artifact.","example":"artifact-1"},"name":{"type":"string","description":"Human-readable name of the artifact.","example":"Onboarding data"},"description":{"type":"string","description":"Human-readable description of the artifact.","example":"Enriched business partner data for onboarding."},"parts":{"type":"array","description":"Content parts that make up the artifact.","minItems":1,"items":{"$ref":"#/components/schemas/Part"}},"metadata":{"type":"object","description":"Optional metadata about the artifact.","example":{}},"extensions":{"type":"array","description":"URIs of A2A extensions active for this artifact.","items":{"type":"string","example":"https://a2a-protocol.org/ext/example/v1"}}}}},"components/schemas/TaskState":{"id":"components/schemas/TaskState","kind":"json-schema","title":"TaskState","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The lifecycle state of a task."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of values:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"TASK_STATE_UNSPECIFIED: The state is not specified."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"TASK_STATE_SUBMITTED: The task has been submitted and is queued."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"TASK_STATE_WORKING: The task is being processed."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"TASK_STATE_COMPLETED: The task finished successfully."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"TASK_STATE_FAILED: The task terminated with an error."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"TASK_STATE_CANCELED: The task was canceled."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"TASK_STATE_INPUT_REQUIRED: The task is paused waiting for client input."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"TASK_STATE_REJECTED: The task was rejected by the agent."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"TASK_STATE_AUTH_REQUIRED: The task requires authentication to proceed."},"children":[]}]}]}]}],"example":"TASK_STATE_COMPLETED","enum":["TASK_STATE_UNSPECIFIED","TASK_STATE_SUBMITTED","TASK_STATE_WORKING","TASK_STATE_COMPLETED","TASK_STATE_FAILED","TASK_STATE_CANCELED","TASK_STATE_INPUT_REQUIRED","TASK_STATE_REJECTED","TASK_STATE_AUTH_REQUIRED"],"x-enumDescriptions":{"TASK_STATE_UNSPECIFIED":"The state is not specified.","TASK_STATE_SUBMITTED":"The task has been submitted and is queued.","TASK_STATE_WORKING":"The task is being processed.","TASK_STATE_COMPLETED":"The task finished successfully.","TASK_STATE_FAILED":"The task terminated with an error.","TASK_STATE_CANCELED":"The task was canceled.","TASK_STATE_INPUT_REQUIRED":"The task is paused waiting for client input.","TASK_STATE_REJECTED":"The task was rejected by the agent.","TASK_STATE_AUTH_REQUIRED":"The task requires authentication to proceed."}}},"components/schemas/TaskStatus":{"id":"components/schemas/TaskStatus","kind":"json-schema","title":"TaskStatus","data":{"type":"object","description":"The current status of a task, including its state and an optional status message.","required":["state"],"properties":{"state":{"description":"The current lifecycle state of the task.","$ref":"#/components/schemas/TaskState"},"message":{"description":"An optional message describing the current status.","$ref":"#/components/schemas/Message"},"timestamp":{"type":"string","description":"ISO 8601 timestamp of when this status was set.","example":"2026-10-28T14:31:20Z"}}}},"components/schemas/Task":{"id":"components/schemas/Task","kind":"json-schema","title":"Task","data":{"type":"object","description":"A unit of work processed by the agent, tracked through its lifecycle.","required":["id","status"],"properties":{"id":{"type":"string","description":"Unique identifier of the task.","example":"task-abc123"},"contextId":{"type":"string","description":"Identifier of the conversation context this task belongs to.","example":"ctx-xyz789"},"status":{"description":"The current status of the task.","$ref":"#/components/schemas/TaskStatus"},"artifacts":{"type":"array","description":"Artifacts produced by the task.","items":{"$ref":"#/components/schemas/Artifact"}},"history":{"type":"array","description":"The message history of the task.","items":{"$ref":"#/components/schemas/Message"}},"metadata":{"type":"object","description":"Optional metadata about the task.","example":{}}}}},"components/schemas/AgentCard":{"id":"components/schemas/AgentCard","kind":"json-schema","title":"AgentCard","data":{"type":"object","description":"The A2A discovery document describing an agent's endpoint, transport, capabilities and skills.","required":["protocolVersion","name","url","version","capabilities","defaultInputModes","defaultOutputModes","skills"],"properties":{"protocolVersion":{"type":"string","description":"The A2A protocol version this agent implements.","example":"1.0"},"name":{"type":"string","description":"Human-readable name of the agent.","example":"CDQ Genius"},"description":{"type":"string","description":"Human-readable description of what the agent does.","example":"CDQ's agent for business partner data enrichment, lookup and onboarding."},"url":{"type":"string","format":"uri","description":"The base URL of the agent's A2A endpoint.","example":"https://api.cdq.com/a2a/cdq-genius/"},"preferredTransport":{"type":"string","description":"The transport binding used at the endpoint URL, e.g. \"JSONRPC\".","example":"JSONRPC"},"version":{"type":"string","description":"The version of the agent.","example":"1.0"},"documentationUrl":{"type":"string","format":"uri","description":"URL to human-readable documentation for the agent.","example":"https://developer.cdq.com"},"provider":{"description":"Information about the organization providing the agent.","$ref":"#/components/schemas/AgentProvider"},"capabilities":{"description":"Optional capabilities supported by the agent.","$ref":"#/components/schemas/AgentCapabilities"},"defaultInputModes":{"type":"array","description":"Media types the agent accepts as input by default.","items":{"type":"string","example":"text/plain"}},"defaultOutputModes":{"type":"array","description":"Media types the agent produces as output by default.","items":{"type":"string","example":"text/plain"}},"skills":{"type":"array","description":"The skills the agent offers.","items":{"$ref":"#/components/schemas/AgentSkill"}}}}},"components/schemas/AgentProvider":{"id":"components/schemas/AgentProvider","kind":"json-schema","title":"AgentProvider","data":{"type":"object","description":"Information about the organization providing an agent.","required":["organization","url"],"properties":{"organization":{"type":"string","description":"Name of the providing organization.","example":"CDQ AG"},"url":{"type":"string","format":"uri","description":"URL of the providing organization.","example":"https://www.cdq.com"}}}},"components/schemas/AgentCapabilities":{"id":"components/schemas/AgentCapabilities","kind":"json-schema","title":"AgentCapabilities","data":{"type":"object","description":"The optional capabilities an agent supports.","properties":{"streaming":{"type":"boolean","description":"Whether the agent supports streaming responses.","example":false},"pushNotifications":{"type":"boolean","description":"Whether the agent supports push notifications for task updates.","example":false},"stateTransitionHistory":{"type":"boolean","description":"Whether the agent exposes task state transition history.","example":false}}}},"components/schemas/AgentSkill":{"id":"components/schemas/AgentSkill","kind":"json-schema","title":"AgentSkill","data":{"type":"object","description":"A distinct capability or function the agent can perform.","required":["id","name","description","tags"],"properties":{"id":{"type":"string","description":"Unique identifier of the skill.","example":"business-partner-onboarding"},"name":{"type":"string","description":"Human-readable name of the skill.","example":"Business Partner Onboarding"},"description":{"type":"string","description":"Human-readable description of the skill.","example":"Provides enriched reference data to onboard a business partner."},"tags":{"type":"array","description":"Keywords describing the skill's capability categories.","items":{"type":"string","example":"onboarding"}},"examples":{"type":"array","description":"Example prompts or scenarios the skill can handle.","items":{"type":"string","example":"Provide me data to help onboarding my business partner Boehringer Ingelheim GmbH."}},"inputModes":{"type":"array","description":"Media types the skill accepts, overriding the agent defaults.","items":{"type":"string","example":"text/plain"}},"outputModes":{"type":"array","description":"Media types the skill produces, overriding the agent defaults.","items":{"type":"string","example":"text/plain"}}}}},"schema_0":{"kind":"json-schema","data":{"type":"string","example":"1.0"},"id":"schema_0"},"schema_1":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/JSONRPCSuccessResponse"},{"$ref":"#/components/schemas/JSONRPCErrorResponse"}]},"id":"schema_1"}},"exampleStore":{"paths/~1/post/requestBody/content/application~1json/examples/SendMessage":{"value":{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{"messageId":"9229e770-767c-417b-a0b0-f0741243c581","role":"ROLE_USER","parts":[{"text":"Provide me data to help onboarding my business partner Name: Boehringer Ingelheim GmbH, Country: DE, City: Bieberach"}]},"metadata":{}}},"key":"SendMessage","summary":"SendMessage — send a message to the agent","id":"paths/~1/post/requestBody/content/application~1json/examples/SendMessage"},"paths/~1/post/requestBody/content/application~1json/examples/GetTask":{"value":{"jsonrpc":"2.0","id":2,"method":"GetTask","params":{"id":"task-abc123","historyLength":10}},"key":"GetTask","summary":"GetTask — read the current state of a task","id":"paths/~1/post/requestBody/content/application~1json/examples/GetTask"},"paths/~1/post/requestBody/content/application~1json/examples/CancelTask":{"value":{"jsonrpc":"2.0","id":3,"method":"CancelTask","params":{"id":"task-abc123"}},"key":"CancelTask","summary":"CancelTask — request cancellation of a task","id":"paths/~1/post/requestBody/content/application~1json/examples/CancelTask"},"paths/~1/post/responses/200/content/application~1json/examples/taskCompleted":{"value":{"jsonrpc":"2.0","id":1,"result":{"id":"task-abc123","contextId":"ctx-xyz789","status":{"state":"TASK_STATE_COMPLETED","timestamp":"2026-08-26T10:00:00Z"},"artifacts":[{"artifactId":"artifact-1","name":"Onboarding data","parts":[{"text":"Boehringer Ingelheim GmbH, Birkendorfer Str. 65, 88397 Biberach an der Riss, DE."}]}]}},"key":"taskCompleted","summary":"Success — task completed with an artifact","id":"paths/~1/post/responses/200/content/application~1json/examples/taskCompleted"},"paths/~1/post/responses/200/content/application~1json/examples/invalidParams":{"value":{"jsonrpc":"2.0","id":1,"error":{"code":-32602,"message":"Invalid request content: ...","data":[{"reason":"INVALID_PARAMS","domain":"a2a-protocol.org","metadata":{}}]}},"key":"invalidParams","summary":"Error — invalid request content (e.g. bad enum value)","id":"paths/~1/post/responses/200/content/application~1json/examples/invalidParams"},"paths/~1/post/responses/200/content/application~1json/examples/taskNotFound":{"value":{"jsonrpc":"2.0","id":2,"error":{"code":-32001,"message":"Task not found."}},"key":"taskNotFound","summary":"Error — task not found","id":"paths/~1/post/responses/200/content/application~1json/examples/taskNotFound"}},"securitySchemeStore":{"apiKey":{"id":"apiKey","type":"apiKey","in":"header","paramName":"X-API-KEY"}},"servers":[{"url":"https://api.cdq.com/a2a/cdq-genius","description":"CDQ Genius A2A base URL. The Agent Card is served at /.well-known/agent-card.json and all JSON-RPC operations are POSTed to /."}],"specType":"openapi"},"options":{"hideDownloadButtons":false,"codeSamples":{"languages":[]},"feedback":{"type":"sentiment","settings":{"label":"Share the feedback!","submitText":"Thank you for sharing!","reasons":{"component":"checkbox","label":"Tell us more about your experience.","items":["Content covered the topic well.","The content has great examples.","The content is thoroughly detailed.","The content is easy to understand."]},"comment":{"likeLabel":"What was most helpful?","dislikeLabel":"What can we improve?"}}},"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/apis/genius-a2a/@genius-a2a-v1/api-v1.json?download"},{"url":"/_bundle/apis/genius-a2a/@genius-a2a-v1/api-v1.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"CDQ Genius - A2A (JSON-RPC 2.0) API","description":"This document describes **CDQ Genius**'s Agent2Agent (A2A) protocol\nJSON-RPC 2.0 binding, per the [A2A 1.0 specification, §9](https://a2a-protocol.org/latest/specification/#9-json-rpc-protocol-binding).\n\n### How the transport works\nThe A2A JSON-RPC binding exposes **one physical HTTP endpoint**. Every\noperation is a `POST` of a JSON-RPC 2.0 envelope to the base URL, and the\nserver dispatches on the envelope's `method` field:\n\n```\nPOST https://api.cdq.com/a2a/cdq-genius/\nContent-Type: application/json\nA2A-Version: 1.0\nX-API-KEY: {YOUR_API_KEY}\n```\n\nSupported methods are shown as selectable request examples on the\n`POST /` operation below (`SendMessage`, `GetTask`, `CancelTask`).\n\nThe [Agent Card](https://api.cdq.com/a2a/cdq-genius/.well-known/agent-card.json)\n(served by the `GET` operation below) is the authoritative source for the\nendpoint URL, transport, and capabilities.\n"}},"baseSlug":"/apis/genius-a2a/api-v1","routesMapping":{}}