Skip to content

Create waypoint

PUT
/api/v1/waypoint
curl --request PUT \
--url https://example.com/api/v1/waypoint \
--header 'Content-Type: application/json' \
--data '{ "id": "example", "name": "example", "description": "example", "lat": 1, "lon": 1, "distance_from_start": 1, "icon": "example", "author": "example", "photos": [], "trail": "example" }'
Media type application/json
object
id

Optional custom ID (15 chars)

string
name
string
description
string
lat
required
number
>= -90 <= 90
lon
required
number
>= -180 <= 180
distance_from_start
number
icon
string
author
required

Author user ID (15 chars)

string
photos
Array<string>
default:
trail
string

Waypoint created

Media type application/json
object
id
required

Waypoint ID (15 chars)

string
name
string
description
string
lat
required
number
>= -90 <= 90
lon
required
number
>= -180 <= 180
distance_from_start

Distance from trail start in meters

number
icon

Icon identifier

string
author
required

Author user ID (15 chars)

string
photos
Array<string>
trail

Trail ID (15 chars)

string
created
string format: date-time
updated
string format: date-time
Example generated
{
"id": "example",
"name": "example",
"description": "example",
"lat": 1,
"lon": 1,
"distance_from_start": 1,
"icon": "example",
"author": "example",
"photos": [
"example"
],
"trail": "example",
"created": "2026-04-15T12:00:00Z",
"updated": "2026-04-15T12:00:00Z"
}

Bad Request

Internal Server Error