Skip to content

Upload and parse GPX file as trail

PUT
/api/v1/trail/upload
curl --request PUT \
--url https://example.com/api/v1/trail/upload \
--header 'Content-Type: multipart/form-data' \
--form file=@file \
--form name=example \
--form ignoreDuplicates=true

Uploads a GPX file, parses it to extract trail data, performs duplicate detection, and indexes in search

Media type multipart/form-data
object
file
string format: binary
name
string
ignoreDuplicates
boolean

Trail created from GPX

Media type application/json
object
id
required

Trail ID (15 chars)

string
name
required

Trail name

string
description
string
location
string
author
required

Author user ID

string
date
string format: date
public
required
boolean
difficulty
string
Allowed values: easy moderate difficult
lat
number
>= -90 <= 90
lon
number
>= -180 <= 180
distance

Distance in meters

number
elevation_gain

Elevation gain in meters

number
elevation_loss

Elevation loss in meters

number
duration

Duration in seconds

number
photos
Array<string>
thumbnail

Index of thumbnail photo

integer
like_count
integer
0
category

Category ID (15 chars)

string
tags
Array<string>
gpx

GPX file path

string
created
string format: date-time
updated
string format: date-time
Example
{
"difficulty": "easy",
"like_count": 0
}

Bad Request - Invalid or empty GPX file

Internal Server Error