Create environment

Create Environment

Creates a new Stackhawk Environment for this application.

This is represented as a StackHawk Application with populated env and envId fields.

Applications group scan results from HawkScan, and coordinate settings to influence HawkScan behavior. The application may also contain a specific environment name and id. For more information, see Applications.

Parameter	Default	Description
applicationId	""	The UUID identifier of this application.
name	""	The name of this application.
env	""	The name of this environment. Only set when requesting Application Environments.
envId	""	The UUID identifier of this environment.
applicationStatus	"ACTIVE"	The status of this application. Either ACTIVE or ENV_INCOMPLETE.
organizationId	""	The UUID identifier of the organization that owns this application.
applicationType	"STANDARD"	The type of this application.
cloudScanTarget	{}	Optional Cloud Scan Target configuration.

👥 Teams Supported If the user belongs to a StackHawk Team, a created environment will belong to the user's Team.

🧾 Audited This is recorded as ENVIRONMENT_ADDED User Activity.

Requires write:application permission.

appIdstring uuid required

UUID identifier for this StackHawk Application.

hoststring

Optional host URL for the new environment's default hosted scan configuration.

Request body

applicationIdstring

The UUID identifier of this application.

envstring

The name of this new environment.

organizationIdstring

The UUID identifier of the organization that will own this environment.

Response

Applications group scan results from HawkScan, and coordinate settings to influence HawkScan behavior. The application may also contain a specific environment name and id. For more information, see Applications.

applicationIdstring

The UUID identifier of this application.

applicationStatus'ACTIVE' | 'ENV_INCOMPLETE'

The status of this application. Either ACTIVE or ENV_INCOMPLETE.

applicationType'STANDARD' | 'CLOUD'

The type of this application.

dataType'NONE' | 'PII' | 'PCI' | 'FIN' | 'PKI' | 'HIPAA' | 'FERPA'

The perceived dataType of this application. Currently unused.

envstring

The name of this environment. Only set when requesting Application Environments.

envIdstring

The UUID identifier of this environment.

namestring

The name of this application.

organizationIdstring

The UUID identifier of the organization that owns this application.

riskLevel'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL'

The perceived riskLevel of this application. Currently unused.

v2

Create environment