Create Scan Metadata - API

/rest/{version}/scans/{scanId}/metadata/new

Descriptor	Value
HTTP Method	POST
Description	Creates new scan metadata
Required Permission	Manage Scan Metadata
Version Introduced	2.7.1

Request Header Parameters

Parameter	Value	Required	Description
Accept	String	Yes	A value of ‘application/json’ must be provided.

Request POST Data Parameters

Parameter	Value	Required	Description	Available Values
key	String	Yes	The metadata key ID.	N/A
description	String	Yes	Text description of metadata	N/A
title	String	No	The scan metadata key title. Used if the key parameter is not present.	N/A

Sample Call:

curl --insecure -H 'Accept: application/json' -H "Authorization: APIKEY {apiKey}" -X POST --data "key={metadataKeyId}&description=You gotta pair of brand new roller skates" http://localhost:8080/threadfix/rest/latest/scans/{scanId}/metadata/new

Sample Output:

{
    "message": "",
    "success": true,
    "responseCode": -1,
    "object": {
        "id": 3,
        "orderPosition": 1,
        "description": "You gotta pair of brand new roller skates",
        "title": "Scan Metadata Key"
    }
}