v2

latestOpenAPI 3.0.1private2026-07-2667209320.4 KB

Applications

Update application

Update Application

Updates a Stackhawk Application.

Currently, can only change an application name.

👥 Teams Supported If the application belongs to a StackHawk Team, only members of the Team can call this endpoint.

🧾 Audited This is recorded as APPLICATION_MODIFIED User Activity.

Requires write:application permission.

post/api/v1/app/{appId}

Path parameters

appIdstring uuid required

UUID identifier for this StackHawk Application.

Request body

applicationIdstring

The UUID identifier of this application.

applicationType'STANDARD' | 'CLOUD'

updated application type for this application.

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

updated dataType for this application.

namestring required

updated name for this application.

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

updated riskLevel for this application.

screenrMetadataobject

Screenr (flightpath) session metadata to set.

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.