Conversation

Get Shared Conversation Details

get

Fetch the active share-link details for a conversation without mutating anything.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Path parameters

conversation_idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/conversations/{conversation_id}/share

HTTPcURLJavaScriptPython

GET /conversations/{conversation_id}/share HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "shared_conversation_id": "text",
  "last_updated_time": "2026-01-14T02:42:07.045Z",
  "expired_time": "2026-01-14T02:42:07.045Z"
}

Create Or Update Shared Conversation

post

Create a shareable link for a conversation with optional expiry days.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Path parameters

conversation_idstringRequired

Body

application/x-www-form-urlencoded

expiry_daysany ofOptional

integerOptional

or

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/conversations/{conversation_id}/share

HTTPcURLJavaScriptPython

POST /conversations/{conversation_id}/share HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 17

"expiry_days=1"

{
  "shared_conversation_id": "text",
  "last_updated_time": "2026-01-14T02:42:07.045Z",
  "expired_time": "2026-01-14T02:42:07.045Z"
}

Get Shared Conversation

get

Get a shared conversation by its share ID, including all messages and attachments.

Path parameters

shared_conversation_idstringRequired

Header parameters

Accept-LanguagestringOptionalDefault: en

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/conversations/shared/{shared_conversation_id}

HTTPcURLJavaScriptPython

GET /conversations/shared/{shared_conversation_id} HTTP/1.1
Host: 
Accept: */*

{
  "messages": [
    {
      "id": "text",
      "conversation_id": "text",
      "role": "user",
      "content": "text",
      "deanonymized_content": "text",
      "created_time": "2026-01-14T02:42:07.045Z",
      "is_active": true,
      "parent_id": "text",
      "source": "text",
      "feedback": "text",
      "metadata_": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "conversation": {
    "id": "text",
    "user_id": "text",
    "title": "text",
    "created_time": "2026-01-14T02:42:07.045Z",
    "updated_time": "2026-01-14T02:42:07.045Z",
    "is_active": true,
    "is_anonymized": true,
    "chatbot_id": "text",
    "deanonymized_mapping": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "first_matching_message_id": "text",
    "first_matching_message": "text",
    "metadata_": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  },
  "last_updated_time": "2026-01-14T02:42:07.045Z",
  "expired_time": "2026-01-14T02:42:07.045Z",
  "attachments": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "chatbot": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Delete Shared Conversation

delete

Delete a shared conversation by its share ID.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Path parameters

shared_conversation_idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

delete

/conversations/shared/{shared_conversation_id}

HTTPcURLJavaScriptPython

DELETE /conversations/shared/{shared_conversation_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "ANY_ADDITIONAL_PROPERTY": "text"
}

Get All Shared Conversations

get

Get all shared conversations of current user.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Query parameters

queryany ofOptional

Search query for conversation title

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/conversations/shared

HTTPcURLJavaScriptPython

GET /conversations/shared HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "ANY_ADDITIONAL_PROPERTY": [
    {
      "id": "text",
      "user_id": "text",
      "conversation_id": "text",
      "conversation_title": "text",
      "created_time": "2026-01-14T02:42:07.045Z",
      "last_updated_time": "2026-01-14T02:42:07.045Z",
      "expired_time": "2026-01-14T02:42:07.045Z",
      "first_matching_word": "text",
      "is_active": true,
      "mind_map": "text"
    }
  ]
}

Clone Shared Conversation

post

Clone a shared conversation to a new conversation.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Path parameters

shared_conversation_idstringRequired

Body

application/x-www-form-urlencoded

user_idstringRequired

new_conversation_idany ofOptional

stringOptional

or

nullOptional

old_parent_idstringRequired

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

post

/conversations/shared/{shared_conversation_id}/clone

HTTPcURLJavaScriptPython

POST /conversations/shared/{shared_conversation_id}/clone HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 70

"user_id='text'&new_conversation_id='text'&old_parent_id='text'"

No content

Get All Conversations

get

Get all conversations of current user, optionally filtered by a search query and chatbot_id.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Query parameters

querystringOptional

Search query for conversation title or message content

Default: ""

chatbot_idstringOptional

Chatbot id for conversation

cursorany ofOptional

Pointer to keep track of the last fetched conversations

stringOptional

or

nullOptional

limitany ofOptional

Number of conversations to return per request

integerOptional

or

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/conversations

HTTPcURLJavaScriptPython

GET /conversations HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "conversations": [
    {
      "id": "text",
      "user_id": "text",
      "title": "text",
      "created_time": "2026-01-14T02:42:07.045Z",
      "updated_time": "2026-01-14T02:42:07.045Z",
      "is_active": true,
      "is_anonymized": true,
      "chatbot_id": "text",
      "deanonymized_mapping": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "first_matching_message_id": "text",
      "first_matching_message": "text",
      "metadata_": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "cursor": "text",
  "conversations_count": 1
}

Create Conversation

post

Create a new conversation with optional title.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Body

application/x-www-form-urlencoded

user_idstringRequired

titleany ofOptional

stringOptional

or

nullOptional

model_namestringOptionalDefault: openai/gpt-4o-mini

chatbot_idstringRequired

metadata_any ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/conversations

HTTPcURLJavaScriptPython

POST /conversations HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 106

"user_id='text'&title='text'&model_name='openai/gpt-4o-mini'&chatbot_id='text'&metadata_='text'"

{
  "conversation": {
    "id": "text",
    "user_id": "text",
    "title": "text",
    "created_time": "2026-01-14T02:42:07.045Z",
    "updated_time": "2026-01-14T02:42:07.045Z",
    "is_active": true,
    "is_anonymized": true,
    "chatbot_id": "text",
    "deanonymized_mapping": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "first_matching_message_id": "text",
    "first_matching_message": "text",
    "metadata_": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  }
}

Get Conversation Messages

get

Get messages from a specific conversation with optional limit and date filtering.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Path parameters

conversation_idstringRequired

Query parameters

limitany ofOptional

integerOptional

or

nullOptional

max_dateany ofOptional

stringOptional

or

nullOptional

Header parameters

Accept-LanguagestringOptionalDefault: en

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/conversations/{conversation_id}

HTTPcURLJavaScriptPython

GET /conversations/{conversation_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "conversation": {
    "id": "text",
    "user_id": "text",
    "title": "text",
    "created_time": "2026-01-14T02:42:07.045Z",
    "updated_time": "2026-01-14T02:42:07.045Z",
    "is_active": true,
    "is_anonymized": true,
    "chatbot_id": "text",
    "deanonymized_mapping": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "first_matching_message_id": "text",
    "first_matching_message": "text",
    "metadata_": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  },
  "messages": [
    {
      "id": "text",
      "conversation_id": "text",
      "role": "user",
      "content": "text",
      "deanonymized_content": "text",
      "created_time": "2026-01-14T02:42:07.045Z",
      "is_active": true,
      "parent_id": "text",
      "source": "text",
      "feedback": "text",
      "metadata_": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "attachments": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ]
}

Delete Conversation

delete

Delete a specific conversation by ID and remove any associated attachments and vector DB documents.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Path parameters

conversation_idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

delete

/conversations/{conversation_id}

HTTPcURLJavaScriptPython

DELETE /conversations/{conversation_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Rename Conversation

patch

Rename an existing conversation with a new title.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Path parameters

conversation_idstringRequired

Body

application/x-www-form-urlencoded

titlestringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

patch

/conversations/{conversation_id}

HTTPcURLJavaScriptPython

PATCH /conversations/{conversation_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 16

"title='text'"

{
  "conversation": {
    "id": "text",
    "user_id": "text",
    "title": "text",
    "created_time": "2026-01-14T02:42:07.045Z",
    "updated_time": "2026-01-14T02:42:07.045Z",
    "is_active": true,
    "is_anonymized": true,
    "chatbot_id": "text",
    "deanonymized_mapping": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "first_matching_message_id": "text",
    "first_matching_message": "text",
    "metadata_": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  }
}

Delete Conversations

post

Delete multiple conversations matching the specified criteria, including user_id, chatbot_id and optional conversation_ids.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Body

application/json

Request model for deleting conversations.

user_idstringRequired

chatbot_idstringRequired

conversation_idsany ofOptional

string[]Optional

or

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/conversations/delete

HTTPcURLJavaScriptPython

POST /conversations/delete HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 66

{
  "user_id": "text",
  "chatbot_id": "text",
  "conversation_ids": [
    "text"
  ]
}

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Generate Conversation Title

post

Generate a title for an existing conversation based on its content.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Path parameters

conversation_idstringRequired

Body

multipart/form-data

messagestringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/conversations/{conversation_id}/generate-title

HTTPcURLJavaScriptPython

POST /conversations/{conversation_id}/generate-title HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 18

{
  "message": "text"
}

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}