Update initiative

put

https://cloud.tenable.com/exposure-response/initiatives/{initiative_id}

Updates an initiative's scope or combinations. Trending metrics are reset upon update and recalculated during the next processing cycle.

Requires the Basic [16] user role or one of the following custom role privileges: VM.VM_ER.VM_ER.EDIT for Vulnerability Management or EXPOSURE_MANAGEMENT.EM_ER.EM_ER.EDIT for Exposure Management. See Roles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

initiative_id

uuid

required

Specifies the unique identifier (UUID) of the initiative.

Body Params

name

string

required

length ≤ 128

Specifies the name of the initiative.

description

string

length ≤ 1024

Specifies the description of the initiative.

owner

uuid

required

Specifies the unique identifier (UUID) of the user to assign as the initiative owner.

Administrators can assign other users as initiative owners. Non-administrators can create initiatives, but can only assign themselves as the owner.

sla_in_days

int32

required

Specifies the number of days within which the initiative's findings must be remediated to meet the service level agreement (SLA). For example, to set an SLA of one week, enter 7.

scope

array of uuids

required

length ≤ 10

Specifies the tag values that define the asset scope of the initiative. Each UUID corresponds to a tag value assigned to one or more assets. You can retrieve a list of tag values using the List tag values endpoint.

Note: You can define a maximum of 10 tag value UUIDs.

scope*

combination_ids

array of uuids

required

length ≤ 10

Specifies the private or shared combinations to use as filters within the initiative. You can retrieve a list of private or shared combinations using the List combinations endpoint with the type parameter set to private or shared.

Combinations define which resources the initiative tracks and work together with asset tags to establish the initiative's scope. For more information, see Manage Combinations in the Tenable Vulnerability Management User Guides.

Note: Initiatives can contain no more than 17 queries across all combinations. For example, if you add four combinations to an initiative, and each combination contains five queries (for a total of 20), you will not be able to create the initiative.

combination_ids*

tenable_ids

array of uuids

required

length ≤ 10

Specifies the Tenable-provided combinations to use as filters within the initiative. You can retrieve a list of Tenable-provided combinations using the List combinations endpoint with the type parameter set to tenable. Note that Tenable-provided combinations may be updated over time, which can affect the resources tracked by your initiative.

tenable_ids*

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

403

Returned if you do not have permission to update initiatives.

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/html

200Returned if the specified initiative was updated successfully.

400Returned if your request specified invalid parameters or if your request was improperly formatted.

401Returned if the API keys specified in your request are invalid.

404Returned if the specified initiative was not found.

429Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting.

500Returned if an internal server error occurred.