Location actions
9 actions. Each action calls the same API route with the same scopes on every surface.
location_create_place
Section titled “location_create_place”Create a Saved place. Body fields: latitude, longitude, name, radius_m..
| Route | POST /api/v1/location/places |
| Tool name | calternal_api_location_create_place |
| Surfaces | cli, mcp, webmcp |
| Scopes | account |
| Effect | destructive, needs --confirm |
| Encoding | request json, response json |
body
| Field | Type | Required | Description |
|---|---|---|---|
latitude |
number, double |
yes | |
longitude |
number, double |
yes | |
name |
string |
yes | |
radius_m |
integer, int32 (0–) |
yes |
calternal action run location_create_place --input '{}' --confirm --jsonlocation_delete_place
Section titled “location_delete_place”Delete a Saved place.
| Route | DELETE /api/v1/location/places/{id} |
| Tool name | calternal_api_location_delete_place |
| Surfaces | cli, mcp, webmcp |
| Scopes | account |
| Effect | destructive, needs --confirm |
| Encoding | request none, response json |
path
| Field | Type | Required | Description |
|---|---|---|---|
id |
string |
yes |
calternal action run location_delete_place --input '{"path":{"id":"<id>"}}' --confirm --jsonlocation_edit_place
Section titled “location_edit_place”Update a Saved place. Body fields: latitude, longitude, name, radius_m..
| Route | PUT /api/v1/location/places/{id} |
| Tool name | calternal_api_location_edit_place |
| Surfaces | cli, mcp, webmcp |
| Scopes | account |
| Effect | destructive, needs --confirm |
| Encoding | request json, response json |
path
| Field | Type | Required | Description |
|---|---|---|---|
id |
string |
yes |
body
| Field | Type | Required | Description |
|---|---|---|---|
latitude |
number, double |
yes | |
longitude |
number, double |
yes | |
name |
string |
yes | |
radius_m |
integer, int32 (0–) |
yes |
calternal action run location_edit_place --input '{"path":{"id":"<id>"}}' --confirm --jsonlocation_get
Section titled “location_get”Get Location settings.
| Route | GET /api/v1/location |
| Tool name | calternal_api_location_get |
| Surfaces | cli, mcp, webmcp |
| Scopes | account |
| Effect | read only |
| Encoding | request none, response json |
calternal action run location_get --input '{}' --jsonlocation_list_places
Section titled “location_list_places”List Saved places.
| Route | GET /api/v1/location/places |
| Tool name | calternal_api_location_list_places |
| Surfaces | cli, mcp, webmcp |
| Scopes | account |
| Effect | read only |
| Encoding | request none, response json |
calternal action run location_list_places --input '{}' --jsonlocation_put
Section titled “location_put”Update Location settings. Body fields: enabled, position, record_places_on_logs..
| Route | PUT /api/v1/location |
| Tool name | calternal_api_location_put |
| Surfaces | cli, mcp, webmcp |
| Scopes | account |
| Effect | destructive, needs --confirm |
| Encoding | request json, response json |
body
| Field | Type | Required | Description |
|---|---|---|---|
enabled |
boolean |
yes | |
position |
object or null |
no | |
record_places_on_logs |
boolean |
yes |
calternal action run location_put --input '{}' --confirm --jsonlocation_restore_place
Section titled “location_restore_place”Restore a deleted place at its former order. Identical retries are safe if a response is lost, while an ID that was reused with different details cannot overwrite the current place (#828, DESIGN §47).. Body fields: index, latitude, longitude, name, radius_m..
| Route | POST /api/v1/location/places/{id}/restore |
| Tool name | calternal_api_location_restore_place |
| Surfaces | cli, mcp, webmcp |
| Scopes | data |
| Effect | destructive, needs --confirm |
| Encoding | request json, response json |
path
| Field | Type | Required | Description |
|---|---|---|---|
id |
string |
yes |
body
| Field | Type | Required | Description |
|---|---|---|---|
index |
integer (0–) |
yes | Previous zero-based place position. Concurrent additions clamp it to the end of the current list. |
latitude |
number, double |
yes | |
longitude |
number, double |
yes | |
name |
string |
yes | |
radius_m |
integer, int32 (0–) |
yes |
calternal action run location_restore_place --input '{"path":{"id":"<id>"}}' --confirm --jsonlocation_set_timezone
Section titled “location_set_timezone”Set the time zone. Body fields: timezone..
| Route | PUT /api/v1/location/timezone |
| Tool name | calternal_api_location_set_timezone |
| Surfaces | cli, mcp, webmcp |
| Scopes | account |
| Effect | destructive, needs --confirm |
| Encoding | request json, response json |
body
| Field | Type | Required | Description |
|---|---|---|---|
timezone |
string |
yes |
calternal action run location_set_timezone --input '{}' --confirm --jsonlocation_update_position
Section titled “location_update_position”Update the current position. Body fields: latitude, longitude..
| Route | POST /api/v1/location/position |
| Tool name | calternal_api_location_update_position |
| Surfaces | cli, mcp, webmcp |
| Scopes | account |
| Effect | destructive, needs --confirm |
| Encoding | request json, response json |
body
| Field | Type | Required | Description |
|---|---|---|---|
latitude |
number, double |
yes | |
longitude |
number, double |
yes |
calternal action run location_update_position --input '{}' --confirm --json