Skip to main content
POST
/
api
/
v1
/
memories
/
conversation-meta
Save conversation metadata
curl --request POST \
  --url https://api.example.com/api/v1/memories/conversation-meta \
  --header 'Content-Type: application/json' \
  --data '
{
  "created_at": "2025-01-15T10:00:00+00:00",
  "default_timezone": "UTC",
  "description": "Technical discussion for new feature development",
  "group_id": "group_123",
  "name": "Project Discussion Group",
  "scene": "group_chat",
  "scene_desc": {
    "bot_ids": [
      "bot_001"
    ],
    "type": "project_discussion"
  },
  "tags": [
    "work",
    "technical"
  ],
  "user_details": {
    "user_001": {
      "extra": {
        "department": "Engineering"
      },
      "full_name": "John Smith",
      "role": "developer"
    }
  },
  "version": "1.0"
}
'
{}

Body

application/json

Save conversation metadata request body

Used for POST /api/v1/memories/conversation-meta endpoint

​
version
string
required

Metadata version number

Example:

"1.0"

​
scene
string
required

Scene identifier, enum values from ScenarioType:

  • group_chat: work/group chat scenario, suitable for group conversations such as multi-person collaboration and project discussions
  • assistant: assistant scenario, suitable for one-on-one AI assistant conversations
Example:

"group_chat"

​
scene_desc
Scene Desc · object
required

Scene description object, can include fields like bot_ids

Example:
{
  "bot_ids": ["bot_001"],
  "type": "project_discussion"
}
​
name
string
required

Conversation name

Example:

"Project Discussion Group"

​
group_id
string
required

Group unique identifier

Example:

"group_123"

​
created_at
string
required

Conversation creation time (ISO 8601 format)

Example:

"2025-01-15T10:00:00+00:00"

​
description
string | null

Conversation description

Example:

"Technical discussion for new feature development"

​
default_timezone
string | null

Default timezone

Example:

"UTC"

​
user_details
User Details · object

Participant details, key is user ID, value is user detail object

Example:
{
  "user_001": {
    "extra": { "department": "Engineering" },
    "full_name": "John Smith",
    "role": "developer"
  },
  "user_002": {
    "extra": { "department": "Design" },
    "full_name": "Jane Doe",
    "role": "designer"
  }
}
​
tags
string[] | null

Tag list

Example:
["work", "technical"]

Response

Successful Response

The response is of type Response Save Conversation Meta Api V1 Memories Conversation Meta Post · object.