As of December 31st, 2023 ThreadFix 2.X has reached End of Life and is no longer supported. For any further information please contact the Success and Implementation team.

Edit Scan Metadata - API

/rest/{version}/scans/{scanId}/metadata/{metadataId}/update


Descriptor

Value

HTTP Method

POST

Description

Updates scan metadata

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

key

Integer

No

The scan metadata key for the metadata which will be edited.

N/A

description

String

No

Text for description field.

N/A

titleStringNoScan Metadata key title. Used if key param is not present.N/A

Sample Call:


curl --insecure -H 'Accept: application/json' -H "Authorization: APIKEY {apiKey}" -X POST --data "description=I gotta brand new key" http://localhost:8080/threadfix/rest/latest/scans/{scanId}/metadata/{metadataId}/update


Sample Output:


{
    "message": "",
    "success": true,
    "responseCode": -1,
    "object": {
        "id": 2,
        "orderPosition": 1,
        "description": "I gotta brand new key",
        "title": "Scan Metadata Key"
    }
}

www.threadfix.it | www.coalfire.com
Copyright © 2024 Coalfire. All rights reserved.

This Information Security Policy is CoalFire - Public: Distribution of this material is not limited.