Developers
Build on the Lesuto Disco Platform API
Search Maestro-tagged catalog, stream previews, issue sync licenses, and subscribe to webhooks. Same REST surface Lesuto Chameleon uses for Hub licensing.
Self-serve sandbox
Authentication
- Create a Developer sandbox below or POST /api/v1/platforms/register from your backend.
- POST /api/v1/auth/token with clientId and clientSecret.
- Use the Bearer JWT on subsequent requests. Scopes are intersected with your platform registry.
- Issue licenses with POST /api/v1/licenses when content publishes.
API capabilities
| Method | Endpoint | Scope | Purpose |
|---|---|---|---|
| POST | /oauth/token | - | Client credentials → platform JWT |
| GET | /tracks | tracks:read | Search by mood, genre, BPM, duration |
| GET | /tracks/{id}/stream | tracks:stream | Watermarked preview audio |
| POST | /licenses | licenses:write | Issue sync license per contentId |
| GET | /catalog/sync | tracks:read | Batch catalog import |
| POST | /partners/enrich | partners:enrich | Maestro BPM, key, mood, and embedding tags |
| POST | /usage-events | licenses:write | Report plays / impressions |
Outbound webhooks
track.approved, track.updated, track.takedown
Inbound webhooks
content.published, content.deleted
Licenses are issued for specified content types and territories through Lesuto Hub integrations or the Platform API. Browse and preview free on Disco; commercial use requires a valid license record.
Developer FAQ
Is there self-serve signup?
Yes - POST /api/v1/platforms/register creates a Developer tier platform with API key. Paid tiers use Stripe checkout or sales-assisted onboarding.
Where is the OpenAPI spec?
The v1 contract lives at docs.lesutodisco.com/reference/openapi and /openapi.v1.json.
What about stems for editors?
GET /tracks/{id}/stems requires Enterprise tier or a stems add-on entitlement. Listener stems are Phase 2.
Can Maestro enrich our catalog?
Yes. POST /api/v1/partners/enrich sends audio or metadata through Maestro Layer 1 analysis and returns BPM, key, mood, and embedding fields for your rows. See /platform/maestro for the engine map.
Need help integrating?
Read the quickstart or open the partner portal to view usage and configure webhooks.