Skip to main content
PUT
/
v2
/
listings
/
{listingUid}
/
assets
/
{assetUid}
cURL
curl --request PUT \
  --url https://client.synack.com/api/asset/v2/listings/{listingUid}/assets/{assetUid} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "scopeRules": [
    {
      "rule": "<string>"
    }
  ],
  "assetUid": "<string>"
}
'
{
  "listingUid": "<string>",
  "scopeRules": [
    {
      "uid": "<string>",
      "rule": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "createdBy": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "updatedBy": "<string>"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "assetUid": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.synack.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

listingUid
string
required
read-only

Unique identifier for an listing.

Pattern: ^[-_0-9a-z]{1,50}
assetUid
string
required

Unique identifier for an asset.

Pattern: ^[0-9a-f]{24}

Body

application/json

Properties of the assignment of an asset to a listing.

Assignment of an asset to a listing.

scope
enum<string>

Set to in-scope means automated and manual testing should occur; out-of-scope means automated and manual testing must not occur; discovered means observed through automated discovery and may be automatically removed if not observed again during subseqent discovery activities.

Available options:
in,
out,
discovered,
blocked
scopeRules
object[]

Out of scope locations for this asset.

assetUid
string

Unique identifier for an asset.

Pattern: ^[0-9a-f]{24}

Response

The assignment of an asset to an listing.

Assignment of an asset to a listing.

listingUid
string
read-only

Unique identifier for an listing.

Pattern: ^[-_0-9a-z]{1,50}
scope
enum<string>

Set to in-scope means automated and manual testing should occur; out-of-scope means automated and manual testing must not occur; discovered means observed through automated discovery and may be automatically removed if not observed again during subseqent discovery activities.

Available options:
in,
out,
discovered,
blocked
scopeRules
object[]

Out of scope locations for this asset.

createdAt
string<date-time>
read-only

Automatically set by the server to the time the listing asset association was created.

updatedAt
string<date-time>
read-only

Automatically set by the server to the time the listing asset association is updated.

assetUid
string

Unique identifier for an asset.

Pattern: ^[0-9a-f]{24}