Send a chat message | Astro AI

Sends a user message to the agent. attachments contains ready Files API keys owned by the caller; file bytes are never inlined. The sidecar reloads authoritative metadata, persists the user turn, then forwards it to the agent. The assistant reply streams over the SSE endpoint and is persisted as it arrives. Subscribe to the stream endpoint for live chunks. A conversation owned by another user returns 404.

Sends a user message to the agent. `attachments` contains ready Files API keys owned by the caller; file bytes are never inlined. The sidecar reloads authoritative metadata, persists the user turn, then forwards it to the agent. The assistant reply streams over the SSE endpoint and is persisted as it arrives. Subscribe to the stream endpoint for live chunks. A conversation owned by another user returns 404.

Authentication

AuthorizationBearer

OAuth 2.0 device flow or platform session token

Path parameters

deploymentIdstringRequired

Deployment ID

conversationIdstringRequired

Conversation ID (client-chosen UUID v4)

Request

This endpoint expects an object.

contentstringOptional

The user's message text.

attachmentslist of objectsOptional

Ready Files API keys owned by the caller. File bytes are not inlined.

Response

Message accepted (reply streams over the SSE endpoint)

message_idstring

timestampdatetime

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

413

Content Too Large Error

500

Internal Server Error

$	curl -X POST https://astropods.com/api/v1/deployments/deploymentId/messaging/conversations/conversationId/messages \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'