API Changes – Version 13.1

Added

None.

Changed

None.

Deprecated

• POST /v1/chat/prompt-http Please use the general agent endpoints instead. Full documentation of the Agent API is available at /agents/docs.

  General Purpose Agent – Send Message

  The recommended replacement is the POST /agents/general-purpose/message:send endpoint (A2A protocol v1.0).

  Endpoints:

  A2A JSON-RPC: POST https://aissist-backend.bv.burda.com/agents/general-purpose/

  REST: POST https://aissist-backend.bv.burda.com/agents/general-purpose/message:send

  Required headers:

  • Authorization: Bearer <JWT_TOKEN>
  • A2A-Version: 1.0

  Minimal request body (required fields only):

  A2A JSON-RPC

  {
    "jsonrpc": "2.0",
    "id": "1",
    "method": "SendMessage",
    "params": {
      "message": {
        "message_id": "message_id",
        "role": "ROLE_USER",
        "parts": [
          {
            "text": "Your message to the agent (Optional)"
          }
        ]
      },
      "metadata": {
        "templateId": "my-template-id"
      }
    }
  }

  REST

  {
    "message": {
      "message_id": "message_id",
      "role": "ROLE_USER",
      "parts": [
        {
          "text": "Your message to the agent (Optional)"
        }
      ]
    },
    "metadata": {
      "templateId": "my-template-id"
    }
  }

  Full example with template and inputs:

  A2A JSON-RPC

  {
    "jsonrpc": "2.0",
    "id": "1",
    "method": "SendMessage",
    "params": {
      "message": {
        "message_id": "message_id",
        "role": "ROLE_USER",
        "parts": [
          {
            "text": "Your message to the agent (Optional)"
          }
        ]
      },
      "metadata": {
        "templateId": "my-template-id",
        "inputs": [
          {
            "name": "topic",
            "value": "Kubernetes"
          },
          {
            "name": "languages",
            "value": ["Python", "Go"]
          }
        ]
      }
    }
  }

  REST

  {
    "message": {
      "message_id": "message_id",
      "role": "ROLE_USER",
      "parts": [
        {
          "text": "Your message to the agent (Optional)"
        }
      ]
    },
    "metadata": {
      "templateId": "my-template-id",
      "inputs": [
        {
          "name": "topic",
          "value": "Kubernetes"
        },
        {
          "name": "languages",
          "value": ["Python", "Go"]
        }
      ]
    }
  }

  Note: When templateId is set, the text in parts can be empty – the agent will then use the prompt template as the basis.

  Key fields:

  Field	Description	Example
  message.message_id	Unique message ID	"msg-uuid-123"
  message.context_id	Optional context/session ID for multi-turn conversations	"ctx-uuid-456"
  message.role	Role of the sender	"user"
  message.parts	Message content – at least one text part	[{"text": "Hello"}]
  params.metadata.templateId	ID of the prompt template	"my-template-id"
  params.metadata.inputs	Template inputs as name/value array (optional)	[{"name": "topic", "value": "AI"}]

  Migration from prompt-http – field mapping:

  Old field (PromptRequestSchema)	New field (SendMessageRequest)	Notes
  template_id	params.metadata.templateId	Template ID is passed as metadata
  inputs (array with name/value)	params.metadata.inputs	Inputs are passed as an array of name/value objects in the metadata

  For streaming, POST https://aissist-backend.bv.burda.com/agents/general-purpose/message:stream is available as an alternative (Server-Sent Events).

Removed

None.