Conversations

Update a conversation

Updates the status of a conversation

patch/v1/projects/{project_id}/conversations/{conversation_id}

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/conversations/{conversation_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)

Path parameters

conversation_idstring required
Example:conv_V1StGXR8Z5jdHi6B

Conversation ID

Request body

status'open' | 'closed'

New conversation status

namestring nullable

New conversation name

retrieval'embed' | 'none' | 'null' nullable

Whether this conversation's turns are embedded for vector retrieval. Turns are stored and chunked either way, so none leaves them readable and reachable by full-text search without paying for an embedding. null (the default) inherits the project's default_conversation_retrieval. Switching it on embeds the turns already in the conversation, so the whole conversation becomes retrievable rather than only what is said next.

Response

Conversation updated

idstring

Conversation ID

project_idstring

Project ID

namestring nullable

Optional human-readable name for the conversation.

status'open' | 'closed'

Conversation status

created_atstring date-time

Creation timestamp

updated_atstring date-time

Last update timestamp

actor_idstring nullable

Actor ID associated with this conversation

retrieval'embed' | 'none' | 'null' nullable

Whether this conversation's turns are embedded for vector retrieval. Turns are stored and chunked either way, so none leaves them readable and reachable by full-text search without paying for an embedding. null (the default) inherits the project's default_conversation_retrieval.

Example response

{
  "id": "conv_V1StGXR8Z5jdHi6B",
  "project_id": "proj_V1StGXR8Z5jdHi6B",
  "status": "open",
  "actor_id": "actor_V1StGXR8Z5jdHi6B"
}

Changes

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