Learn about our new features recently updated daily.

Learn More

Modify an application

Used to modify an existing application.

API

PUT https://api.beaglesecurity.com/rest/v2/applicatons

Required scope: edit_project

Request headers

Content-Type: application/json

Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Request body

name

string

required

Name of the application

url

string

required

URL of the application

applicationToken

string

required

A unique token for identifying the application in your account

Response

name

string

Name of the application

url

string

URL of the application

applicationToken

string

A unique token for identifying the application in your account

projectKey

string

A unique key for identifying the project

signatureStatus

string

Used to know the domain verification status of the application
Possible values are:

Verified Application is verified.
NotVerifiedApplication is not verified.

hostingType

string

Used to specify wheather it's WEB or API. If left blank,default will be set to web.
Possible values are:

WEB Current application is a WEB.
APICurrent appliation is a API

code

string

Status code for the API call.

Values are:

SUCCESSAPI call is success
PLAN_NOT_SUPPORTEDYour plan does not support this feature.
PROJECT_ALREADY_EXISTSProject already exists in your account.
INVALID_SESSIONInvalid session
FAILEDFailed to create project.
NOT_AUTHORIZEDUser authentication failed.

message

string

Success/failure message for the API call

Last modified: 2025/03/10

Example request

cURL

Java

                    curl --location --request PUT \
'https://api.beaglesecurity.com/rest/v2/applications' \
--header 'Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Default app",
"url": "https://example.com",
"applicationToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}'

                    // This token will be generated from Beagle security settings -> Access token
BeagleSecurityClient client = BeagleSecurityClientBuilder.instance()
.withAPIToken("xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx")
.build();

// Modify application
String applicationToken = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
String applicationName = "Default app";
String url = "https://example.com";
Application application = client.modifyApplication(applicationToken, applicationName, url);

Response

201 400 401

                    {
"name": "Default app",
"url": "https://example.com",
"applicationToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"projectKey": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"signatureStatus": "Verified",
"hostingType": "API",
"code": "SUCCESS",
"message": "Success."
}

                    {
"code": "FAILED",
"message": "Failed to get application(s)."
}

                    {
"code": "NOT_AUTHORIZED",
"message": "Not authorized"
}

Next