Sessions

Add a user message

Saves a user message to the session. When auto_generate is enabled on the session and no generation is currently in progress, generation is triggered automatically and the response is the generated turn, the same body ?wait=true generate answers. Otherwise returns the saved user message.

post/v1/projects/{project_id}/sessions/{session_id}/messages

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/sessions/{session_id}/messages
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Path parameters

session_idstring required
Example:sess_V1StGXR8Z5jdHi6B

Session public ID

Headers

Idempotency-Keystring

The request's deduplication key. Equivalent to idempotency_key in the request body; sending both with different values is 400 VALIDATION_FAILED. A non-empty string of at most 255 characters.

Request body

OR

Example request

{
  "message": "Hello, how can I deploy my app?",
  "idempotency_key": "wamid.HBgLNTUxMTk4..."
}

Response

Duplicate request — original message returned (idempotency_key matched)

role'user'
contentstring
document_idstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.