Delete a single file

Description

Unstages the file with the provided ID. The file must have a STAGED status; if the file isn’t STAGED, returns a 409 status. If the file isn’t found, this is a no-op.

DELETE /api/v1/file/{fileId}

Required OAuth Scopes

No OAuth scopes are required to use this endpoint.

Parameters

Parameter	In	Type	Required	Description
fileId	path	string	true	The unique identifier of the file

Code Samples

curl

curl -X DELETE https://h.app.wdesk.com/s/wdata/prep/api/v1/file/{fileId} \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer {access-token}'

httpie

http DELETE https://h.app.wdesk.com/s/wdata/prep/api/v1/file/{fileId} \
    Accept:application/json \
    Authorization:"Bearer {access-token}"

wget

wget --method=DELETE "https://h.app.wdesk.com/s/wdata/prep/api/v1/file/{fileId}" \
    --output-document -  \ 
    --header 'Accept: application/json' \ 
    --header 'Authorization: Bearer {access-token}'

python

import requests

headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.delete('https://h.app.wdesk.com/s/wdata/prep/api/v1/file/{fileId}', headers = headers)

print(r.json())

Returns

200 - OK

Returns a JSON object containing a body property, which contains the ID of the deleted resource.

Example Responses

OK

{
  "body": "string",
  "code": "integer"
}