Skip to content
getgeolens.com
GeoLens Docs

Chat Endpoint

POST
/ai/chat/
 
curl --request POST \
  --url https://example.com/ai/chat/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "message": "example", "map_id": "example", "layers": [ { "id": "example", "name": "example", "dataset_id": "example", "dataset_table_name": "example", "geometry_type": "example", "layer_type": "example", "column_info": [ {} ], "dataset_title": "example", "feature_count": 1, "sample_values": {}, "visible": true, "filter": {}, "label_config": {}, "style_config": {}, "paint": {} } ], "language": "example", "history": [ { "role": "user", "content": "example" } ] }'

Chat-based map editing: send a message and get back edit actions.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
Media type application/json
ChatRequest
object
message
required
Message
string
>= 1 characters <= 2000 characters
map_id
required
Map Id
string
layers
required
Layers
Array<object>
ChatMapLayer

Layer state sent from frontend for chat context.

object
id
required
Id
string
name
required
Name
string
dataset_id
required
Dataset Id
string
dataset_table_name
required
Dataset Table Name
string
geometry_type
Any of:
string
layer_type
Any of:
string
column_info
Any of:
Array<object>
object
key
additional properties
any
dataset_title
Any of:
string
feature_count
Any of:
integer
sample_values
Any of:
object
key
additional properties
any
visible
Visible
boolean
default: true
filter
Any of:
Array
label_config
Any of:
object
key
additional properties
any
style_config
Any of:
object
key
additional properties
any
paint
Any of:
object
key
additional properties
any
language
Any of:
string
history
History
Array<object>
<= 20 items
ChatHistoryMessage

A single message in the conversation history.

object
role
required
Role
string
Allowed values: user assistant
content
required
Content
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

Media type application/json
ChatResponse
object
explanation
required
Explanation
string
actions
required
Actions
Array<object>
ChatAction
object
type
required
Type
string
Allowed values: set_filter set_style set_data_driven_style set_label toggle_visibility add_layer remove_layer show_query_result set_opacity
layer_id
Any of:
string
expression
Any of:
Array
paint
Any of:
object
key
additional properties
any
clear_paint
Any of:
Array<string>
replace_paint
Any of:
boolean
style_config
Any of:
object
key
additional properties
any
label_config
Any of:
object
key
additional properties
any
dataset_id
Any of:
string
dataset_name
Any of:
string
visible
Any of:
boolean
opacity
Any of:
number
<= 1
geojson
Any of:
GeoJSONFeatureCollection

A GeoJSON FeatureCollection.

object
type
Type
string
default: FeatureCollection
features
Features
Array<object>
default:
GeoJSONFeature

A GeoJSON Feature.

object
type
Type
string
default: Feature
geometry
Any of:
object
key
additional properties
any
properties
Any of:
object
key
additional properties
any
key
additional properties
any
key
additional properties
any
bbox
Any of:
Array<number>
rows
Any of:
Array<Array>
columns
Any of:
Array<string>
row_count
Any of:
integer
truncated
Any of:
boolean
operation
Any of:
string
distance_meters
Any of:
number
Example 
{
  "actions": [
    {
      "type": "set_filter",
      "geojson": {
        "type": "FeatureCollection",
        "features": []
      }
    }
  ]
}

400

Section titled “400 ”

Bad request — invalid query parameters or payload

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

401

Section titled “401 ”

Unauthorized — missing or invalid credentials

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

403

Section titled “403 ”

Forbidden — caller lacks access to this resource

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

404

Section titled “404 ”

Not found

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

422

Section titled “422 ”

Validation error

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

429

Section titled “429 ”

Too many requests — retry after the advertised interval

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

Headers

Section titled “Headers ”
Retry-After
integer

Seconds until the request may be retried

500

Section titled “500 ”

Internal server error

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

502

Section titled “502 ”

Bad gateway — an upstream provider failed

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

503

Section titled “503 ”

Service unavailable — the database could not serve the request

Media type application/problem+json
ProblemDetail
object
type
Type
string
default: about:blank
title
required
Title
string
status
required
Status
integer
detail
required
Any of:
string
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}
Privacy Apache 2.0 getgeolens.com