Skip to main content
POST
/
api
/
v1
/
memories
/
conversation-meta
Set conversation metadata
curl --request POST \
  --url https://api.evermind.ai/api/v1/memories/conversation-meta \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "version": "<string>",
  "scene": "<string>",
  "scene_desc": {},
  "name": "<string>",
  "created_at": "<string>",
  "description": "Technical discussion for new feature development",
  "group_id": "group_123",
  "default_timezone": "UTC",
  "user_details": {
    "bot_001": {
      "custom_role": "assistant",
      "extra": {
        "type": "ai"
      },
      "full_name": "AI Assistant",
      "role": "assistant"
    },
    "user_001": {
      "custom_role": "developer",
      "extra": {
        "department": "Engineering"
      },
      "full_name": "John Smith",
      "role": "user"
    }
  },
  "tags": [
    "work",
    "technical"
  ]
}
'
{
  "message": "Conversation metadata saved successfully",
  "result": {
    "conversation_created_at": "2025-01-15T10:00:00+00:00",
    "group_id": "group_123",
    "id": "507f1f77bcf86cd799439011",
    "is_default": false,
    "name": "Project Discussion",
    "scene": "group_chat",
    "scene_desc": {
      "description": "Project discussion group chat"
    },
    "version": "1.0"
  },
  "status": "ok"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Create 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 description

Example:
{
  "description": "Project discussion group chat",
  "type": "project_discussion"
}
​
name
string
required

Conversation name

Example:

"Project Discussion Group"

​
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"

​
group_id
string | null

Group unique identifier. When null/not provided, represents default settings for this scene.

Example:

"group_123"

​
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:
{
  "bot_001": {
    "custom_role": "assistant",
    "extra": { "type": "ai" },
    "full_name": "AI Assistant",
    "role": "assistant"
  },
  "user_001": {
    "custom_role": "developer",
    "extra": { "department": "Engineering" },
    "full_name": "John Smith",
    "role": "user"
  }
}
​
tags
string[] | null

Tag list

Example:
["work", "technical"]

Response

Successful Response

Save conversation metadata API response

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

​
result
ConversationMetaResponse · object
required

Saved conversation metadata

Example:
{
  "conversation_created_at": "2025-01-15T10:00:00+00:00",
  "created_at": "2025-01-15T10:00:00+00:00",
  "default_timezone": "UTC",
  "description": "Technical discussion group",
  "group_id": "group_123",
  "id": "507f1f77bcf86cd799439011",
  "is_default": false,
  "name": "Project Discussion",
  "scene": "group_chat",
  "scene_desc": {
    "description": "Project discussion group chat"
  },
  "tags": ["work", "tech"],
  "updated_at": "2025-01-15T10:00:00+00:00",
  "user_details": {
    "bot_001": {
      "full_name": "AI Assistant",
      "role": "assistant"
    },
    "user_001": {
      "custom_role": "developer",
      "full_name": "John",
      "role": "user"
    }
  },
  "version": "1.0"
}
​
status
string
default:ok

Response status

Examples:

"ok"

"failed"

​
message
string
default:""

Response message

Example:

"Operation successful"