# Radar

Radar is a full-stack location infrastructure platform offering SDKs and APIs for geofencing, location tracking, geocoding, search, routing, and maps.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 38
- **Triggers:** 0
- **Slug:** `RADAR`
- **Version:** 20260312_00

## Tools

### Autocomplete Address or Place

**Slug:** `RADAR_AUTOCOMPLETE_ADDRESS_OR_PLACE`

Tool to autocomplete partial addresses and place names based on relevance and proximity. Use after a user inputs a partial address/place to get suggestions, optionally biased by location.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `near` | string | No | Coordinate bias as 'lat,lng' |
| `limit` | integer | No | Maximum number of results to return (1-100) |
| `query` | string | Yes | Partial address or place to autocomplete |
| `layers` | array | No | Result types to return (e.g., ['address','place']) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Beacon

**Slug:** `RADAR_CREATE_BEACON`

Tool to create a new beacon in Radar. Use when you need to register a physical beacon device (iBeacon or Eddystone) for location tracking.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | Yes | A group or category for the beacon (e.g., 'store-entrance', 'parking-lot') |
| `type` | string ("ibeacon" | "eddystone") | Yes | The type of beacon technology |
| `uuid` | string | No | For iBeacon, the UUID identifier |
| `major` | string | No | For iBeacon, the major value |
| `minor` | string | No | For iBeacon, the minor value |
| `enabled` | boolean | No | Whether the beacon is enabled. If not specified, defaults to true. |
| `metadata` | object | No | Optional custom metadata key-value pairs for the beacon |
| `externalId` | string | Yes | An external ID for the beacon, used to reference it in your system |
| `coordinates` | array | Yes | The approximate location of the beacon in [longitude, latitude] format. Used to sync nearby beacons (within 1 kilometer) to the SDK. |
| `description` | string | No | A description for the beacon |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Trip

**Slug:** `RADAR_CREATE_TRIP`

Tool to create a new trip. Use after gathering origin and destination details to start tracking a trip.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("car" | "foot" | "bike") | No | Mode of travel, one of 'car', 'foot', or 'bike' |
| `metadata` | object | No | Custom key-value pairs for trip |
| `externalId` | string | Yes | External ID for the trip |
| `originLocation` | object | No | Origin location as GeoJSON Point |
| `originGeofenceTag` | string | No | Tag of origin geofence (e.g. warehouse) |
| `destinationLocation` | object | No | Destination location as GeoJSON Point |
| `approachingThreshold` | integer | No | Distance threshold in meters for approaching status |
| `destinationGeofenceTag` | string | No | Tag of destination geofence (e.g. store) |
| `originGeofenceExternalId` | string | No | External ID of origin geofence |
| `destinationGeofenceExternalId` | string | No | External ID of destination geofence |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Beacon

**Slug:** `RADAR_DELETE_BEACON`

Tool to delete a beacon by its Radar ID. Use when supplying a beacon's unique identifier to remove it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The Radar _id of the beacon to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Geofence

**Slug:** `RADAR_DELETE_GEOFENCE`

Tool to delete a geofence by ID. Use when supplying a geofence’s unique identifier to remove it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique ID of the geofence to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Geofence By Tag

**Slug:** `RADAR_DELETE_GEOFENCE_BY_TAG`

Tool to delete a geofence by tag and external ID. Use when you have both the tag and external identifier to remove a specific geofence.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | Yes | The tag of the geofence to delete |
| `externalId` | string | Yes | The external ID of the geofence to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Trip

**Slug:** `RADAR_DELETE_TRIP`

Tool to delete a trip by its Radar ID or external ID. Use after confirming the trip exists.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the trip to delete. Can be Radar _id or externalId. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete User

**Slug:** `RADAR_DELETE_USER`

Tool to delete a user by Radar _id, userId, or deviceId. Use after confirming the user identifier exists.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The user identifier - can be Radar _id, userId, or deviceId. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Forward Geocode

**Slug:** `RADAR_FORWARD_GEOCODE`

Tool to convert an address into geographic coordinates. Use when you have a full address string and need precise latitude/longitude before further location analysis.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (default 10, max 100) |
| `query` | string | Yes | The full address or query string to geocode |
| `layers` | array | No | Place types to filter results, comma-separated (e.g., 'address','locality') |
| `country` | string | No | Two-letter ISO 3166-1 alpha-2 country code to filter results |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Beacon

**Slug:** `RADAR_GET_BEACON`

Tool to retrieve a beacon by Radar _id. Use when you need to fetch full details of an existing beacon.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The Radar-generated _id of the beacon to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Beacon By Tag

**Slug:** `RADAR_GET_BEACON_BY_TAG`

Tool to get a specific beacon by tag and external ID. Use when you need to retrieve details of a beacon identified by its tag group and external ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | Yes | A group for the beacon (required) |
| `externalId` | string | Yes | An external ID for the beacon (required) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Context for Location

**Slug:** `RADAR_GET_CONTEXT_FOR_LOCATION`

Tool to retrieve context for a given location. Use when you need geofences, place, and region information based on coordinates. Use after obtaining valid latitude and longitude.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lat` | number | Yes | Latitude in decimal degrees, between -90 and 90 |
| `lng` | number | Yes | Longitude in decimal degrees, between -180 and 180 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Geofence

**Slug:** `RADAR_GET_GEOFENCE`

Tool to retrieve a geofence by Radar _id or tag/externalId. Use when you need to fetch full details of an existing geofence.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Unique Radar geofence identifier (e.g., '56db1f4613012711002229f5'). Use this OR tag+externalId. |
| `tag` | string | No | Tag of the geofence. Must be used together with externalId. |
| `externalId` | string | No | External identifier of the geofence. Must be used together with tag. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Places Settings

**Slug:** `RADAR_GET_PLACES_SETTINGS`

Tool to retrieve current Places settings for your Radar project. Use when you need to inspect chain detection, supported countries, external ID requirements, and other Places metadata.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Route Directions

**Slug:** `RADAR_GET_ROUTE_DIRECTIONS`

Tool to get turn-by-turn directions between multiple locations. Use when you need detailed navigation instructions with steps, distances, and durations for routing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lang` | string ("de" | "en" | "es" | "fr" | "ja" | "ko" | "pt" | "ru") | No | Result language. Options: 'de', 'en', 'es', 'fr', 'ja', 'ko', 'pt', 'ru'. Defaults to 'en' |
| `mode` | string ("car" | "truck" | "foot" | "bike") | No | Travel method. Options: 'car', 'truck', 'foot', 'bike'. Defaults to 'car' |
| `avoid` | string | No | Route features to bypass, comma-separated. Options: 'tolls', 'highways', 'ferries', 'borderCrossings' |
| `units` | string ("metric" | "imperial") | No | Distance units. Options: 'metric', 'imperial'. Defaults to 'imperial' |
| `heading` | number | No | Initial travel direction in degrees (0=north, 90=east, 180=south, 270=west) |
| `geometry` | string ("linestring" | "polyline5" | "polyline6") | No | Response geometry format. Options: 'linestring', 'polyline5', 'polyline6'. Defaults to 'polyline6' |
| `locations` | string | Yes | A list of up to 25 coordinates to visit in order. A pipe-delimited string in the format 'latitude0,longitude0\|latitude1,longitude1\|...' |
| `alternatives` | boolean | No | Return alternative routes (only works for two-location routes). Defaults to false |
| `departureTime` | string | No | ISO 8601 datetime for historical traffic consideration (e.g., '2025-01-01T14:30:00Z') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Route Matrix

**Slug:** `RADAR_GET_ROUTE_MATRIX`

Tool to calculate travel distance and duration between multiple origins and destinations for up to 625 routes. Use when you need to compute route metrics for multiple origin-destination pairs efficiently.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("car" | "truck" | "foot" | "bike") | No | Travel mode for route calculation |
| `units` | string ("metric" | "imperial") | No | Unit system for distance measurements (metric returns meters, imperial returns feet) |
| `origins` | string | Yes | Pipe-separated list of origin coordinates as 'lat,lon\|lat,lon' (e.g., '40.7128,-74.0060\|37.7749,-122.4194') |
| `destinations` | string | Yes | Pipe-separated list of destination coordinates as 'lat,lon\|lat,lon' (e.g., '40.7589,-73.9851\|34.0522,-118.2437') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Trip

**Slug:** `RADAR_GET_TRIP`

Tool to retrieve a trip by ID or externalId. Use when you have a trip ID or externalId to fetch its details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The Radar trip ID or externalId. |
| `format` | string | No | Set to 'externalId' when using an external trip ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User

**Slug:** `RADAR_GET_USER`

Tool to get a user by Radar _id, userId, or deviceId. Returns the user with all location and context data including geofences, places, beacons, and trip information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | User identifier - can be Radar _id, userId, or deviceId |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Users in Geofence

**Slug:** `RADAR_GET_USERS_IN_GEOFENCE`

Tool to retrieve users currently within a specific geofence. Use when you need to list all users inside a geofence by its tag and external ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | Yes | Tag of the geofence |
| `limit` | integer | No | Maximum number of users to return (default: 100, max: 500) |
| `cursor` | string | No | Pagination cursor to fetch the next page of results |
| `externalId` | string | Yes | External ID of the geofence |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### IP Geocode

**Slug:** `RADAR_IP_GEOCODE`

Tool to geocode an IP address to city, state, and country. Use when you need location details based on an IP address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | The IP address to geocode; defaults to the requester's IP if omitted |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Events

**Slug:** `RADAR_LIST_EVENTS`

Tool to list events. Use when you need to retrieve a paginated list of events with optional filtering.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end` | string | No | Return events created before this ISO 8601 timestamp |
| `type` | string | No | Filter events by event type |
| `limit` | integer | No | Maximum number of events to return (1-500) |
| `start` | string | No | Return events created after this ISO 8601 timestamp |
| `userId` | string | No | Filter events by user ID |
| `afterId` | string | No | Cursor to return events created after this event ID |
| `beforeId` | string | No | Cursor to return events created before this event ID |
| `deviceId` | string | No | Filter events by device ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Geofences

**Slug:** `RADAR_LIST_GEOFENCES`

Tool to list all geofences sorted by updated time. Use when you need an overview of all configured geofences.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | No | Filter geofences by tag |
| `page` | integer | No | Page number to return (default 1) |
| `limit` | integer | No | Maximum number of geofences to return (1-500) |
| `metadata` | object | No | Filter geofences by metadata key-value pairs |
| `externalId` | string | No | Filter geofences by external ID |
| `createdAfter` | string | No | Return geofences created after this ISO8601 timestamp |
| `updatedAfter` | string | No | Return geofences updated after this ISO8601 timestamp |
| `createdBefore` | string | No | Return geofences created before this ISO8601 timestamp |
| `updatedBefore` | string | No | Return geofences updated before this ISO8601 timestamp |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Trips

**Slug:** `RADAR_LIST_TRIPS`

Tool to list all trips, sorted by updated time. Use when you need to page through the latest trips.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of trips to return (1–100). Defaults to 100 when omitted. |
| `userId` | string | No | Filter trips by Radar user ID. |
| `metadata` | object | No | Filter trips by metadata key/value pairs. |
| `externalId` | string | No | Filter trips by external ID. |
| `endingBefore` | string | No | Return trips ending immediately before this trip ID. |
| `startingAfter` | string | No | Return trips starting immediately after this trip ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Users

**Slug:** `RADAR_LIST_USERS`

Tool to list Radar users sorted by update time. Use when you need to page through users in your project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | Only return users who have all of these tags |
| `limit` | integer | No | Maximum number of users to return |
| `afterId` | string | No | User ID after which to return users for pagination |
| `createdAfter` | string | No | Only return users created after this ISO 8601 timestamp |
| `updatedAfter` | string | No | Only return users updated after this ISO 8601 timestamp |
| `createdBefore` | string | No | Only return users created before this ISO 8601 timestamp |
| `updatedBefore` | string | No | Only return users updated before this ISO 8601 timestamp |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Reverse Geocode

**Slug:** `RADAR_REVERSE_GEOCODE`

Tool to convert geographic coordinates to structured addresses. Use when you have latitude/longitude and need a human-readable address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (default 1, max 10) |
| `layers` | array | No | Place types to restrict results, comma-separated (e.g., ['address','place']) |
| `country` | string | No | Two-letter ISO 3166-1 alpha-2 country code to filter results |
| `coordinates` | string | Yes | Latitude and longitude in 'lat,lon' format |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Route Distance

**Slug:** `RADAR_ROUTE_DISTANCE`

Tool to compute distance and travel time between origins and destinations. Use when you need route metrics before optimizing or timing routes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("car" | "truck" | "foot" | "bike") | No | Routing mode |
| `avoid` | string | No | Route features to avoid, comma-separated (e.g., 'tolls,ferries') |
| `units` | string ("metric" | "imperial") | No | Units for distance measurement |
| `origins` | string | Yes | Origin coordinate as 'latitude,longitude' |
| `geometry` | string ("polyline" | "polyline5" | "polyline6" | "linestring") | No | Format for route geometry in response. Options: 'polyline', 'polyline5', 'polyline6', 'linestring' |
| `destinations` | string | Yes | Destination coordinate as 'latitude,longitude' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Geofences

**Slug:** `RADAR_SEARCH_GEOFENCES_NEAR_LOCATION`

Tool to search for geofences near a given location. Use when you need to find geofences within a radius of specified coordinates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | Filter geofences by these tags |
| `radius` | integer | No | Search radius in meters (default 1000, max 10000) |
| `latitude` | number | Yes | Latitude of the location to search near |
| `metadata` | object | No | Filter geofences by metadata key-value pairs |
| `longitude` | number | Yes | Longitude of the location to search near |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Places Near Location

**Slug:** `RADAR_SEARCH_PLACES_NEAR_LOCATION`

Tool to search for places near given coordinates. Use when you need to find points of interest around a location.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `near` | string | Yes | Coordinates to search near in 'lat,lng' format |
| `brand` | string | No | Filter by brand name or ID |
| `limit` | integer | No | Number of results to return; max 100; defaults to 10 |
| `chains` | array | No | Filter by chain IDs |
| `groups` | array | No | Filter by custom group names |
| `radius` | integer | No | Search radius in meters; max 10000 (10 km); defaults to 1000 |
| `country` | string | No | ISO 3166-1 alpha-2 country code |
| `categories` | array | No | Filter by category names |
| `chain_metadata` | boolean | No | If true, includes chain metadata in each place object |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Users Near Location

**Slug:** `RADAR_SEARCH_USERS_NEAR_LOCATION`

Tool to search for users near a location. Use after obtaining coordinates when you need to retrieve users within a given radius.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of users to return (default: 100, max: 500). |
| `radius` | number | No | Maximum distance in meters to search (default: 1000, range: 1-10000). |
| `latitude` | number | Yes | Latitude of the location in decimal degrees. |
| `longitude` | number | Yes | Longitude of the location in decimal degrees. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Track Location Update

**Slug:** `RADAR_TRACK_LOCATION_UPDATE`

Tool to track a user's location update. Use when sending a location update for a user, creating or updating user and event data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `userId` | string | No | Stable unique identifier for logged-in users. Combined with deviceId for user identification. |
| `stopped` | boolean | No | Whether the user is stopped (not moving) |
| `accuracy` | number | Yes | Accuracy of the location in meters. Must be greater than 0. |
| `altitude` | number | No | Altitude of the device in meters |
| `deviceId` | string | Yes | Unique identifier for the user's device. Required for user identification. |
| `deviceOS` | string | No | Operating system version of the device |
| `latitude` | number | Yes | Latitude of the location in degrees |
| `metadata` | object | No | Arbitrary metadata to associate with this track event (up to 32 keys) |
| `replayed` | boolean | No | Whether this location update is historical (replayed) |
| `longitude` | number | Yes | Longitude of the location in degrees |
| `updatedAt` | string | No | ISO 8601 timestamp for historical track events |
| `deviceMake` | string | No | Manufacturer of the device |
| `deviceType` | string | No | Type of device: iOS, Android, or Web |
| `foreground` | boolean | No | Whether the client is in the foreground |
| `description` | string | No | Text description of the user to display on the dashboard |
| `deviceModel` | string | No | Model of the device |
| `verticalAccuracy` | number | No | Vertical accuracy of the altitude in meters |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Places Settings

**Slug:** `RADAR_UPDATE_PLACES_SETTINGS`

Tool to update Places settings for your Radar project including chain metadata preferences. Use when you need to configure chain detection or other Places settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chainMetadata` | object | No | Chain metadata preferences for Places. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Trip

**Slug:** `RADAR_UPDATE_TRIP`

Tool to update a trip. Use when you need to modify mode, destination, schedule, or active status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The Radar trip ID or externalId to update |
| `mode` | string ("car" | "truck" | "bike" | "foot" | "motorbike") | No | Mode of travel (valid values: car, foot, bike, truck, motorbike) |
| `active` | boolean | No | Whether the trip is active (true) or paused/completed (false) |
| `format` | string | No | Set to 'externalId' when the provided ID is an external trip ID |
| `metadata` | object | No | Custom metadata (max 16 key-value pairs) |
| `externalId` | string | No | New external ID for the trip |
| `destination` | object | No | Explicit destination coordinates if not using a geofence. |
| `arrivedThreshold` | number | No | Threshold in meters for the 'arrived' state |
| `scheduledArrivalAt` | string | No | Scheduled arrival time in ISO8601 format |
| `approachingThreshold` | number | No | Threshold in meters for the 'approaching' state |
| `destinationGeofenceTag` | string | No | Tag of destination geofence |
| `destinationGeofenceRadius` | number | No | Radius in meters for the destination geofence |
| `destinationGeofenceExternalId` | string | No | External ID of destination geofence |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Trip By ID

**Slug:** `RADAR_UPDATE_TRIP_BY_ID`

Tool to update a trip status by Radar _id or external ID. Use when you need to change trip status to started, approaching, arrived, completed, or canceled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Trip ID (Radar _id or externalId) to update |
| `status` | string ("started" | "approaching" | "arrived" | "completed" | "canceled") | Yes | The new status of the trip |
| `metadata` | object | No | Optional custom key-value pairs for the trip |
| `externalId` | string | No | Optional stable unique ID for the trip |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upsert Beacon by ID

**Slug:** `RADAR_UPSERT_BEACON_BY_ID`

Tool to create or update a beacon by Radar _id. Use when you need to ensure a beacon with a specific ID exists with updated properties.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The Radar beacon _id to create or update |
| `tag` | string | No | A group for the beacon |
| `type` | string | Yes | Beacon type, must be 'ibeacon' |
| `uuid` | string | Yes | The iBeacon UUID |
| `major` | string | Yes | Major number for the beacon (can be string or integer) |
| `minor` | string | Yes | Minor number for the beacon (can be string or integer) |
| `enabled` | boolean | No | If true, the beacon will generate events; defaults to true |
| `externalId` | string | No | External ID for the beacon |
| `coordinates` | array | Yes | The approximate location in [longitude, latitude] format |
| `description` | string | No | Display name for the beacon |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upsert Beacon by Tag

**Slug:** `RADAR_UPSERT_BEACON_BY_TAG`

Tool to create or update a beacon by tag and externalId. Use when you need to ensure a beacon exists or is updated with specific identifiers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | Yes | Tag identifier for grouping the beacon (appears in URL path) |
| `uid` | string | No | UID identifier for Eddystone beacons (required for eddystone, not used for ibeacon) |
| `type` | string ("ibeacon" | "eddystone") | Yes | Beacon technology type: ibeacon or eddystone |
| `uuid` | string | No | UUID identifier for iBeacon type (required for ibeacon, not used for eddystone) |
| `major` | string | No | Major ID for iBeacon type (required for ibeacon, not used for eddystone) |
| `minor` | string | No | Minor ID for iBeacon type (required for ibeacon, not used for eddystone) |
| `enabled` | boolean | Yes | Whether the beacon is active and generates events |
| `instance` | string | No | Instance ID for Eddystone beacons (required for eddystone, not used for ibeacon) |
| `metadata` | object | No | Custom key-value pairs for the beacon (max 16 keys, values must be string/boolean/number) |
| `externalId` | string | Yes | External identifier mapping to your database (appears in URL path) |
| `coordinates` | array | Yes | Beacon location as [longitude, latitude] in GeoJSON format |
| `description` | string | Yes | Human-readable display name for the beacon |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upsert Geofence

**Slug:** `RADAR_UPSERT_GEOFENCE`

Tool to create or update a geofence by tag and externalId. Use when ensuring a geofence exists or is updated based on identifiers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | Yes | Tag of the geofence to create or update |
| `type` | string ("circle" | "polygon") | Yes | Shape type of the geofence |
| `radius` | number | No | Radius in meters defining a circle. Required when type='circle'. |
| `geometry` | object | No | GeoJSON geometry object for the geofence |
| `metadata` | object | No | Custom key-value pairs attached to the geofence |
| `externalId` | string | Yes | External identifier of the geofence |
| `coordinates` | array | No | Array of [longitude, latitude] pairs defining a polygon. Required when type='polygon'. |
| `description` | string | Yes | Human-readable description of the geofence (required by the API) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upsert Geofence By ID

**Slug:** `RADAR_UPSERT_GEOFENCE_BY_ID`

Tool to create or update a geofence by Radar _id. Use when you need to upsert a geofence using its internal Radar identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Radar internal geofence _id to create or update |
| `tag` | string | No | Group identifier for the geofence |
| `type` | string ("circle" | "polygon" | "isochrone") | Yes | Geofence geometry type: circle, polygon, or isochrone |
| `radius` | number | No | Distance in meters (required for circle and isochrone types) |
| `enabled` | boolean | No | Boolean to enable/disable event generation for this geofence |
| `metadata` | object | No | Custom key-value pairs (up to 16 keys) |
| `externalId` | string | No | External database reference |
| `coordinates` | string | Yes | Location data in [longitude, latitude] format for circle/isochrone, or array of coordinate pairs for polygon |
| `description` | string | Yes | A display name for the geofence (required by API) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |