Return job data for an asynchronous operation#
Deprecated
This endpoint is deprecated and may be removed in a future release.
This endpoint was deprecated on 2026-02-12.
It is scheduled for sunset on 2029-01-31.
Description#
Returns all job data for an asynchronous operation.
GET /spreadsheets/v1/queue-jobs/{jobId}
Required OAuth Scopes
data_tables|r
Parameters#
Parameter |
In |
Type |
Required |
Description |
|---|---|---|---|---|
X-Version |
header |
string |
false |
Version of the API (2022-01-01) |
jobId |
path |
string |
true |
A unique identifier for an asynchronous job |
Code Samples#
curl -X GET https://api.app.wdesk.com/spreadsheets/v1/queue-jobs/{jobId} \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}' \
-H 'X-Version: 2022-01-01'
http GET https://api.app.wdesk.com/spreadsheets/v1/queue-jobs/{jobId} \
X-Version:2022-01-01 \
Accept:application/json \
Authorization:"Bearer {access-token}"
wget --method=GET "https://api.app.wdesk.com/spreadsheets/v1/queue-jobs/{jobId}" \
--output-document - \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {access-token}' \
--header 'X-Version: 2022-01-01'
import requests
headers = {
'X-Version': '2022-01-01',
'Accept': 'application/json',
'Authorization': 'Bearer {access-token}'
}
r = requests.get('https://api.app.wdesk.com/spreadsheets/v1/queue-jobs/{jobId}', headers = headers)
print(r.json())
Returns#
200 - OK#
Returns a JSON object with a data property. data contains a Job object with details about the requested job.
303 - See Other#
Returns a JSON object with a data property. data contains a Job object with details about the requested job.
400 - Bad Request#
An ErrorResponse object containing a message and list of errors.
403 - Forbidden#
An ErrorResponse object containing a message and list of errors.
404 - Not Found#
An ErrorResponse object containing a message and list of errors.
410 - Gone#
No content returned.
422 - Unprocessable Entity#
An ErrorResponse object containing a message and list of errors.
500 - Internal Server Error#
An ErrorResponse object containing a message and list of errors.
Example Responses#
{
"data": {
"created": "2020-04-30T14:23:21.690124Z",
"finished": "2020-04-30T14:23:22.413304132Z",
"id": "bd9iOjhlYmViZDY2YjdkYzQzMHU5NmU5MWQ4YzRjMTNiOWYwOjI",
"next_url": "https://api.app.wdesk.com/spreadsheets/v1/queue-jobs/bd9iOjhlYmViZDY2YjdkYzQzMHU5NmU5MWQ4YzRjMTNiOWYwOjI",
"status": "SUCCESSFUL"
},
"request_id": "d6a6ce3f-f120-4104-9587-a5a2dc45626c"
}