ApiFunction_delete

Page history last edited by jeremy@... 1 wk ago

delete

 



Description

 

This method deletes a file or folder.

 

 

Input parameters:

 

Name Type Description
api_key string The API key obtained when registering a project with OpenBox.
auth_token string The authentication token obtained when a user authenticates your application with Box.
target string The type of item to be deleted.  This can be set as 'file' or 'folder'.
target_id long The id of the item you wish to delete.  If the target is a folder, this will be the folder_id.  If the target is a file, this will be the file_id.

 

Output parameters:

 

Name Type Description
status string

On a successful result, the status parameter will be 's_delete_node'.

If the operation was not successful, the status field can be:

  • 'not_logged_in' - The user is not logged into your application.  Your authentication_token is not valid.
  • 'application_restricted'- You provided an invalid api_key, or the api_key is restricted from calling this function.
  • 'e_delete_node' - For all other errors.  Verify that your target is 'file' or 'folder', that your target_id is a valid item_id in the user's account.

 

 

REST

 

Request

 

https://www.box.net/api/1.0/rest?action=delete&api_key=rrc1d3ntb53tt6b2vhail6rdtrsxov3v&auth_token=tkm1l2ojyhgrf86zzvdqvoa6zcqss6pf&target=folder&target_id=738

 

 

 

 

Response

 

<?xml version='1.0' encoding='UTF-8'?>
<response>
<status>s_delete_node</status>
</response>

 

SOAP

 

Request

 

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:tns="urn:boxnet" xmlns:types="urn:boxnet/encodedTypes"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
>
<soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<tns:delete>
<api_key xsi:type="xsd:string">rrc1d3ntb53tt6b2vhail6rdtrsxov3v</api_key>
<sid xsi:type="xsd:string">baa8b089c5a635adc0baa68aa1c61bbe</sid>
<target xsi:type="xsd:string">file</target>
<target_id xsi:type="xsd:long">3695</target_id>
</tns:delete>
</soap:Body>
</soap:Envelope>

 

Response

 

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:ns4="urn:boxnet"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
>
<SOAP-ENV:Body>
<ns4:deleteResponse>
<status xsi:type="xsd:string">s_delete_node</status>
</ns4:deleteResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

 

XML

 

Request

 

<?xml version='1.0' encoding='UTF-8' ?>
<request>
<action>delete</action>
<api_key>rrc1d3ntb53tt6b2vhail6rdtrsxov3v</api_key>
<auth_token>tkm1l2ojyhgrf86zzvdqvoa6zcqss6pf</auth_token>
<target>folder</target>
<target_id>738</target_id>
</request>

 

Response

 

<?xml version='1.0' encoding='UTF-8'?>
<response>
<status>s_delete_node</status>
</response>

 


 

Need additional assistance? Please feel free to Contact us