Search

Searches messages in conversations accessible to the authenticated API key.

get/search/messages

Request

  • Base URL
    https://api.ando.so/v1
  • URL
    https://api.ando.so/v1/search/messages
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Query parameters

qstring required

Search query text.

authorstring

Comma-separated author workspace member identifiers.

conversationstring

Comma-separated conversation identifiers.

threadstring

Thread root message identifier.

afterstring

Cursor or ISO timestamp after which results should be returned.

beforestring

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.

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",
        "attachments": [
          {
            "file_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
          }
        ]
      }
    ]
  },
  "items": [
    {
      "authorWorkspaceMembershipId": "01jzn7e61x3a7v9h2r7t2m3q4p",
      "author_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
      "conversation_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
      "created_at": "2026-05-14T08:00:00.000Z",
      "id": "01jzn7e61x3a7v9h2r7t2m3q4p",
      "attachments": [
        {
          "file_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
        }
      ]
    }
  ]
}

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property // to the response with the status