Appian's deployment REST API suite provides a safe way to expose Appian deployment services and data to external systems.
This allows you to:
There are five endpoints that allow you to inspect and deploy packages, import customization files, and database scripts. They also allow you to configure a post-deployment process to run after external deployments.
The endpoints are:
This page gives an overview of Appian's deployment REST API suite.
The API follows REST standards. See this resource for more information about RESTful APIs.
All deployment API endpoints are called with a URL beginning with
<domain> is replaced with your Appian site domain.
Every API endpoint must be called using the HTTP request method (
GET) specified in the documentation. A
POST request is used to send data to Appian in order to create or update information, such as creating a new deployment. A
GET request is used to request data from Appian, such as retrieving the status of an existing deployment.
All endpoint requests are authenticated with an API key, which is linked to a service account. This is the same mechanism that Appian uses to secure Web API objects. The service account and API key can be created in the Administration Console, and then configured to secure external deployments.
Once configured, there are multiple ways to use the API key to authenticate your request. For example, you can add it to the HTTP header with the key name Appian-API-Key:
curl https://<domain>/suite/deployment-management/v1/deployments -H "Appian-API-Key: <API key>"
Appian recommends that any package should first be inspected and then deployed.
The high-level workflow and endpoints for each step are:
/inspectionsendpoint. The endpoint response provides the UUID of the inspection, which you can use in the next step.
/inspections/<uuid>endpoint. The inspection may take longer depending on the size of your package. We recommend hitting this endpoint on a regular interval until the inspection is complete and results are available, which is indicated by the status response.
/deploymentsendpoint. The endpoint’s response provides the UUID of the deployment, which you can use in the next step.
/deployments/<uuid>endpoint. Similar to step 2, the deployment time will vary with the size of your package. We recommend hitting this endpoint on a regular interval until the deployment is completed and results are available, which is indicated by the status response.
Deployment REST API