Changelog

The two surfaces are versioned differently: the REST API by its URL prefix (see API versioning), the MCP server by a semantic version (see MCP versioning). Both are listed here, newest first. Deprecations are announced here before the headers start appearing.

REST API v1

The base URL is https://api.postal.music/api/v1. No route in v1 is currently deprecated; GET /api/v1/version is the live list.

2026-09-07

• New track versions routes under /tracks/{trackId}/versions: list, get, add from file or URL, activate, rename/relabel/hide, delete. GET /tracks/single gains activeVersionId and a versions summary.
• Every /api/v1 response now carries X-Postal-Api-Version.
• New GET /version (no key required) reporting the version, the newest version available, the build and any deprecated routes.
• Deprecated routes, when there are any, answer with Deprecation, Sunset and Link headers per RFC 9745 and RFC 8594.
• API key management moved in the app from Tools to Settings → Integrations.

2026-08-21

• New POST /tracks/search: natural-language search with constraints, seed and exclude lists. Uses the existing read:tracks scope; costs one credit per call.

2026-08-13

• New Platform API under /platform for partner reporting on file requests and sign-ups. Platform keys are issued by Postal, not self-service.

2026-06-12

• New /analytics/dashboard, /analytics/stats and /analytics/top (scope read:analytics).
• New /briefs and /briefs/:id/submissions (scope read:briefs).
• New /tracks/duplicates and /tracks/submissions (scope read:tracks).
• Keys created with an explicit scope list need the two new scopes added to use the new routes; keys created without a scope list have them already.

2026-03

• v1 launched: tracks, tagging, playlists, composers, taxonomy, cover art, scoped API keys and signed webhooks.

MCP server

Deployed at https://mcp.postal.music/mcp; the running version is at /health.

1.6.0 — 2026-09-07

• Five track-version tools: list_track_versions, upload_track_version, activate_track_version, update_track_version, delete_track_version. 39 tools.

1.5.0 — 2026-09-07

• /health and /tools report apiVersion; /tools also carries version.
• The server sends instructions on initialize naming its version and the stability guarantees.
• Deprecated-tool convention introduced (a [Deprecated — removed in …] description prefix). No tool is deprecated today.
• 34 tools, unchanged from 1.4.1.

1.4.1 — 2026-09-02

• Moved to Cloudflare Workers with stateless Streamable HTTP.
• Compact track objects include the era, character and movement tag groups.

1.4.0 — 2026-09-01

• Production release of the 1.2.0 and 1.3.0 changes below.
• Six read tools accept detail: "full"; mutations return { ok: true } confirmations.

1.3.0 — 2026-08-21

• New search_tracks.

1.2.0 — 2026-06-12

• Compact responses by default with a detail parameter.
• New get_dashboard, get_entity_stats, get_top_tracks, find_duplicate_tracks, get_track_submissions, list_briefs and get_brief_submissions.

1.1.0 — 2026-06-10

• Public GET /tools catalog.
• Direct X-API-Key authentication alongside OAuth.

1.0.0 — 2026-03-30

• First release: tracks, tagging, playlists, taxonomy, artwork and composer tools over Streamable HTTP with OAuth 2.1.

Changes to either surface are also announced on postal.music/release-notes.