The ElevationHost API
List, check, start, stop and restart your servers from your own scripts, panels or a Discord bot.
Get a key
Log in, open the client area, Account tab, and create an API key under API keys. It starts with ehk_ and is shown once. A key can see and control the same servers you can, so keep it private. Delete it any time to cut it off.
Using it
Send the key in the Authorization header. Base address: https://elevationhost.net/api/v1. Replies are JSON. You can make up to 60 calls a minute per key.
curl https://elevationhost.net/api/v1/servers -H "Authorization: Bearer ehk_your_key"
Endpoints
| Call | What it does |
|---|---|
GET /me | Who the key belongs to. |
GET /servers | Your servers: id, name, type (game, web, vps, dedicated), plan, status, address. |
GET /servers/{id} | One server with its live state (running or stopped, CPU, memory) when available. |
POST /servers/{id}/power | Body {"action":"start"}. Actions: start, stop (clean shutdown), restart, kill (force off). |
curl -X POST https://elevationhost.net/api/v1/servers/SERVER_ID/power -H "Authorization: Bearer ehk_your_key" -H "Content-Type: application/json" -d '{"action":"restart"}'
Errors
Errors come back as {"error":"..."} with a status: 401 for a missing or wrong key, 404 for a server that is not yours, 429 for too many calls, 502 when the host could not do it.
Discord bot
We provide a small open bot you can run yourself that gives your community the commands /servers, /status, /start, /stop and /restart. It lives in the tools/discord-bot folder of the project and its README explains the four setup steps. Only the Discord users you list can use it.
Fair use
Do not share a key, and do not use the API to get around limits. We may disable keys that abuse it. See the Fair Use Policy.