Skip to main content
PATCH
/
api
/
v1
/
memories
/
conversation-meta
Update Conversation Metadata
curl --request PATCH \
  --url https://api.evermind.ai/api/v1/memories/conversation-meta \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "group_id": "group_123",
  "name": "New Conversation Name",
  "description": "Updated description",
  "scene_desc": {
    "description": "Project discussion group chat"
  },
  "tags": [
    "tag1",
    "tag2"
  ],
  "user_details": {
    "user_001": {
      "custom_role": "lead",
      "full_name": "John Smith",
      "role": "user"
    }
  },
  "default_timezone": "Asia/Shanghai"
}
'
{
  "message": "Conversation metadata updated successfully, updated 2 fields",
  "result": {
    "group_id": "group_123",
    "id": "507f1f77bcf86cd799439011",
    "name": "New conversation name",
    "scene": "group_chat",
    "updated_at": "2025-01-15T10:30:00+00:00",
    "updated_fields": [
      "name",
      "tags"
    ]
  },
  "status": "ok"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Partial update conversation metadata request body

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

​
group_id
string | null

Group ID to update. When null, updates the default config.

Example:

"group_123"

​
name
string | null

New conversation name

Example:

"New Conversation Name"

​
description
string | null

New conversation description

Example:

"Updated description"

​
scene_desc
Scene Desc · object

New scene description

Example:
{
  "description": "Project discussion group chat"
}
​
tags
string[] | null

New tag list

Example:
["tag1", "tag2"]
​
user_details
User Details · object

New user details (will completely replace existing user_details)

Example:
{
  "user_001": {
    "custom_role": "lead",
    "full_name": "John Smith",
    "role": "user"
  }
}
​
default_timezone
string | null

New default timezone

Example:

"Asia/Shanghai"

Response

Successful Response

Patch conversation metadata API response

Response for PATCH /api/v1/memories/conversation-meta endpoint.

​
result
PatchConversationMetaResult · object
required

Patch result with updated fields

Example:
{
  "group_id": "group_123",
  "id": "507f1f77bcf86cd799439011",
  "name": "New conversation name",
  "scene": "group_chat",
  "updated_at": "2025-01-15T10:30:00+00:00",
  "updated_fields": ["name", "tags"]
}
​
status
string
default:ok

Response status

Examples:

"ok"

"failed"

​
message
string
default:""

Response message

Example:

"Operation successful"