Skip to content

Upload and parse GPX file as trail

PUT
/api/v1/trail/upload

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

object
file
string format: binary
name
string
ignoreDuplicates
boolean

Trail created from GPX

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

Bad Request - Invalid or empty GPX file

Internal Server Error