Task Details

GET

https://Example-Server.com/be/v1/tasks/{taskName}

Last modified:2025-05-08 12:00:04

This endpoint allows you to list details of a specific task, including status and exceptions.

Required Permissions

tasks.read

See Roles for more details.

Request

Path Params

Header Params

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://Example-Server.com/be/v1/tasks/' \
--header 'x-rockit-beauth-token: eyjhvcIhvds;huVODV...' \
--header 'x-rockit-orgname: ExampleOrg' \
--header 'x-rockit-username: adminPrincipal' \
--header 'x-rockit-api-key: {{_adminPrincipal_apiKey}}'

Responses

🟢200OK

application/json

Body

Example

{
    "status": "success",
    "task": {
        "name": "ExampleOrg-sushi-0003-1739273968-dltar",
        "appName": "sushi",
        "buildName": "0003",
        "taskType": "dltar",
        "status": "failed",
        "steps": {
            "created": "2025-02-11T11:39:31.541Z",
            "started": "2025-02-11T11:40:16.504Z",
            "finished": "2025-02-11T11:40:52.577Z"
        },
        "userData": {
            "dltar": {
                "url": "https://rockitplay-demo.akamaized.net/engine-fixtures/sushi/native-build.tar?token=exp=2041235666~acl=/engine-fixtures/sushi/*~hmac=df869da8c71a05f6a77ee7ed5a5902abd76e22734953d976973d6748d14beaf4",
                "sizeBytes": 1788272645
            }
        },
        "alert": {
            "exception": {
                "httpDownloadFailed": {
                    "sizeBytesActual": 178827264,
                    "sizeBytesExpected": 1788272645
                }
            }
        }
    }
}

🟠400400: missing-param

🟠401401: token-expired

Modified at 2025-05-08 12:00:04

Listing Tasks

Acknowledge Warning / Expire Task

Task Details

Required Permissions#

Request

Request samples

Responses

Required Permissions