Create application

Create Application

Creates a new Stackhawk Application for this organization.

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.

The env and envId fields are not populated on the response with this endpoint. A name is not required to create an application, but it is strongly encouraged.

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

🧾 Audited This is recorded as APPLICATION_ADDED User Activity.

Requires write:application permission.

orgIdstring uuid required

UUID identifier for this StackHawk Organization.

Request body

applicationStatus'ACTIVE' | 'ENV_INCOMPLETE'

A specified status for this new application.

applicationType'STANDARD' | 'CLOUD'

A specified status for this new application.

cloudScanTargetURLstring

Optional Cloud Scanning Target URL.

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

A specified data type for this new application.

envstring required

The initial environment for this new application.

hoststring

The host specified when creating a new application

namestring required

The name of this new application.

organizationIdstring

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

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

A specified risk level for this new application.

teamIdstring

The UUID identifier of the team that this application belongs to.

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 application