Update Organization Scan Policy

POST /api/v1/policy/{orgId}/update

Creates or updates an organization scan policy for this organization.

🧾 Audited This is recorded as ORGANIZATION_POLICY_MODIFIED User Activity.

Requires write:policy permission.

Path parameters

orgIdstring · uuidrequired

UUID identifier for this StackHawk Organization.

Body

scanPolicy

scanpolicy.ScanPolicy

Hide child attributesShow child attributes

scanPolicy.applicationId

string read-only

The UUID identifier of the scan policy application. If no application ID is present, the scan policy is defined by StackHawk. If the application ID is present, then the scan policy is customized for the given application only.

scanPolicy.description

string

The description for this policy.

scanPolicy.displayName

string

The human readable display name for this policy.

scanPolicy.id

string read-only

The UUID identifier of this scan policy.

scanPolicy.isCustomized

boolean

Indicates whether the plugins have been updated from original scan policy.

scanPolicy.name

string

The referencable unique name of a StackHawk scan policy.

scanPolicy.plugins

scanpolicy.Plugin[]

List of the plugins defined for this policy.

Hide child attributesShow child attributes

scanPolicy.plugins.defaultRisk

enum<string> read-only

Default risk for this plugin. Currently unused.

5 available options

UNKNOWNINFOLOWMEDIUMHIGH

scanPolicy.plugins.enabled

boolean

Enables the plugin. Plugins will only run in a scan when marked as enabled.

scanPolicy.plugins.name

string

The Plugin name.

scanPolicy.plugins.pluginId

string

The UUID identifier of this plugin.

scanPolicy.plugins.pluginType

enum<string>

The type of plugin to run as. Either ACTIVE or PASSIVE.

2 available options

ACTIVEPASSIVE

scanPolicy.plugins.status

enum<string> read-only

The release quality of this plugin.

3 available options

ADDON_STATUS_ALPHAADDON_STATUS_BETAADDON_STATUS_RELEASE

scanPolicy.plugins.strength

enum<string> write-only

The strength of this plugin. Currently unused.

5 available options

STRENGTH_LOWSTRENGTH_MEDIUMSTRENGTH_HIGHSTRENGTH_INSANESTRENGTH_OFF

scanPolicy.plugins.threshold

enum<string> write-only

The threshold of this plugin. Currently unused.

4 available options

THRESHOLD_LOWTHRESHOLD_MEDIUMTHRESHOLD_HIGHTHRESHOLD_OFF

scanPolicy.techFlags

object read-only

Technology flags for this policy. This is a collection of specific technology identifiers that further configure scan behavior.

Response

Bad Request

Unauthorized

POST /api/v1/policy/{orgId}/update

cURL

curl --request POST \
  --url 'https://api.stackhawk.com/api/v1/policy/{orgId}/update' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{}'

Copy

Update Organization Scan Policy

Path parameters

Body

Response

Your privacy settings