COconstructor
Agent to agent

Send a product-discovery message

🔐 This endpoint requires HTTP Bearer authentication.

Send one blocking A2A 1.0 SendMessage turn to a configured AI Shopping Agent domain. This endpoint uses the same per-domain A2A opt-in as the public agent card and requires a Constructor bearer token authorized for the company that owns the requested index key. Reuse the same contextId for later turns in the same conversation. The response is a terminal A2A task containing text/plain parts and, when accepted by the caller, application/json structured event parts. Streaming, push notifications, deferred execution, and task-management methods are not supported.

post/v1/a2a/{key}/{domain}

Request

  • Base URL
    https://agent.cnstrc.com
  • URL
    https://agent.cnstrc.com/v1/a2a/{key}/{domain}
  • Auth
    HTTP bearer

Path parameters

keystring required

The key of the index to use.

domainstring required

The domain specifying a set of specific instructions for processing the intent, e.g., 'recipes', 'sportsgear'.

Headers

A2A-Version'1.0' required
Example:1.0

The A2A protocol version used by the request.

Request body

jsonrpc'2.0' required

JSON-RPC protocol version.

method'SendMessage' required

JSON-RPC method name for a blocking A2A message turn.

Example request

{
  "jsonrpc": "2.0",
  "id": "request-1",
  "method": "SendMessage",
  "params": {
    "message": {
      "messageId": "message-1",
      "contextId": "shopping-conversation-42",
      "role": "ROLE_USER",
      "parts": [
        {
          "text": "Waterproof walking boots for wide feet, size 7"
        }
      ]
    },
    "configuration": {
      "acceptedOutputModes": [
        "text/plain",
        "application/json"
      ]
    }
  }
}

Response

A JSON-RPC success or protocol-error response. Successful calls return a terminal A2A task.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.