Send a message to an agent (A2A, non-streaming)
A2A-compliant message send. The body follows the A2A flat
MessageSendParams shape - a message envelope with
message_id, role, parts[], and an optional contextId.
Parts are discriminated by field presence: TextPart (text),
FilePart (url or raw), DataPart (data).
An always-on rate-limit floor (200/h per user) applies, plus any
agent-configured limit. The HITL approval flow is supported and
will park the task in input-required until resolved through
/v1/agents/{agentId}/tasks/{taskId}/resolve.
Send the x-draft-mode: true header to bypass published_config
resolution and exercise live (draft) configuration - owners and
agent-factory writers only.
Authorizations
User-bound credential carrying an identity: either a session JWT
or a user access token (at:*) generated from the user settings UI.
Send as Authorization: Bearer <token>.
Org API keys (iak_*) are not accepted here - they carry
no user identity. Use the x-prismeai-api-key header instead
(see OrgApiKeyAuth).
Headers
When true, the call exercises the agent's live (draft) config
instead of published_config. Reserved for owners/writers.
Path Parameters
64Body
A2A v0.3 flat message envelope.