Skip to main content

Bulk Update Targets with Unlimited Scans

PUT 
/account/unlimited/

Request​

Query Parameters

    exclude_team string[]

    Names of the teams to exclude from results, as a query string.
    For example, "exclude_team=Frontend" or "exclude_team=Frontend&exclude_team=Backend".

    label string[]

    Target labels to filter results, as a query string.
    For example, "label=Production" or "label=Production&label=QA".

    label_logical_operator string

    Possible values: [and, or]

    Logical operator to apply between target labels.
    (Defaults to or)

    • and - and
    • or - or
    ordering string

    Which field to use when ordering the results.

    risk integer[]

    Possible values: [0, 10, 20, 30, null]

    Target risk to filter results:

    • None - Not applicable.
    • 0 - No risk.
    • 10 - Low risk.
    • 20 - Medium risk.
    • 30 - High risk.
    scan_profile string[]

    Identifiers of the scan profiles to filter results, separated by commas.

    search string

    A search term.

    team string[]

    Names of the teams to filter results, as a query string.
    For example, "team=Frontend" or "team=Frontend&team=Backend".

    type string[]
    unlimited boolean

    If true, filter results by targets with unlimited scans.
    If false, filter results by targets that use credits.

    verified boolean

Body

required

  • Array [

    • id stringrequired
    unlimited boolean

    If true, the target has unlimited scans.
    If false, scans consume credits.
    Learn more about unlimited scans vs scans with credits.
    Defaults to true.

  • ]

Responses​

Schema

  • Array [

    • id stringrequired

    site

    object

    required

    Core settings of the target.
    Includes basic target information like the name and URL.

    id stringrequired

    A unique Base58 value identifying this object.

    name string

    Possible values: <= 255 characters

    Name of the target or extra host.
    The maximum length is 255 characters.

    url string

    Possible values: <= 2048 characters

    URL of the target.

    changed date-timerequired

    Date and time of the last change, in ISO 8601 UTC format.
    For example, "2023-08-09T13:27:43.8208302".

    changed_by

    object

    required

    User who last made changes.

    id stringrequired

    A unique Base58 value identifying this object.

    email email

    Possible values: <= 254 characters

    Email of the user.

    name stringrequired

    Possible values: <= 60 characters

    Name of the user.

    teams

    object[]

    required

  • Array [

    • id string

    A unique Base58 value identifying this object.

    name stringrequired

  • ]

    • unlimited boolean

    If true, the target has unlimited scans.
    If false, scans consume credits.
    Learn more about unlimited scans vs scans with credits.
    Defaults to true.

  • ]

Loading...