2.8.4 Deletion of history records (with an ID specified)

Function

Deletes the history record by specifying a task ID.

Execution permissions

Admin role, Develop role, Modify role

API version

Request format

DELETE http://host:port/Automation/version/objects/TaskHistories/id

Status code

The following table describes the various status codes that can be returned as the response to a request.

Status code	Message	Description
204	No Content	Processing has been successfully completed. Or, the task history to be deleted did not exist.
401	Unauthorized	The user does not have login permission.
403	Forbidden	The user does not have permission to delete history records.
412	Precondition failed	The server is not running.
500	Server-side error	A server processing error occurred.

Usage example

In the following example, the API function deletes the history record for the task whose instanceID is 5237.

Request header:

DELETE /Automation/v1/objects/TaskHistories/5237 HTTP/1.1
Host: 192.168.146.132:22015
User-Agent: curl/7.36.0
Accept: application/json
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
Accept-Language: ja

Response header:

HTTP/1.1 204 No Content
Date: Fri, 07 Aug 2015 11:14:12 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 3b6cddc1eaffe8cd8c2bbcc88ce991e8419472cc_Vlo8Y30JBWoKHUYTEXAMXx5iHgQ=_V0810
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Content-Length: 0
Content-Type: application/json