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.

401 - Unauthorized#

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"
}