Skip to main content

Get active task

Contributors netapp-ranuk

All of the requests made to the BlueXP REST API are processed asynchronously except those using the HTTP GET method. Each of these asynchronous requests is assigned a unique identifier which is returned to the caller in the response. You can use the request ID to retrieve information about the background task including its status.

1. Get the request identifier

After issuing any REST API call, the associated request identifier is returned in the X-Response_Id header. You must extract this value and use it in the path variable in the next step.

2. Get the task

HTTP method Resource path



curl example
curl --location --request GET '<REQUEST_ID>' --header 'Content-Type: application/json' --header 'x-agent-id: <AGENT_ID>' --header 'Authorization: Bearer <ACCESS_TOKEN>'
Input parameters

Path parameter that contains the request identifier <REQUEST_ID> for the original task.


The JSON output example includes the list of returned values. The status contains one of three values indicating the status of the task.

Status Description


The asynchronous task completed successfully.


The background task is still running and has not completed.


The asynchronous task completed but failed.

JSON output example
    "status": 0,
    "closeTime": -2147483648,
    "actionName": "Create Vsa Working Environment",
    "error": null