Device Jobs

Create a device job / install an APK¶

Role: Standard and above.

Send the request as multipart/form-data, for example curl -F mobileId=12 -F file=@app.apk. The job runs asynchronously; poll it with GET /api/v2/deviceJobs/{id}.

Parameters

Name	Description
mobileId *	Numeric ID of the Mobile Device to install the app on. Type: integer (form data)
file *	The APK file. Type: file (form data)

Responses

Code Description

201

The job was created and waits for the device's Test Node. status is PENDING, IN_PROGRESS, DONE or FAILED; resultMessage explains a failure.

Media type: application/json

Example Value:

{
"id": "3f1c2a9e-8b1d-4c6a-9a55-2f0e7c1d4b10",
"mobileId": 0,
"jobType": "INSTALL_APP",
"fileName": "app.apk",
"status": "PENDING",
"resultMessage": "string",
"createdAt": "2026-09-23T10:00:00Z",
"updatedAt": "2026-09-23T10:00:00Z"
}

400

The device has no Test Node assigned.

404

The Mobile Device does not exist.

List device jobs¶

Role: Standard and above.

Parameters

Name	Description
mobileId	Only the jobs of this Mobile Device. Type: integer (query)
status	Only jobs in this status: `PENDING`, `IN_PROGRESS`, `DONE` or `FAILED`. Type: string (query)

Responses

Code

Description

200

The jobs as a plain JSON array (no paging), newest first.

Media type: application/json

Example Value:

[
    {
        "id": "3f1c2a9e-8b1d-4c6a-9a55-2f0e7c1d4b10",
        "mobileId": 0,
        "jobType": "INSTALL_APP",
        "fileName": "app.apk",
        "status": "PENDING",
        "resultMessage": "string",
        "createdAt": "2026-09-23T10:00:00Z",
        "updatedAt": "2026-09-23T10:00:00Z"
    }
]

Get one device job's status¶

Role: Standard and above.

Parameters

Name	Description
id *	The job ID, a UUID string. Type: string (path)

Responses

Code Description

200

The job. status is PENDING, IN_PROGRESS, DONE or FAILED; resultMessage explains a failure.

Media type: application/json

Example Value:

{
"id": "3f1c2a9e-8b1d-4c6a-9a55-2f0e7c1d4b10",
"mobileId": 0,
"jobType": "INSTALL_APP",
"fileName": "app.apk",
"status": "PENDING",
"resultMessage": "string",
"createdAt": "2026-09-23T10:00:00Z",
"updatedAt": "2026-09-23T10:00:00Z"
}

404

Resource was not found.