Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

/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:

Code Block
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:

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

Page Tree
rootScans 3.0 API