Delete User Workspace

URL:
https://dataaccess/deleteUserWorkspace
Methods:
POST
Required Capability:
Access allowed only with the default administrator role
Version Introduced:
11.5

Description

The deleteUserWorkspaces operation enables an administrator to remove a user's workspace directory permanently. This operation can only be performed if the user does not have any active containers.

Request parameters

ParameterDetails

userName

(Required)

The username of the user whose notebook workspace directory is being deleted.

Example
Use dark colors for code blocksCopy
1
userName=gis_joe

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 deleteUserWorkspaces operation:

Use dark colors for code blocksCopy
1
2
3
4
5
6
POST /<context>/notebooks/admin/dataaccess/deleteUserWorkspace HTTP/1.1
Host: organization.example.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

userName=gis_joe&f=pjson&token=PuuxoDV8HzHD1GxXUDpgHDeItErtl9Wr6rbULdhXHVUnGsjZ2hI1j1cPmnDEN1UnUfDqrNr2AuviTe5OkBumXsPlwSCrKw_ZVM1vczv2ziRESyz2PEAAhfsf71EyKIEGe7wW1z7hN_aLIjTekcdUbs-xtUAMZjEKHDRxT85NlfWqQghOy6o5XE54P8nnmdhllY6IfdtqeRtOYfFLoCBGCmOFV8diNVk4CxW3MMnzelDAGuRpN-Bru-vcYTY-7Or9

JSON Response syntax

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

JSON Response examples

The sample response below demonstrates a success response returned by the operation:

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

The sample response below demonstreates an error message that is returned when attempting to delete the user workspace when the user has actively running contianers:

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
{
  "error" : {
    "code" : 500,
    "message" : "Failed to delete user workspace. The user has actively running containers.",
    "details" : null
  }
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.