AttackForge Enterprise

UpdateScope

This method can be used for the following functionality: Update an asset on a project that this user must have Edit access to.

Parameters

The following URL, Headers and Parameters are required for requests to this API endpoint. Where a parameter is optional, it will be indicated. Otherwise treat all parameters as mandatory.

Headers

PUT /api/ss/project/:projectId/asset/:assetId HTTP/1.1
Host: demo.attackforge.com
X-SSAPI-KEY: APIKey
Content-Type: application/json
Connection: close

Query

projectId (string)

Id of the project.

Example:

PUT /api/ss/project/5e7c29afa3362408cf502a11/asset/:assetId HTTP/1.1

assetId (string)

Id of the asset.

Example:

PUT /api/ss/project/:projectId/asset/5e7c29afa3362408cf502a15 HTTP/1.1

name (string) (optional)

Name of the asset.

Example:

{
"name": "..."
}

is_deleted (boolean) (optional)

Whether asset is deleted or not.

Example:

{
"is_deleted": false
}

Example

The following example is a cURL request to update name of an asset.

Request

Include API Token instead of stars in 'X-SSAPI-KEY: ***************************************' parameter.

curl -X PUT 'https://demo.attackforge.com/api/ss/project/5e7c29afa3362408cf502a11/asset/5e7c29afa3362408cf502a15' -H 'Host: demo.attackforge.com' -H 'X-SSAPI-KEY: ***************************************' -H 'Content-Type: application/json' -H 'Connection: close' -d '{
"name": "Asset New Name",
"is_deleted": false
}'

Response

Response contains a status.

{
"status": "Asset Updated"
}