Assistant

Rename a conversation

Sets the name the conversation is listed by. A name given before the first message is kept.

patch/v1/assistant/sessions/{session_id}

Request

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

Request body

namestring required

Trimmed before it is stored.

Example request

{
  "name": "Relatório diário"
}

Response

The renamed 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.