Sign in

v1

latestOpenAPI 3.0.32026-07-134103031.5 MB
Asset Discovery

Update Discovered Asset

Call auditlog tasks if applicable to query.

put/discovery/assets/{id}/

Path parameters

idstring required

A unique Base58 value identifying this object.

Request body

idstring required

A unique Base58 value identifying this object.

accountstring required

A unique Base58 value identifying this object.

namestring required

Name of the discovered asset.
The maximum length is 256 characters.

urlstring required

URL of the discovered asset.

type'web' | 'api' required

Type of discovered asset:
(Defaults to api)

  • web - Web
  • api - API
last_seenstring date-time required

Date and time of when the discovered asset was last seen, in ISO 8601 UTC format.
For example, “2023-08-09T13:27:43.8208302”.

first_seenstring date-time required

Date and time of when the asset was firstly discovered, in ISO 8601 UTC format.
For example, “2023-08-09T13:27:43.8208302”.

authoritiesstring required

Authorities of the discovered asset.

{"stackTrail":"components:schemas:DiscoveryAsset:properties:risk","oasType":"schema","type":"unknown","description":"\nScan assessment risk of the discovered asset: \n(Defaults to `null`)\n\n\n* `None` - Not applicable.\n* `0` - No risk.\n* `10` - Low risk.\n* `20` - Medium risk.\n* `30` - High risk.\n* `40` - Critical risk.","extensionFields":{"x-spec-enum-id":"d833b57a93cd87f3"},"nullable":true}
score'' | 'A+' | 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'R' required

Security Headers assessment score of the discovered asset.

  • `` -
  • A+ - A+
  • A - A
  • B - B
  • C - C
  • D - D
  • E - E
  • F - F
  • R - R
security_headers_urlstring required
state'NEW' | 'ACTIVE' | 'HIDDEN' | 'ARCHIVED'

State of the discovered asset:
(Defaults to NEW)

  • NEW - New
  • ACTIVE - Active
  • HIDDEN - Hidden
  • ARCHIVED - Archived
screenshotstring uri nullable required

Screenshot of the discovered asset.

commentstring nullable

Comment on the object.

{"stackTrail":"components:schemas:DiscoveryAsset:properties:redirect_from","oasType":"schema","type":"unknown","description":"\nURLs redirected to the discovered asset. \n","nullable":true}
redirect_tostring required

URL the discovered asset is redirected to.

api_schema_filestring uri nullable required

Response

idstring required

A unique Base58 value identifying this object.

accountstring required

A unique Base58 value identifying this object.

namestring required

Name of the discovered asset.
The maximum length is 256 characters.

urlstring required

URL of the discovered asset.

type'web' | 'api' required

Type of discovered asset:
(Defaults to api)

  • web - Web
  • api - API
last_seenstring date-time required

Date and time of when the discovered asset was last seen, in ISO 8601 UTC format.
For example, “2023-08-09T13:27:43.8208302”.

first_seenstring date-time required

Date and time of when the asset was firstly discovered, in ISO 8601 UTC format.
For example, “2023-08-09T13:27:43.8208302”.

authoritiesstring required

Authorities of the discovered asset.

{"stackTrail":"components:schemas:DiscoveryAsset:properties:risk","oasType":"schema","type":"unknown","description":"\nScan assessment risk of the discovered asset: \n(Defaults to `null`)\n\n\n* `None` - Not applicable.\n* `0` - No risk.\n* `10` - Low risk.\n* `20` - Medium risk.\n* `30` - High risk.\n* `40` - Critical risk.","extensionFields":{"x-spec-enum-id":"d833b57a93cd87f3"},"nullable":true}
score'' | 'A+' | 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'R' required

Security Headers assessment score of the discovered asset.

  • `` -
  • A+ - A+
  • A - A
  • B - B
  • C - C
  • D - D
  • E - E
  • F - F
  • R - R
security_headers_urlstring required
state'NEW' | 'ACTIVE' | 'HIDDEN' | 'ARCHIVED'

State of the discovered asset:
(Defaults to NEW)

  • NEW - New
  • ACTIVE - Active
  • HIDDEN - Hidden
  • ARCHIVED - Archived
screenshotstring uri nullable required

Screenshot of the discovered asset.

commentstring nullable

Comment on the object.

{"stackTrail":"components:schemas:DiscoveryAsset:properties:redirect_from","oasType":"schema","type":"unknown","description":"\nURLs redirected to the discovered asset. \n","nullable":true}
redirect_tostring required

URL the discovered asset is redirected to.

api_schema_filestring uri nullable required