Skip to content
wanderer Documentation

Create trail with file upload

PUT
/api/v1/trail/form

Creates a new trail with file upload (GPX/photos) and date normalization

Request Body required

Section titled “Request Body required ”
object
id

Optional custom ID (15 chars)

string
name
required
string
>= 1 characters
author
required

Author user ID (15 chars)

string
description
string
location
string
date
string format: date
public
required
boolean
difficulty
string
Allowed values: easy moderate difficult
lat
number
>= -90 <= 90
lon
number
>= -180 <= 180
distance
number
elevation_gain
number
elevation_loss
number
duration
number
photos
Array<string>
default:
thumbnail
integer
like_count
integer
0
category
string
tags
Array<string>
default:
gpx
string

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Trail created

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

400

Section titled “400 ”

Bad Request

500

Section titled “500 ”

Internal Server Error