PRprobely
Asset Discovery

Partial Update Discovered Asset

Changed on

Call auditlog tasks if applicable to query.

patch/discovery/assets/{id}/

Request

  • Base URL
    https://api.probely.com
  • URL
    https://api.probely.com/discovery/assets/{id}/
  • Auth
    API key in header Authorization

Path parameters

idstring required

A unique Base58 value identifying this object.

Request body

idstring

A unique Base58 value identifying this object.

accountstring

A unique Base58 value identifying this object.

namestring

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

urlstring

URL of the discovered asset.

type'web' | 'api'

Type of discovered asset:
(Defaults to api)

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

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

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

authoritiesstring

Authorities of the discovered asset.

riskunknown
score'' | 'A+' | 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'R'

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
state'NEW' | 'ACTIVE' | 'HIDDEN' | 'ARCHIVED'

State of the discovered asset:
(Defaults to NEW)

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

Screenshot of the discovered asset.

screenshot_captured_atstring date-time nullable

When the screenshot of the discovered asset was captured.
null for assets whose screenshot predates this field.

commentstring nullable

Comment on the object.

redirect_fromunknown
redirect_tostring

URL the discovered asset is redirected to.

api_schema_filestring uri nullable

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.

riskunknown required
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.

screenshot_captured_atstring date-time nullable required

When the screenshot of the discovered asset was captured.
null for assets whose screenshot predates this field.

commentstring nullable

Comment on the object.

redirect_fromunknown required
redirect_tostring required

URL the discovered asset is redirected to.

api_schema_filestring uri nullable required

Changes

  • 0b2f6cbe644dRevision changes
    • info

      added the new optional request property /////////////// (media type: application/json)

    • info

      added the new optional request property /////////////// (media type: application/x-www-form-urlencoded)

    • info

      added the new optional request property /////////////// (media type: multipart/form-data)

    • info

      added the optional property /////////////// to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property ////////// to the response with the status

  • 0e9b5b5da4d0Revision changes
    • warning

      added the new 40.00 enum value to the response property for the response status

    • info

      added the new 40.00 enum value to the request property (media type: application/json)

    • info

      added the new 40.00 enum value to the request property (media type: application/x-www-form-urlencoded)

    • info

      added the new 40.00 enum value to the request property (media type: multipart/form-data)

    • info

      added the required property ////////// to the response with the status