Use this call to delete or cancel an initiated read request. This removes all the pages from the file store and stops the ongoing read request.

This cleans up temporary read requests after the integration has finished downloading the data, or cancels a request that is no longer needed.

Notes:

  • To use this call, you must be a Workspace Administrator.
  • As a best practice, use this call to clear all pages from completed exports as soon as you download all pages. Doing so will make space available for future exports.
  • An expiration timer starts after the read request is initiated, with the following conditions:
    • 30 minutes after no activity is recorded for that read request, the system will reclaim that space.
    • The expiration timer resets back to 30 minutes if the requested page number is divisible by 100, including page 0.

Request supporting this feature

curl -X DELETE 'https://api.anaplan.com/2/0/workspaces/{workspaceId}/models/{modelId}/views/{viewId}/readRequests/{requestId}' \
-H 'Authorization: AnaplanAuthToken {anaplan_auth_token}' \
-H 'Accept: application/json'

Method and endpoint

DELETE

/workspaces/{workspaceId}/models/{modelId}/views/{viewId}/readRequests/{requestId}

Request parameters

ParametersDetails
{workspaceId}
  • Required in the first supported request (see Requests supporting this feature)
  • Type: String
  • Description: The workspace ID
  • Example: 8a8196b15b7dbae6015b8694411d13fe
{modelId}
  • Required
  • Type: String
  • Description: The model ID
  • Example: 75A40874E6B64FA3AE0743278996850F
{viewId}
  • Required
  • Type: Number
  • Description: The view ID.
  • Example: 101000000001
{requestId}
  • Required
  • Type: String
  • Description: The request ID
  • Example: 0A06B0739F0E47BB92E2326C603D86EC

Curl example

curl -X DELETE 'https://api.anaplan.com/2/0/workspaces/{workspaceId}/models/{modelId}/views/{viewId}/readRequests/{requestId}' \
-H 'Authorization: AnaplanAuthToken {anaplan_auth_token}' \
-H 'Accept: application/json'

Response

Response headers

Accept: application/json

  • Optional
  • Description: This shows the preferred response is application/json format.

Response 200 body

When the delete request completes, the API returns this response:

{
   "meta": {
       "schema": "https://api.anaplan.com/2/0/objects/viewReadRequest"
   },
   "status": {
       "code": 200,
       "message": "Success"
   },
   "viewReadRequest": {
       "requestId": "0A06B0739F0E47BB92E2326C603D86EC",
       "viewId": 101000000014,
       "requestState": "CANCELLED",
       "url": "https://api.anaplan.com/2/0/workspaces/{workspaceId}/models/{modelId}/views/{viewIdƒ}/readRequests/{requestId}",
       "successful": true
   }
}

Group download list subset items

View these endpoints for further details on downloading list item subsets: