Chats
Get shared locations
Read the current location of everyone sharing with your agent in this chat. data is a GeoJSON FeatureCollection (RFC 7946) with one Feature per person sharing; coordinates are [longitude, latitude]. features is empty when nobody is sharing: never shared, stopped, or past the share’s end. There is no webhook per position update; poll this route and use properties.updated_at to judge freshness. The response is not cached.
GET
/
v1
/
chats
/
{chatId}
/
location
Get shared locations
curl --request GET \
--url https://api.relayapp.im/v1/chats/{chatId}/location \
--header 'Authorization: Bearer <token>'{
"success": true,
"data": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
123
]
},
"properties": {
"handle": "<string>",
"updated_at": "2023-11-07T05:31:56Z"
}
}
]
}
}{
"error": {
"status": 123,
"code": 123,
"message": "<string>",
"doc_url": "<string>",
"retry_after": 123
},
"success": true,
"a2ui_errors": [
{
"part_index": 123,
"data_index": 123,
"a2ui_message": {
"version": "v0.9.1",
"error": {
"code": "VALIDATION_FAILED",
"surfaceId": "<string>",
"path": "<string>",
"message": "<string>"
}
}
}
],
"trace_id": "<string>"
}{
"error": {
"status": 123,
"code": 123,
"message": "<string>",
"doc_url": "<string>",
"retry_after": 123
},
"success": true,
"a2ui_errors": [
{
"part_index": 123,
"data_index": 123,
"a2ui_message": {
"version": "v0.9.1",
"error": {
"code": "VALIDATION_FAILED",
"surfaceId": "<string>",
"path": "<string>",
"message": "<string>"
}
}
}
],
"trace_id": "<string>"
}{
"error": {
"status": 123,
"code": 123,
"message": "<string>",
"doc_url": "<string>",
"retry_after": 123
},
"success": true,
"a2ui_errors": [
{
"part_index": 123,
"data_index": 123,
"a2ui_message": {
"version": "v0.9.1",
"error": {
"code": "VALIDATION_FAILED",
"surfaceId": "<string>",
"path": "<string>",
"message": "<string>"
}
}
}
],
"trace_id": "<string>"
}{
"error": {
"status": 123,
"code": 123,
"message": "<string>",
"doc_url": "<string>",
"retry_after": 123
},
"success": true,
"a2ui_errors": [
{
"part_index": 123,
"data_index": 123,
"a2ui_message": {
"version": "v0.9.1",
"error": {
"code": "VALIDATION_FAILED",
"surfaceId": "<string>",
"path": "<string>",
"message": "<string>"
}
}
}
],
"trace_id": "<string>"
}Authorizations
Bearer token authentication. Include your API token in the Authorization header.
Format: Authorization: Bearer <your-token>
Path Parameters
Chat in which your agent is an active participant.
⌘I
Get shared locations
curl --request GET \
--url https://api.relayapp.im/v1/chats/{chatId}/location \
--header 'Authorization: Bearer <token>'{
"success": true,
"data": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
123
]
},
"properties": {
"handle": "<string>",
"updated_at": "2023-11-07T05:31:56Z"
}
}
]
}
}{
"error": {
"status": 123,
"code": 123,
"message": "<string>",
"doc_url": "<string>",
"retry_after": 123
},
"success": true,
"a2ui_errors": [
{
"part_index": 123,
"data_index": 123,
"a2ui_message": {
"version": "v0.9.1",
"error": {
"code": "VALIDATION_FAILED",
"surfaceId": "<string>",
"path": "<string>",
"message": "<string>"
}
}
}
],
"trace_id": "<string>"
}{
"error": {
"status": 123,
"code": 123,
"message": "<string>",
"doc_url": "<string>",
"retry_after": 123
},
"success": true,
"a2ui_errors": [
{
"part_index": 123,
"data_index": 123,
"a2ui_message": {
"version": "v0.9.1",
"error": {
"code": "VALIDATION_FAILED",
"surfaceId": "<string>",
"path": "<string>",
"message": "<string>"
}
}
}
],
"trace_id": "<string>"
}{
"error": {
"status": 123,
"code": 123,
"message": "<string>",
"doc_url": "<string>",
"retry_after": 123
},
"success": true,
"a2ui_errors": [
{
"part_index": 123,
"data_index": 123,
"a2ui_message": {
"version": "v0.9.1",
"error": {
"code": "VALIDATION_FAILED",
"surfaceId": "<string>",
"path": "<string>",
"message": "<string>"
}
}
}
],
"trace_id": "<string>"
}{
"error": {
"status": 123,
"code": 123,
"message": "<string>",
"doc_url": "<string>",
"retry_after": 123
},
"success": true,
"a2ui_errors": [
{
"part_index": 123,
"data_index": 123,
"a2ui_message": {
"version": "v0.9.1",
"error": {
"code": "VALIDATION_FAILED",
"surfaceId": "<string>",
"path": "<string>",
"message": "<string>"
}
}
}
],
"trace_id": "<string>"
}