Application and Build Management APIs

This section describes all the APIs to manage the app builds for the TIBCO Flogo Capability.

Note: To use a namespace other than the default data plane namespace for APIs using the Namespace parameter, see Deploying App Outside Data Plane Namespace.

You can find the following APIs in the 'Apps and Builds' section of the TIBCO Flogo® Capability APIs page. For instructions on how to access the APIs, see Accessing the API Documentation with Swagger UI.

API for Listing Flogo Applications

Use the GET /v1/dp/apps API to retrieve a list of all Flogo applications from the data plane.

This API supports optional query parameters to filter the applications based on specified key(s) and value(s).

Optional Query Parameters:

Parameter Name Type Required Description
filterKey Query No A comma-separated list of columns to filter the result. For example: name, namespace, state, version, tag.
filterValue Query No A comma-separated list of values to filter the result. For example: my-app, my-ns, Running, 1.0.0, tag1.

API for Deleting an Application

Use the DELETE /v1/dp/apps/{appId} API to delete an application from the data plane.

To delete an app, you need the following parameters:

  • App Id: The application Id.

  • Namespace: The namespace where the application is deployed. This parameter is not mandatory and is only required if the application is running outside of the default data plane namespace.

METHOD Path Parameters
DELETE

  • Parameters: appId (required)

    Type: String

  • Parameters: namespace

    Type: String

API for Viewing Application Details

Use the GET /v1/dp/apps/{appId}/details API to view the application details for a specified app Id.

To view the app details, you need the following parameters:

  • App Id: The application Id.

  • Namespace: The namespace where the application is deployed. This parameter is not mandatory and is only required if the application is running outside of the default data plane namespace.

METHOD Path Parameters
GET

  • Parameters: appId (required)

    Type: String

  • Parameters: namespace

    Type: String

API for Viewing Application Endpoints 

Use the GET /v1/dp/apps/{appId}/endpoints API to return a list of both the public and private application endpoints for a specified app Id. This API returns details about a private or public endpoint and the Ingress configuration for the public endpoint.

To view the app endpoint details, you need the following parameters:

  • App Id: The application Id.

  • Namespace: The namespace where the application is deployed. This parameter is not mandatory and is only required if the application is running outside of the default data plane namespace.

METHOD Path Parameters
GET

  • Parameters: appId (required)

    Type: String

  • Parameters: namespace

    Type: String

API for Scaling an Application

Use the PUT /v1/dp/apps/{appId}/scale/{count} API to scale the number of instances for an existing application to the count you specify.

Caution: Avoid using the scale operation when the auto scaling option is configured.

To scale an app, you need the following parameters:

  • App Id: The application Id.

  • Count: The number of count for scaling.

  • Namespace: The namespace where the application is deployed. This parameter is not mandatory and is only required if the application is running outside of the default data plane namespace.

METHOD Path Parameters
PUT

  • Parameters: appId (required)

    Type: String

  • Parameters: count (required)

    Type: String

  • Parameters: namespace

    Type: String

API for Updating (Refreshing) Application Properties without Application Restart

Use the PUT /v1/dp/apps/{appId}/config/refresh API to update the application properties without restarting the app instance, if the app property reconfigure is enabled.

Before you begin

You must set the engine variable FLOGO_APP_PROP_RECONFIGURE to true to update the application configuration for that particular app.

To update the app properties, you need the following parameters:

  • App Id: The application Id.

  • Namespace: The namespace where the application is deployed. This parameter is not mandatory and is only required if the application is running outside of the default data plane namespace.

METHOD Path Parameters
PUT

  • Parameters: appId (required)

    Type: String

  • Parameters: namespace

    Type: String
Note: The list of config in key value pairs to update the app properties must be identical to its counterpart (app property) in the Application Properties dialog in Flogo. If the parameter names do not match exactly, a warning message is displayed, and the app uses the default value that you configured for the property in Flogo.

API for Listing Flogo Application Builds

Use the GET /v1/dp/builds API to retrieve a list of all the TIBCO Flogo application builds on the data plane.

This API supports optional query parameters to filter the builds based on specified key(s) and value(s). Additionally, it supports parameters to sort and order the output.

Optional Query Parameters:

Parameter Name Type Required Description
filterKey Query No A comma-separated list of columns to filter the result. For example: buildId, name.
filterValue Query No A comma-separated list of values to filter the result. For example: 0bb4dad, my-app-build.
sortBy Query No The name of the column to sort the result. For example: createdDate
orderBy Query No Specifies the order of the result. Available values: asc (ascending) and desc (descending).

API for Building an Application Executable Using app.json or app.flogo File

Use the POST /v1/dp/builds API to build a TIBCO Flogo application executable.

To create an app executable, you need the following parameters:

  • Base Version: The TIBCO Flogo base version.

  • Operating System: Compatible operating system for app binary

  • app.json: The .json or .flogo file to upload.

 
METHOD Path Parameters
POST

  • Parameters: baseversion

    Type: String

  • Parameters: OS

    Type: String

  • Parameters: arch

    Type: String

  • Parameters: app.json

    Type: String

API for Importing an App Build

Use the PUT /v1/dp/builds API to import an app build into a data plane.

To import an app build, you need the app build .zip file.

METHOD Path Parameters
PUT None

In the Request body section, click Choose File, browse to the .zip file, and click Open.

API for Downloading an Application Executable

Use the GET /v1/dp/builds/{buildId} API to download an application executable for an existing build Id.

To download an application executable, you need the build Id parameter.

Build Id: The applications build Id.

METHOD Path Parameter
GET

  • Parameters: buildId (required)

    Type: String

API for Deleting Application Builds

Use the DELETE /v1/dp/builds/{buildId} API to delete an app build.

Note: Ensure the application build being deleted is not used by any other application.

To delete an app build, you need the build Id parameter.

Build Id: The applications build Id.

METHOD Path Parameter
DELETE

  • Parameters: buildId (required)

    Type: String

API for Listing Flogo Applications from a Build ID

Use the GET /v1/dp/builds/{buildId}/apps API to retrieve a list of all TIBCO Flogo applications deployed using the specified build ID on the data plane.

This API requires a path parameter for the build ID and supports an optional query parameter to filter the applications by namespace.

Parameters:

Parameter Name Type Required Description
buildId Path Yes The build ID for which you want to retrieve the list of applications.
namespace Query No The namespace to filter the list of Flogo applications.

API for Exporting the app.json or app.flogo File

Use the GET /v1/dp/builds/{buildId}/export API to export the app.json or app.flogo file for an existing build Id.

To export the file, you need the following parameters:

  • Build Id: The applications build Id.

  • Namespace: The namespace where the application is deployed. This parameter is not mandatory and is only required if the application is running outside of the default data plane namespace.

METHOD Path Parameters
GET

  • Parameters: buildId (required)

    Type: String

  • Parameters: namespace

    Type: String

API for Exporting an Application Build

Use the GET /v1/dp/builds/{buildId}/exportBuild API to export an application build executable of an existing build Id.

To download an application build executable, you need the build Id parameter.

Build Id: The applications build Id.

METHOD Path Parameter
GET

  • Parameters: buildId (required)

    Type: String