Versions Compared

Key

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


Warning

Deprecated as of version 2.7.5. Use Create Metadata Key - API instead.


/rest/{version}/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.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

namekey

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' -H "Authorization: APIKEY {apiKey}" -X POST --data "key=MetadataPort Key Title&active=true" http://localhost:8080/threadfix/rest/latest/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 Port Key"
        }
    ]
}


Page Tree
rootScans API