Skip to content
moxon home

Changelog

Migration Guide

Use api.moxon.dev/latest to always point to the latest version:

https://api.moxon.dev/latest/infos
https://api.moxon.dev/latest/evaluate

Nested paths and query strings are preserved through the redirect:

https://api.moxon.dev/latest/chat/private?session=abc
# redirects to /v6/chat/private?session=abc

The redirect works for any HTTP method (GET, POST, PATCH, DELETE...) via a 307 Temporary Redirect, which preserves the original method and body — so POST /latest/token redirects to POST /v6/token with its body intact.

Tip

Most HTTP clients don't follow redirects by default. With curl, add the -L (--location) flag, or you'll get the 307 response without ever reaching /v6.

Manual Migration

Replace all occurrences of /v5/ with /v6/ in your API requests:

# Before
https://api.moxon.dev/v5/infos

# After
https://api.moxon.dev/v6/infos

Migrating from @20syldev/api

The @20syldev/api package becomes @moxon/api and no longer evolves. The exports and the /v6 HTTP API are unchanged: migrating only takes a rename.

npm uninstall @20syldev/api
npm install @moxon/api

Then replace the package name in your imports. The sub-paths are identical:

- import { evaluate } from '@20syldev/api/v6';
+ import { evaluate } from '@moxon/api/v6';
BeforeAfter
@20syldev/api@moxon/api
@20syldev/api/v4@moxon/api/v4
@20syldev/api/v5@moxon/api/v5
@20syldev/api/v6@moxon/api/v6
@20syldev/api/server@moxon/api/server

The @moxon/api/manifest sub-path is new and experimental: see the Manifest page. Experimental

Versions v1 to v3

v1, v2 and v3 were retired in 6.0.0. They remain available only through @20syldev/api@5.9.0.

Endpoint Compatibility

v6 is not a drop-in replacement for v5. Five endpoints changed method or path, the captcha changed its default mode, and the status field of error responses changed type. Read the 6.0.0 changelog before migrating.

What changedv5v6
Clear a private chatDELETE /chat/:tokenPOST /chat/clear
Play a move (body)POST /tic-tac-toePOST /tic-tac-toe/play
Play a move (URL)PATCH /tic-tac-toe/:gamePOST /tic-tac-toe/play
Forfeit a gameDELETE /tic-tac-toe/:gamePOST /tic-tac-toe/forfeit
Compare two stringsGET /levenshteinPOST /levenshtein
Captcha default modeimagechallenge
status in error responsesstring ("400")number (400)

/hyperplanning is deprecated and no longer listed in v6; it still answers, and disappears in 7.0.0.

Previous Versions