What is the Melonly API?
The Melonly API lets your own bots and tools work with your server. You can read your logs, shifts, infractions, leave and more, and create or change them too.
Anything you do through the API works just like doing it in Melonly. If your bot creates a log, it's posted to your log channel and the player gets their DM, exactly as if a staff member had logged it from the Mod Panel.
What Can I Build?
| Idea | Endpoints you'd use |
|---|---|
| A Discord command that logs a punishment | Members, Logs |
| A "who's on shift" status board | Shifts |
| A bot that starts and ends shifts from Discord | Shifts |
| A staff lookup that shows someone's record | Logs, Infractions |
| A leave request form on your own website | Leave of Absence |
| A dashboard for your CAD | CAD |
Quick Start
- Create a Token
In your dashboard, go to Settings, then Server API Tokens, and click Create token. See Server API Tokens.
- Make Your First Request
Send the token in the
Authorizationheader. This gets your server's details: - Read the Response
You get your server back under
data:
Every request goes to https://api.melonly.com/api/v1, followed by the endpoint's path.
Try It in Your Browser
The API explorer lists every endpoint and lets you send requests with your token. It's built from the API itself, so it always matches what's live. The raw OpenAPI spec works with tools like Postman and code generators.
🧭 Quick Navigation
Authentication
Create a token and send it with your requests.
Making Requests
Responses, paging, sorting and IDs.
Errors
What went wrong, and what to do about it.
Rate Limits
How many requests you can make.
How Writes Work
Who a write runs as, and what happens after.
Examples
Ready-to-use code for common bot features.
Need help?
Still have questions? Join our Discord server for support from the Melonly Team.