Skip to content
wanderer Documentation
Search
Ctrl
K
Cancel
GitHub
Select theme
Dark
Light
Auto
Welcome to wanderer
Using wanderer
Authentication
Create/Edit a trail
Categories
Summit logs
Merge trails
Interact with the community
Share trails
Lists
Statistics
Customize the map
Import/Export
Plugins
Running wanderer
Installation
Quickstart
Manual Docker Setup
Install from Source
Plugin installation
Environment configuration
Frontend configuration
Edit the "About" section
Backend configuration
Overview
SMTP
Authentication Providers
Backing up your server
Custom categories
Adjust Filesize Limits
Develop wanderer
Local development
API
Federation
Plugin System
API Reference
Overview
Waypoints
List waypoints
Create waypoint
Get waypoint
Update waypoint
Delete waypoint
Upload waypoint file
Valhalla
Get route data
Get elevation data
Categories
List current user's subcategory preferences
Create or update a subcategory preference
Reorder current user's subcategory preferences for one category
List current user's category preferences
Create or update a category preference
Reorder current user's category preferences
List subcategories
List categories
Users
Create user (sign up)
Get user by ID
Update user
Delete user
Upload user file
Trail Shares
List trail shares
Create trail share
Get trail share
Update trail share
Delete trail share
Trail Merge
Merge trails
Suggest merge target or duplicate groups
Trail Link Shares
List trail link shares
Create trail link share
Get trail link share
Update trail link share
Delete trail link share
Trail Likes
List trail likes
Create trail like
Delete trail like by actor and trail
Get trail like
Delete trail like
Trails
List trails
Create trail
Upload and parse GPX file as trail
Get trail recommendations
Create trail with file upload
Update trail with file upload
Get trail filter values
Download file from URL
Get trail bounding box
Get trail
Upload trail file
Get trail comments
Tags
List tags
Create tag
Get tag
Update tag
Delete tag
Summit Logs
List summit logs
Create summit log
Create summit log with file upload
Update summit log with file upload
Get summit log
Update summit log
Delete summit log
Upload summit log file
Settings
Create settings
Get settings
Update settings
Delete settings
Search
Multi-index search
Search actors
Search Meilisearch index
Profiles
Get user profile
Search user trails
Get user summit statistics
Search user lists
Get profile follows
Get user activity feed
Plugins
Send trail through plugin
List installed plugins
Start plugin OAuth flow
Revoke plugin OAuth credentials
Complete plugin OAuth flow
Preview plugin category remap
Apply plugin category remap
Validate plugin session auth
List plugin instances
Create plugin instance
Get plugin instance
Update plugin instance
Delete plugin instance
Notifications
List notifications
Update notification
List Shares
List list shares
Create list share
Get list share
Update list share
Delete list share
Lists
List all lists
Create list
Create list with file upload
Update list with file upload
Get list
Update list
Delete list
Upload list file
Follows
List follows
Delete follow
Files
Download file
Feed
Get activity feed
Comments
List comments
Get comment
Update comment
Delete comment
Authentication
Request password reset
List OAuth providers
Authenticate user
Confirm password reset
API Tokens
List API tokens
Create API token
Delete API token
ActivityPub
Get ActivityPub actor profile
Get ActivityPub outbox collection
Receive ActivityPub activities
Get ActivityPub following collection
Get ActivityPub followers collection
Get ActivityPub trail
Get ActivityPub comment
Get ActivityPub activity
Changelog
GitHub
Select theme
Dark
Light
Auto
Overview
Wanderer API
0.20.0
Section titled “Wanderer API 0.20.0”
API documentation for wanderer backend
Information
OpenAPI version:
3.0.0
Operations
Section titled “Operations”
GET
/api/v1/waypoint
PUT
/api/v1/waypoint
GET
/api/v1/waypoint/{id}
POST
/api/v1/waypoint/{id}
DELETE
/api/v1/waypoint/{id}
POST
/api/v1/waypoint/{id}/file
POST
/api/v1/valhalla/route
POST
/api/v1/valhalla/height
GET
/api/v1/user-subcategory-preference
PUT
/api/v1/user-subcategory-preference
POST
/api/v1/user-subcategory-preference/reorder
GET
/api/v1/user-category-preference
PUT
/api/v1/user-category-preference
POST
/api/v1/user-category-preference/reorder
GET
/api/v1/subcategory
GET
/api/v1/category
PUT
/api/v1/user
GET
/api/v1/user/{id}
POST
/api/v1/user/{id}
DELETE
/api/v1/user/{id}
POST
/api/v1/user/{id}/file
GET
/api/v1/trail-share
PUT
/api/v1/trail-share
GET
/api/v1/trail-share/{id}
POST
/api/v1/trail-share/{id}
DELETE
/api/v1/trail-share/{id}
POST
/api/v1/trail-merge
POST
/api/v1/trail-merge/suggest
GET
/api/v1/trail-link-share
PUT
/api/v1/trail-link-share
GET
/api/v1/trail-link-share/{id}
POST
/api/v1/trail-link-share/{id}
DELETE
/api/v1/trail-link-share/{id}
GET
/api/v1/trail-like
PUT
/api/v1/trail-like
POST
/api/v1/trail-like/delete
GET
/api/v1/trail-like/{id}
DELETE
/api/v1/trail-like/{id}
GET
/api/v1/trail
PUT
/api/v1/trail
PUT
/api/v1/trail/upload
GET
/api/v1/trail/recommend
PUT
/api/v1/trail/form
POST
/api/v1/trail/form/{id}
GET
/api/v1/trail/filter
POST
/api/v1/trail/download
GET
/api/v1/trail/bounding-box
GET
/api/v1/trail/{id}
POST
/api/v1/trail/{id}/file
GET
/api/v1/trail/{id}/comment
GET
/api/v1/tag
PUT
/api/v1/tag
GET
/api/v1/tag/{id}
POST
/api/v1/tag/{id}
DELETE
/api/v1/tag/{id}
GET
/api/v1/summit-log
PUT
/api/v1/summit-log
PUT
/api/v1/summit-log/form
POST
/api/v1/summit-log/form/{id}
GET
/api/v1/summit-log/{id}
POST
/api/v1/summit-log/{id}
DELETE
/api/v1/summit-log/{id}
POST
/api/v1/summit-log/{id}/file
PUT
/api/v1/settings
GET
/api/v1/settings/{id}
POST
/api/v1/settings/{id}
DELETE
/api/v1/settings/{id}
POST
/api/v1/search/multi
GET
/api/v1/search/actor
POST
/api/v1/search/{index}
GET
/api/v1/profile/{handle}
POST
/api/v1/profile/{handle}/trails
GET
/api/v1/profile/{handle}/stats
POST
/api/v1/profile/{handle}/lists
GET
/api/v1/profile/{handle}/follows
GET
/api/v1/profile/{handle}/feed
POST
/api/v1/plugin-system/trail-send
GET
/api/v1/plugin-system/plugins
POST
/api/v1/plugin-system/oauth/start
POST
/api/v1/plugin-system/oauth/revoke
POST
/api/v1/plugin-system/oauth/callback
POST
/api/v1/plugin-system/category-remap/preview
POST
/api/v1/plugin-system/category-remap/apply
POST
/api/v1/plugin-system/auth/validate
GET
/api/v1/plugin-instance
PUT
/api/v1/plugin-instance
GET
/api/v1/plugin-instance/{id}
POST
/api/v1/plugin-instance/{id}
DELETE
/api/v1/plugin-instance/{id}
GET
/api/v1/notification
POST
/api/v1/notification/{id}
GET
/api/v1/list-share
PUT
/api/v1/list-share
GET
/api/v1/list-share/{id}
POST
/api/v1/list-share/{id}
DELETE
/api/v1/list-share/{id}
GET
/api/v1/list
PUT
/api/v1/list
PUT
/api/v1/list/form
POST
/api/v1/list/form/{id}
GET
/api/v1/list/{id}
POST
/api/v1/list/{id}
DELETE
/api/v1/list/{id}
POST
/api/v1/list/{id}/file
GET
/api/v1/follow
DELETE
/api/v1/follow/{id}
GET
/api/v1/files/{collection}/{record}/{file}
GET
/api/v1/feed
GET
/api/v1/comment
GET
/api/v1/comment/{id}
POST
/api/v1/comment/{id}
DELETE
/api/v1/comment/{id}
POST
/api/v1/auth/reset
GET
/api/v1/auth/oauth
POST
/api/v1/auth/login
POST
/api/v1/auth/confirm-reset
GET
/api/v1/api-token
PUT
/api/v1/api-token
DELETE
/api/v1/api-token/{id}
GET
/api/v1/activitypub/user/{handle}
GET
/api/v1/activitypub/user/{handle}/outbox
POST
/api/v1/activitypub/user/{handle}/inbox
GET
/api/v1/activitypub/user/{handle}/following
GET
/api/v1/activitypub/user/{handle}/followers
GET
/api/v1/activitypub/trail/{id}
GET
/api/v1/activitypub/comment/{id}
GET
/api/v1/activitypub/activity/{id}