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)

Delete asset.

Example:

{
   "is_deleted": true
}

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"
}

Last updated

Check YouTube for more tutorials: https://youtube.com/@attackforge