ROCKITPLAY API
  1. Tasks
ROCKITPLAY API
  • ROCKIT Edge - Admin API
    • Minimal Tests
      • ping
      • submit test task
    • Admin Edge Organizations
      • Create Organization
      • Delete Organization
  • ROCKIT Edge - Backend API
    • Backend Edge Organizations
      • Create Organization
      • Delete Organization
    • Authentication
      • user login
      • authentication
    • Account Management
      • get user details
      • list users
      • Modify user
      • delete users
      • Create User / Create Machine User
    • Deployments
      • Creating Deployments
      • Get Deployments
      • Get Deployment Details
      • Modify Deployment
      • Deleting Deployments
    • Apps
      • Creating Apps
      • Import native builds
      • App Details
      • List Apps
      • patch app
      • Delete Apps
    • Triggers
      • Process Traces
      • Retry Task
    • Tasks
      • Listing Tasks
        GET
      • Task Details
        GET
      • Acknowledge Warning / Expire Task
        PATCH
    • Subscriptions
      • Subscribe
      • List Subscriptions
      • Unsubscribe
    • Roles
      • List Roles
      • Create Role
      • Patch Role
      • Role Details
      • Delete Roles
  • Changelog
    • Changelog
  1. Tasks

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 Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
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
Previous
Listing Tasks
Next
Acknowledge Warning / Expire Task
Built with