Conversation

Find turns in a one-on-one AI conversation by keyword, date, media type, and/or Human/AI side.

Search the signed-in user's one-on-one conversation with one AI consciousness. Combine an optional keyword with optional media types, unix date bounds, and optional side (user / assistant / both). Page with cursor_value + cursor_id. Use a hit id with get_chat_around to jump the dialogue UI.

post/v1/search_chats

Request

  • Base URL: https://partner.mindupload.app
  • URL: https://partner.mindupload.app/v1/search_chats
  • Auth: API key in header X-Partner-Key

Request body

preferred_languagestring nullable

BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages.

usernamestring required

The end-user's username.

passwordstring required

The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage.

clone_idstring required

Owner AI consciousness id from get_clones (required for one-on-one find).

keywordstring nullable

Optional find query. Whole-word tokens across alphabetic and numeric scripts; character phrases for Chinese / Japanese / Korean; mixed language supported.

content_media_typesstring[] nullable

Optional list of media kinds to match: image, video, and/or audio.

created_afterinteger nullable

Optional lower bound on message time as a UNIX timestamp in seconds.

created_beforeinteger nullable

Optional upper bound on message time as a UNIX timestamp in seconds.

sort_order-1 | 1 nullable

Turn send-time order: -1 newest first (default), 1 oldest first.

side'user' | 'assistant' | 'both' nullable

Optional 1v1 side filter: user (human), assistant (AI), or both (turns that include both sides).

page_sizeinteger

Maximum Find hits for one page.

cursor_valuenumber nullable required

Opaque pagination cursor value from the previous page (next_cursor_value).

cursor_idstring nullable required

Opaque pagination cursor id from the previous page (next_cursor_id).

Response

Result envelope — check the success field.

successboolean

Whether the call succeeded.

error_messagestring nullable

Human-readable reason when success is false.

error_codestring
chatsobject[] nullable

One-on-one turns returned by this operation.

media_thumbnailsobject nullable

Mapping from an external media URL in a result to its preferred display URL (normally a retained thumbnail).

media_fallbacksobject nullable

Mapping from a provably expired signed image URL to a safe legacy display candidate.

has_nextboolean nullable

True when another page is available after this response.

next_cursor_valuenumber nullable

Pass as cursor_value on the next page request.

next_cursor_idstring nullable

Pass as cursor_id on the next page request.

page_sizeinteger nullable

Maximum records requested for one server-capped page.

media_urls_expire_atinteger nullable

UNIX timestamp after which cached result media links must be refreshed.

Changes

No recorded changes to this operation across all 2 revisions of this API.