Create an image difference analysis

Last updated: May 29, 2026

Create an image difference analysis

Trigger an image difference analysis job, which reports differences between the latest version of the game image identified by `imageid` and the current state on `machineid`. **WARNING:** This endpoint uses HTTP GET but performs a state-changing operation. Do not cache or automatically retry this request.

Endpoint

GET /cfp/v1/imagediff/create

Query Parameters

Name

Type

Required

Description

imageid

integer

Yes

Game image ID of the game image to analyze.

machineid

integer

Yes

Machine ID of the machine on which to perform the difference analysis.

diffid

integer

No

If provided, Multiplay retries the specified difference analysis. The provided ID must identify a diff that is either complete or failed.

Example Request

curl -X GET "https://api.multiplay.dev/cfp/v1/imagediff/create?imageid=<imageid>&machineid=<machineid>&diffid=<diffid>" \
  -H "Authorization: Bearer <token>"

Responses

Status

Description

200

Image difference analysis initiated successfully.

400

401

403

500