v1

latestOpenAPI 3.1.02026-07-173045128.2 KB
profile

Get User Profile

Get the real-time user profiles for long term memory

get/api/v1/users/profile/{user_id}

Path parameters

string uuid4 required
OR
string uuid5 required

The ID of the user to get profiles for

Query parameters

topkinteger

Number of profiles to retrieve, default is all

Number of profiles to retrieve, default is all

max_token_sizeinteger

Max token size of returned profile content, default is all

Max token size of returned profile content, default is all

prefer_topicsstring[]

Rank prefer topics at first to try to keep them in filtering, default order is by updated time

Rank prefer topics at first to try to keep them in filtering, default order is by updated time

only_topicsstring[]

Only return profiles with these topics, default is all

Only return profiles with these topics, default is all

max_subtopic_sizeinteger

Max subtopic size of the same topic in returned profile, default is all

Max subtopic size of the same topic in returned profile, default is all

topic_limits_jsonstring

Set specific subtopic limits for topics in JSON, for example {"topic1": 3, "topic2": 5}. The limits in this param will override max_subtopic_size.

Set specific subtopic limits for topics in JSON, for example {"topic1": 3, "topic2": 5}. The limits in this param will override max_subtopic_size.

chats_strstring

List of chats in OpenAI Message format, for example: [{"role": "user", "content": "Hello"}, {"role": "assistant", "content": "Hi"}]

List of chats in OpenAI Message format, for example: [{"role": "user", "content": "Hello"}, {"role": "assistant", "content": "Hi"}]

Response

Successful Response

errno0 | 400 | 401 | 403 | 404 | 405 | 409 | 422 | 500 | 501 | 502 | 503 | 504 | 520
errmsgstring

Error message, empty when success