List chat threads

List chat threads for the user with cursor-based pagination.

Optionally filter by agent_id, X-App-Id header, and created_at date range.

GET

https://truememory-api.mvstg.com/threads

View as Markdown

Authorization

HTTPBearerHTTPrequired

Query parameters

agent_idoptional
One of the following:
string
null
}
cursoroptional
One of the following:
string
null
}
limitoptionalinteger
default: 20
order_byoptionalstring
default: "created_at"
ascoptionalboolean
default: false
created_afteroptional
One of the following:
string
null
}
created_beforeoptional
One of the following:
string
null
}

Header parameters

x-app-idoptional
Application ID for scoping threads
One of the following:
string
null
}
X-On-Behalf-Ofoptional
One of the following:
string
null
}
X-External-User-Idoptional
One of the following:
string
null
}
X-App-Idoptional
One of the following:
string
null
}

Returns

200

Successful Response

JSON

threadsarray ofobjectrequired
- thread_idstringrequired
  Thread ID (session_key).
- agent_idstringrequired
  Agent that handled this thread.
- created_atstringrequired
  When the thread was created (ISO 8601).
- updated_atstringrequired
  When the thread was last updated (ISO 8601).
- app_idoptional
  Application scope for this thread. None if unscoped.
  
  One of the following:
  string
  null
- titleoptional
  Thread title derived from the first user message.
  
  One of the following:
  string
  null
- metadataoptional
  Arbitrary metadata dict for the thread.
  
  One of the following:
  object
  null
}
next_cursoroptional
Cursor for the next page. None if no more results.
One of the following:
string
null
}

422

Validation Error

JSON

detailoptionalarray ofobject
- locarray ofrequired
  One of the following:
  string
  integer
- msgstringrequired
- typestringrequired
- inputoptionalunknown
- ctxoptionalobject
}

{ "threads": [ { "thread_id": "847c6285-8fc9-4560-a83f-4e6285809254", "agent_id": "chatbot", "app_id": "vibrantly", "title": "What is the weather in Tokyo?", "metadata": { "isPinned": false, "source": "whatsapp" }, "created_at": "string", "updated_at": "string" } ], "next_cursor": "string" }