v1

latestOpenAPI 3.0.32026-08-0425108247.7 KB
Search

Search messages

Searches messages in conversations accessible to the authenticated API key.

get/search/messages

Query parameters

qstring required

Search query text.

Search query text.

authorstring

Comma-separated author workspace member identifiers.

Comma-separated author workspace member identifiers.

conversationstring

Comma-separated conversation identifiers.

Comma-separated conversation identifiers.

threadstring

Thread root message identifier.

Thread root message identifier.

afterstring

Cursor or ISO timestamp after which results should be returned.

Cursor or ISO timestamp after which results should be returned.

beforestring

Cursor or ISO timestamp before which results should be returned.

Cursor or ISO timestamp before which results should be returned.

cursorstring

Opaque cursor returned by data.page_info.next_cursor. Reuse it unchanged with the same query and filters.

Opaque cursor returned by data.page_info.next_cursor. Reuse it unchanged with the same query and filters.

mode'full-text'

Search mode.

Deprecated compatibility parameter. Only full-text is accepted; semantic is rejected until genuine semantic retrieval ships.

Response

Message search results.

Example response

{
  "data": {
    "items": [
      {
        "authorWorkspaceMembershipId": "01jzn7e61x3a7v9h2r7t2m3q4p",
        "author_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
        "conversation_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
        "created_at": "2026-05-14T08:00:00.000Z",
        "id": "01jzn7e61x3a7v9h2r7t2m3q4p"
      }
    ]
  },
  "items": [
    {
      "authorWorkspaceMembershipId": "01jzn7e61x3a7v9h2r7t2m3q4p",
      "author_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
      "conversation_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
      "created_at": "2026-05-14T08:00:00.000Z",
      "id": "01jzn7e61x3a7v9h2r7t2m3q4p"
    }
  ]
}