Developers
Build on the Lesuto Disco Platform API
Search catalog, stream previews, issue sync licenses, and subscribe to webhooks — same surface Lesuto Chameleon uses.
Authentication
- Register via POST /api/v1/platforms/register or contact partnerships for sandbox credentials.
- 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 | /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.
Need credentials?
We provision sandbox platforms with scoped API keys and walk through your first license call.