Assistant

Start a conversation

Opens a new, empty conversation with the Assistant. It costs nothing until a message is sent, and it does not expire.

post/v1/assistant/sessions

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/assistant/sessions
  • 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)

Response

The new session.

idstring required
namestring nullable required

The name given to the conversation, else its first message cut to 60 characters; null until either.

status'open' | 'closed' | 'expired' required

Only an open session takes messages.

created_atstring date-time required
last_activity_atstring date-time nullable required

When the session last took a message; null until the first.

Example response

{
  "id": "sess_V1StGXR8Z5jdHi6B",
  "name": "liste quantos agentes eu tenho no projeto sandbox",
  "status": "open",
  "created_at": "2026-10-07T12:00:00.000Z",
  "last_activity_at": "2026-10-07T12:05:00.000Z"
}

Changes

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