Find Record records semantically furthest from a text query, scoped to one space.

​

Inverse of /similar: returns records whose embedded text fields are most * DISTANT from the query (cosine distance, descending). Same filter/scope rules as * /similar. Note: HNSW indexes do not accelerate distance-DESC queries; outlier * ranking is closer to a full scan over the filtered candidate set.

Query Parameters
  • space_id
    Type: integer
    min:  
    1
    required

    Tenant scope. Custom module derived from space.custom_module_id.

  • query
    Type: string
    min length:  
    1
    max length:  
    4000
    required

    Free-text query to embed; ranking returns records UNLIKE this. Max 4000 characters.

  • limit
    Type: integer
    min:  
    1

    Integer numbers.

  • filter
    Type: string

    Filter expression. Mutually exclusive with segment_id.

  • segment_id
    Type: integer
    min:  
    1

    ID of a saved segment whose filter to apply. Mutually exclusive with filter.

  • max_distance
    Type: number Format: float
    min:  
    0
    max:  
    2

    Cosine-distance floor in [0, 2]. Records whose best embedding is CLOSER than this are dropped.

Responses
  • application/json
  • 400

    Validation error.

  • 401

    Not authenticated.

  • 403

    User lacks read access to the requested space.

  • 405

    Method not GET.

  • 502

    Embedding provider call failed.

Request Example for get/record/vector/outliers
curl 'https://test.boost.space/api/record/vector/outliers?space_id=123&query=premium%20wireless%20headphones' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "results": [
    {
      "recordId": 99887,
      "distance": 0.91,
      "record": {
        "id": 42,
        "created": "2026-01-15T09:30:00Z",
        "createdUserId": 42,
        "statusSystemId": 42,
        "statusId": 42,
        "spaceId": 42,
        "featuredImageId": 42,
        "files": [
          1
        ],
        "labels": [
          1
        ],
        "boostId": "string",
        "customFieldsValues": [
          {
            "id": 42,
            "created": "2026-01-15T09:30:00Z",
            "valueWysiwyg": "string",
            "valueInt": 1,
            "valueFloat": 1.5,
            "valueDatetime": "2026-01-15T09:30:00Z",
            "valueModule": "string",
            "value": "string",
            "fileId": 42,
            "customFieldInputId": 42,
            "module": "activities",
            "table": "string",
            "entityId": 42,
            "customFieldInputName": "Sample customFieldInputName",
            "selected": true,
            "ipAddress": "string",
            "translatable": true,
            "translations": {
              "en": {
                "field1": "translation1",
                "field2": "translation2"
              },
              "it": {
                "field1": "translation1",
                "field2": "translation2"
              },
              "cs": {
                "field1": "translation1",
                "field2": "translation2"
              }
            }
          }
        ]
      }
    }
  ],
  "totalCandidates": 8000,
  "queryTimeMs": 38
}

Records ranked by descending cosine distance.