Image update

Warning: The API documentation here is for Managed Game Server Hosting (Clanforge). If you’re using Game Server Hosting (Multiplay), refer to the Game Server API documentation.

Update the game image identified by <imageid> with the details passed through the parameters.

Check out the S3 example URL.

https://api.multiplay.co.uk/cfp/v1/image/<imageid>/update

METHOD

CONTENT TYPE
GETapplication/x-www-form-urlencoded

Request parameters

VARIABLEDESCRIPTIONOPTIONAL
accountserviceidThe <accountserviceid> parameter accepts an account service ID (ASID) associated with the specified resource. The credentials in the request header must have access to the ASID to perform the request.No
imageidThe <imageid> parameter accepts a game image ID representing the game image to update.No
activeThe <active> parameter accepts a boolean value that controls whether the game image associated with <imageid> is active or not.

If set to 1, the game image is activated.

If set to 0, the game image is deactivated.

No

Response fields

FieldTypeDescriptionOptional
activeintegerIndicating the state of the image, for example: 1, 0No
created_atstringTime at which the allocation was createdNo
updated_atstringTime at which the allocation was updatedNo
updated_byintegerID of the user that requested image updateNo
latestversionidintegerID of the latest image versionNo
imageidintegerID of the imageNo
pathstringPath to the game filesNo
created_byintegerID of the user that created the imageNo
gameversionidintegerID of the game versionNo

Example request

curl --location -g 'https://api.multiplay.co.uk/cfp/v1/image/<imageid>/update?accountserviceid=<accountserviceid>&active=<active>' \
--header 'Authorization: Basic YOUR_AUTH_CREDENTIALS'

Example response

{
    "image": {
        "active": <active>,
        "created_at": <created_at>,
        "updated_at": <updated_at>,
        "updated_by": <updated_by>,
        "latestversionid": <latestversionid>,
        "imageid": <imageid>,
        "path": <path>,
        "created_by": <created_by>,
        "gameversionid": <gameversionid>
    }
}