Skip to main content
POST
Send Message

Authorizations

Authorization
string
header
required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing, malformed, unknown, revoked, inactive or expired key returns 401; a key without the permission, scope or plan an operation needs returns 403.

X-Namespace
string
header
required

Namespace id (ns_...), not the namespace name. This scopes the request rather than authenticating it, and it is required on every operation marked x-mixpeek-namespace-scoped.

Path Parameters

session_id
string
required

Session ID

Body

application/json

Keys this body does not declare are ignored, and the response's warnings name them, until 2026-11-02; from 2026-11-02 they are refused with 422 extra_forbidden naming the accepted keys.

Request payload for sending a message to the agent.

Attributes: content: Message text content metadata: Optional message metadata stream: Whether to stream response as SSE (default: True)

Note: When stream=True, the response will be Server-Sent Events (SSE). When stream=False, the response will be a MessageResponse object.

Example: ```python # Streaming request (SSE) request = SendMessageRequest( content="Find videos about machine learning", stream=True )

content
string
required

Message text content (REQUIRED)

Minimum string length: 1
metadata
Metadata · object

Message metadata (OPTIONAL)

stream
boolean
default:true

Stream response as SSE (default: True)

Response

Successful Response