search-tool
Search Rhombus camera footage and events by license plate, object color, text description, or motion events. Filter results with time ranges and camera selection.
Instructions
This tool performs visual and data searches across Rhombus camera footage and events.
It has the following modes of operation, determined by the "requestType" parameter:
license-plate: Search for license plate sightings by plate number. Requires query (the plate number or partial match).
object-by-color: Search for objects by color in camera footage. Requires query (color name) and cameraUuid.
object-by-text: Semantic search for objects in footage using a text description. Requires query (text description).
motion-search: Search for motion events in a camera's field of view. Requires cameraUuid, startTime, and endTime.
All search types support optional startTime and endTime to narrow the search window. Use the get-entity-tool with entityType CAMERA to get camera UUIDs.
Output filtering (all tools):
includeFields(string[]): Dot-notation paths to keep in the response (e.g."vehicleEvents.vehicleLicensePlate"). Omit to return all fields.filterBy(array): Predicates to filter array items. Each entry:{field, op, value}where op is one of= != > >= < <= contains. All conditions are ANDed. Example:[{field:"vehicleLicensePlate", op:"=", value:"ABC123"}]WARNING: some tool responses exceed 400k characters — use these params to request only the data you need.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| requestType | Yes | The type of search to perform. | |
| query | Yes | The search query string. Required for 'license-plate' (plate number), 'object-by-text' (text description of object), 'object-by-color' (color name). | |
| cameraUuid | Yes | The UUID of the camera to search. Required for 'motion-search' and 'object-by-color'. | |
| startTime | Yes | Start time for the search range.Time format is in ISO 8601 format. Both UTC ("2025-08-04T20:54:27.123Z") and time zone offsets ("2025-08-04T13:54:27.123-07:00") are accepted to ensure an unambiguous point in time. | |
| endTime | Yes | End time for the search range.Time format is in ISO 8601 format. Both UTC ("2025-08-04T20:54:27.123Z") and time zone offsets ("2025-08-04T13:54:27.123-07:00") are accepted to ensure an unambiguous point in time. | |
| deviceUuids | Yes | Optional list of device UUIDs to filter search results. | |
| locationUuids | Yes | Optional list of location UUIDs to filter search results. | |
| timeZone | Yes | The timezone for formatting timestamps. | |
| includeFields | Yes | Dot-notation field paths to include in the response (e.g. "vehicleEvents.vehicleLicensePlate"). Pass null to return all fields. WARNING: some responses can exceed 400k characters — use includeFields to request only the data you need. For high-volume tools this may be required to get a complete answer. | |
| filterBy | Yes | Filter array items in the response by field values. All conditions are ANDed. Example: [{field: "vehicleLicensePlate", op: "=", value: "ABC123"}, {field: "confidence", op: ">", value: 0.8}] Use alongside includeFields to get only the specific records and fields you need. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| licensePlateResults | No | License plate search results | |
| objectColorResults | No | Object color search results | |
| objectTextResults | No | Object text search results | |
| motionResults | No | Motion search results | |
| error | No | An error message if the request failed. |