Retrieve a single operation

Table Of Contents

Retrieve a single operation#

Description#

Retrieves an operation given its ID. Poll this endpoint to follow the progress of a long-running request such as an issue export.

Note: This endpoint is rate-limited. You may experience rates as low as 1 request per second. When polling for updates, examine the Retry-After header and retry after that many seconds.

GET /operations/{operationId}

Required OAuth Scopes

No OAuth scopes are required to use this endpoint.

Parameters#

Parameter	In	Type	Required	Description
X-Version	header	string	true	Version of the API (2026-09-01.grc.preview)
operationId	path	string	true	The unique identifier of the operation

Code Samples#

curl

curl -X GET https://api.app.wdesk.com/operations/{operationId} \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer {access-token}' \
    -H 'X-Version: 2026-09-01.grc.preview'

httpie

http GET https://api.app.wdesk.com/operations/{operationId} \
    X-Version:2026-09-01.grc.preview \
    Accept:application/json \
    Authorization:"Bearer {access-token}"

wget

wget --method=GET "https://api.app.wdesk.com/operations/{operationId}" \
    --output-document - \
    --header 'Accept: application/json' \
    --header 'Authorization: Bearer {access-token}' \
    --header 'X-Version: 2026-09-01.grc.preview'

python

import requests

headers = {
  'X-Version': '2026-09-01.grc.preview',
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api.app.wdesk.com/operations/{operationId}', headers = headers)

print(r.json())

Returns#

200 - OK#

Returns an Operation object containing details about the requested Operation

400 - The request was invalid.#

Error response indicating the service could not process the request.

401 - Authentication is missing or invalid.#

Error response indicating the service could not process the request.

403 - The caller is not permitted to access this resource.#

Error response indicating the service could not process the request.

404 - The requested resource was not found.#

Error response indicating the service could not process the request.

429 - The rate limit has been exceeded.#

Error response indicating the service could not process the request.

500 - An unexpected error occurred.#

Error response indicating the service could not process the request.

503 - Service Unavailable#

Error response indicating the service could not process the request.

Example Responses#

OK

{
  "created": {
    "dateTime": "2019-10-28T15:03:27Z"
  },
  "id": "129g274495354cf18edb6b3ea3d023b2",
  "originalRequest": "7bee78f7-417b-42bc-ace9-e588c65d19bf",
  "status": "started",
  "updated": {
    "dateTime": "2019-10-28T15:04:20Z"
  }
}

The request was invalid.

{
  "code": "invalidFilter",
  "message": "The $filter value could not be parsed.",
  "target": "$filter"
}

Authentication is missing or invalid.

{
  "code": "unauthenticated",
  "message": "Authentication credentials were missing or invalid."
}

The caller is not permitted to access this resource.

{
  "code": "permissionDenied",
  "message": "You do not have permission to access this resource."
}

The requested resource was not found.

{
  "code": "notFound",
  "message": "No resource with this id was found."
}

The rate limit has been exceeded.

{
  "code": "rateLimitExceeded",
  "message": "Rate limit exceeded. Retry after the period indicated in the response headers."
}

An unexpected error occurred.

{
  "code": "internalError",
  "message": "An unexpected error occurred. Please try again later."
}

Service Unavailable

{
  "code": "503ServiceUnavailable",
  "message": "The server cannot handle the request due to a temporary overload or scheduled maintenance"
}