latestOpenAPI 3.0.02026-08-161996601.3 MB

83554494d7f8

A2A Protocol15

Agent Aliases20

Agent Analytics4

Agent Connectors5

Agent End User Sessions6

Agent Identity2

Agent Schedules6

Agent Secrets3

Agent Sessions15

Agents6

API Keys5

Application Clients5

Authentication1

Chats9

Corpora9

CustomerMetrics2

Documents7

Encoders2

Factual Consistency Evaluation1

Generation Presets4

Glossaries8

Hallucination Correctors2

Index3

Instructions7

Jobs2

Large Language Models5

LLM Chat Completions1

Metadata Query1

Pipeline Dead Letters5

Pipeline Runs4

Pipelines7

Queries3

Query History2

Rerankers1

Table Extractors1

Tool Servers6

Tools7

Upload1

Users6

A2A Protocol

Send A2A v0.3 message

Sends a message to the agent. Blocks until the agent reaches a terminal or interrupted state. Returns the resulting task, or a direct message reply for stateless interactions.

To continue an existing conversation, set message.contextId to the prior task's id.

A message that opens a new session is subject to the agent's run_condition. When it evaluates to false no session is created and the call returns an InvalidRequestError.

post/v2/agents/{agent_key}/v1/message:send

Path parameters

agent_keystring required

A unique key that identifies an agent.

Example:customer_support

The unique key of the agent to interact with.

Headers

Request-Timeoutinteger

The platform makes a best effort to complete the request in the specified seconds, or it times out.

Request-Timeout-Millisinteger

The platform makes a best effort to complete the request in the specified milliseconds, or it times out.

Request body

metadataobject nullable

Arbitrary client-supplied metadata for the request.

Response

The send-message response — exactly one of task or message.