Update application

POST /api/v1/app/{appId}

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.

Path parameters

appIdstring · uuidrequired

UUID identifier for this StackHawk Application.

Body

applicationId

string read-only

The UUID identifier of this application.

applicationType

enum<string> read-only

updated application type for this application.

2 available options

STANDARDCLOUD

cloudScanTarget

application.CloudScanTarget

Hide child attributesShow child attributes

cloudScanTarget.isDomainVerified

boolean

Indicates if the domain is verified or not.

cloudScanTarget.targetURL

string

The target URL.

dataType

enum<string> read-only

updated dataType for this application.

7 available options

NONEPIIPCIFINPKIHIPAAFERPA

name

string required

updated name for this application.

riskLevel

enum<string> read-only

updated riskLevel for this application.

4 available options

LOWMEDIUMHIGHCRITICAL

screenrMetadata

object

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.

applicationId

string

The UUID identifier of this application.

applicationStatus

enum<string>

The status of this application. Either ACTIVE or ENV_INCOMPLETE.

2 available options

ACTIVEENV_INCOMPLETE

applicationType

enum<string>

The type of this application.

2 available options

STANDARDCLOUD

cloudScanTarget

application.CloudScanTarget

Hide child attributesShow child attributes

cloudScanTarget.isDomainVerified

boolean

Indicates if the domain is verified or not.

cloudScanTarget.targetURL

string

The target URL.

dataType

enum<string> write-only

The perceived dataType of this application. Currently unused.

7 available options

NONEPIIPCIFINPKIHIPAAFERPA

env

string

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

envId

string

The UUID identifier of this environment.

name

string

The name of this application.

organizationId

string

The UUID identifier of the organization that owns this application.

riskLevel

enum<string> write-only

The perceived riskLevel of this application. Currently unused.

4 available options

LOWMEDIUMHIGHCRITICAL

applicationId

string

The UUID identifier of this application.

applicationStatus

enum<string>

The status of this application. Either ACTIVE or ENV_INCOMPLETE.

2 available options

ACTIVEENV_INCOMPLETE

applicationType

enum<string>

The type of this application.

2 available options

STANDARDCLOUD

cloudScanTarget

application.CloudScanTarget

Hide child attributesShow child attributes

cloudScanTarget.isDomainVerified

boolean

Indicates if the domain is verified or not.

cloudScanTarget.targetURL

string

The target URL.

dataType

enum<string> write-only

The perceived dataType of this application. Currently unused.

7 available options

NONEPIIPCIFINPKIHIPAAFERPA

env

string

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

envId

string

The UUID identifier of this environment.

name

string

The name of this application.

organizationId

string

The UUID identifier of the organization that owns this application.

riskLevel

enum<string> write-only

The perceived riskLevel of this application. Currently unused.

4 available options

LOWMEDIUMHIGHCRITICAL

Bad Request

Unauthorized

POST /api/v1/app/{appId}

cURL

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

Copy

Update application