Versions Compared

Key

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

/rest/customize/scanmetadata/keys/new


Descriptor

Value

HTTP Method

POST

Description

Creates a new scan metadata key

Required Permission

Manage Scan Metadata Keys

Version Introduced2.7


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

name

String

Yes

The name to assign the new metadata key.

N/A

active

String

No

Sets the meta data key to active or inactive.

“TRUE”, “FALSE”

Sample Call:


Code Block
themeEclipse
curl --insecure -H 'Accept: application/json' -X POST --data "key=Metadata Key Title&active=true" http://localhost/threadfix/rest/customize/scanmetadata/keys/new?apiKey={apiKey}


Sample Output:


Code Block
themeEclipse
{PLACEHOLDER ONLY!!! TO BE REPLACED WITH CORRECT RETURN MESSAGE!!
    "message": "",
    "success": true,
    "responseCode": -1,
    "object": [
        {
            "id": 1,
            "active": true,
            "key": "I Gotta Brand New Pair of Rollerskates"
        },
        {
            "id": 2,
            "active": true,
            "key": "You Gotta Brand New Key"
        }
    ]
}


Page Tree
rootScans API