Skip to Main Content
Categories General Request
Created by Dmitry Kokurin
Created on Sep 17, 2025

Upload & Metadata Management API

Problem: High-friction manual process for producers uploading multiple beats at scale—repetitive entry of title, BPM, key, tags, collaborators, licensing tiers, and artwork across sessions. Increases error rate and slows catalog growth.

Proposed Minimal Endpoints:

Auth: Personal API key or OAuth token (scoped to own catalog).

POST /beats: create beat (title, BPM, key, tags[], collaborators[], licensing info, visibility draft/published, sample info, upload WAV/MP3/STEMS (file or link to cloud storage), artwork (file or link)).

PATCH /beats/{id}: update files & metadata (tags, key, BPM, pricing config).

GET /beats/{id}: returns canonical URLs + license options status.
Future (optional): stats (plays, purchases), bulk operations, webhook on publish.

Value:

Faster, consistent cataloging → more high-quality inventory.

Lower UI load (fewer manual sessions).

Enables professional workflows, scheduling, and integration with creator CRMs / mailing tools.

Encourages deeper licensing adoption (fewer missed metadata fields).

Safeguards:

Strict rate limits; only own content; no mass retrieval of others’ data.

Logging + revokable keys.