This POST service will perform the same action found on the Deployment Request Form off the application screen. It will initiate a request to deploy the application selected in the qualifiedApplicationName. The service will return the applicationRequestId which can be used by the getApplicationRequestStatus call to determine when the workflow is complete.

API URL

http://host:port/flexdeploy/rest/workflow/deployApplication

Application Deploy Sample JSON Request

 "authentication":

   "userId":"fdadmin",

   "password": "password1"

},

Opening bracket

Authentication section, used on all types of requests.

Required parameters for application deployment.

"environmentCode":"DEV",

"qualifiedApplicationName":"/FlexDeploy/folder1/myApp",

Build in the DEV environment.

The full path of the FlexDeploy project to deploy.

Optionally include this information.

Verify that your json is valid; check for trailing commas if you don't include this section.

"forceDeploy": true,

"startTime": "2017-03-16T23:17:52-06:00",

"exceptionToWindow": "true",

"applicationVersion": "1.5",

"projectSettings": [
    {
      "projectName": "SimpleProj",
      "inputs": [
       {
          "name": "inp1", "value": "value1"
       },
       {
          "name": "inp2", "value": "value2"
       }]
    }],

"flexFields": [
{
"name": "CHANGE_NUMBER","value": "xyz"
},
{
"name": "field2","value": 123
}]

boolean equivalent to "Force Deploy" checkbox in the UI. Defaults to false.

Start the deployment at this time.

The application will be deployed outside any configured windows.

Version "1.5" of the application will be deployed.

List of projects in the application

SimpleProj will be deployed using the two listed input codes.

Any other projects in the application which do not need inputs will still be deployed, even if they are not listed in the JSON.

List of FlexField display names to set

Set CHANGE_NUMBER to "xyz"

Set field2 to 123.

}

Closing bracket

Parameters

Parameter	Required	Type	Description
`authentication`	Y	Object	See Common Parameters below.
`environmentCode`	Y	String	This is the environment code, not the environment name that you see on most screens.
`qualifiedApplicationName`	Y	String	The qualified application name starts with /FlexDeploy and includes any sub folders, and finally the project.
applicationVersion	N	String	Version of the application to be deployed. Defaults to the last successful build.
`exceptionToWindow`	N	Boolean	Values are true or false. Indicates that the deployment is an exception to the deployment window.
`forceBuild`	N	Boolean	Values are true or false. Indicates that the build should occur even if there are not SCM changes. Defaults to false.
`startTime`	N	DateTime	The time when the deployment will be started.
`projectSettings`	N	List	The project settings is a list of the projects by name and includes the 2 sub-parameters below. If all values can be defaulted, the project setting for that project does not need to be included.
projectName	N	String	The project to assign inputs into
inputs	N	List	See Common Parameters below.
`flexFields`	N	List	See Common Parameters below.

Common Parameters

Authentication

The authentication parameter is comprised of 2 fields.

userId – a valid user id for FlexDeploy
password – the associated password

Inputs

This is a list of name/value pairs for the inputs. Not all inputs need to be supplied. If an input has a default value that is acceptable for the Workflow to run, it does not need to be supplied.

FlexFields

Applicable only for deployProject and deployApplication. This is a list of name (Display Name of FlexField)/value pairs for the Flexfields. Not all FlexFields need to be supplied. If a FlexField has a default value or options that are acceptable for the workflow to run, it does not need to be changed. Read more about FlexFields.