Delete Enclave Tag From Report

DELETE /1.2/reports/{id}/enclave-tags?name={tag_name}&enclaveId={enclave_id}&idType={id_type}

Description

Deletes a tag from an incident report, for the given enclave.

Parameters

Parameter Required Description
id X TruSTAR report id or external tracking id
idType   internal or external (defaults to internal when not provided)
name X the name of the tag to delete
enclaveId X the id of the enclave to delete the tag from

Responses

200 (OK)

{
    "guid": enclave tag guid,
    "name": tag name,
    "count": number of times the tag has been applied,
    "enclaveId": id of the enclave the tag belongs to
}

The enclave tag that was added to the report.

400 (Bad Request)

OK message if the operation was successful

403 (Forbidden)

{
    "timestamp": milliseconds since epoc,
    "status":400,
    "error":"Bad Request",
    "message": error detail (e.g. user cannot access report)
}

404 (Not Found)

{
    "timestamp": milliseconds since epoc,
    "status":404,
    "error":"Not Found",
    "message": error detail (e.g. report not found)
}

Example Usage

Request

curl -k -H "Authorization: Bearer {access_token}" -XDELETE "https://api.trustar.co/api/1.2/reports/9066ab40-2f3c-45ae-9566-7530403da691/enclave-tags?name=malware&enclaveId=2884f4b2-1781-4641-aa54-8911d32bd323"

Response

OK