Unreserve
Warning: The API documentation here is for Clanforge. If you’re using Multiplay Hosting, refer to the Multiplay Hosting API documentation.
Unreserve a game server by its <serverid>
on a specific machine.
You must issue this request from the dedicated game server itself when players leave or the game server is in an idle state. Both the machine ID and server ID are generated on Clanforge and passed through to the game server.
https://api.multiplay.co.uk/cfp/v1/machine/<machineid>/unreserve_server
METHOD | CONTENT TYPE |
GET | application/x-www-form-urlencoded |
Request parameters
VARIABLE | DESCRIPTION | OPTIONAL |
machineid | The <machineid> parameter accepts an identifier of a machine within a fleet. | No |
serverid | The <serverid> parameter accepts a game server instance ID of a game server on the specified machine. | No |
Response fields
Field | Type | Description | Optional |
---|---|---|---|
uuid | string | ID of the allocation | No |
Example request
curl --location --request GET 'https://api.multiplay.co.uk/cfp/v1/machine/<machineid>/unreserve_server?serverid=<serverid>' \
--header 'Authorization: Basic YOUR_AUTH_CREDENTIALS'\
--header 'Content-Type: application/x-www-form-urlencoded'
Example response
{
"success": <status>,
"messages": [],
"uuid": <uuid>
}