Delete File

URL:: https://dataaccess/notebookworkspace/deleteFile
Methods:: POST
Required Capability:: Access allowed with the "Create and edit notebooks" privilege
Version Introduced:: 11.5

Description

Attention

Accessing the dataaccess resource, and any of its sub-operations and resources, redirects users to the Notebook Services Admin API Directory. These endpoint are accessible using the following URL pattern:

Use dark colors for code blocksCopy
https://organization.example.com/<context>/notebooks/admin/dataacess/<....>

To return to the Enterprise Admin API directory, users should modify their URLs in the following way:

Use dark colors for code blocksCopy
https://organization.example.com/<context>/admin

The deleteFile operation allows a user to permanently remove a file from their notebook workspace directory (/arcgis/home). Only the owner of the file is allowed to perform this operation.

Request parameters

Parameter Details

Parameter	Details
`fileName` (Required)	The name of the file to be deleted. Example Use dark colors for code blocksCopy `1 2 3 4 5 6 7 8 //Delete a file from the root directory fileName=mjwaterzip //Delete a file from a subdirectory fileName=hydrology/mjwaterzip //Delete a file from a nested subdirectory fileName=hydrology/2020/mjwaterzip`
`f`	The response format. The default response format is `html`. Values: `html` \| `json` \| `pjson`

fileName

(Required)

The name of the file to be deleted.

Example
Use dark colors for code blocksCopy
//Delete a file from the root directory
fileName=mjwaterzip

//Delete a file from a subdirectory
fileName=hydrology/mjwaterzip

//Delete a file from a nested subdirectory
fileName=hydrology/2020/mjwaterzip

f

The response format. The default response format is html.

Values: html | json | pjson

Example usage

The following is a sample POST request for the deleteFile operation that demonstrates deleting a file from a subdirectory:

Use dark colors for code blocksCopy
POST /<context>/notebooks/admin/dataaccess/notebookworkspace/deleteFile HTTP/1.1
Host: organization.example.com
Content-Type: application/x-www-fprm-urlencoded
Content-Length: []

fileName=hydrology/mjwater.zip&f=pjson&token=PuuxoDV8HzHD1GxXUDpgHDeItErtl9Wr6rbULdhXHVUnGsjZ2hI1j1cPmnDEN1UnUfDqrNr2AuviTe5OkBumXsPlwSCrKw_ZVM1vczv2ziRESyz2PEAAhfsf71EyKIEGe7wW1z7hN_aLIjTekcdUbs-xtUAMZjEKHDRxT85NlfWqQghOy6o5XE54P8nnmdhllY6IfdtqeRtOYfFLoCBGCmOFV8diNVk4CxW3MMnzelDAGuRpN-Bru-vcYTY-7Or9

JSON Response syntax

Use dark colors for code blocksCopy
{"status": "<success | failure>"}

JSON Response example

Use dark colors for code blocksCopy
{"status": "success"}