Skip to content

Manage Cloud applications

Info

Learn the concepts and fundamentals of applications in the Explanation page.

A Nextmv application is an entity that contains a decision model as executable code.

This how-to guide explains how to interact with the actions under the nextmv cloud app command tree. Go the reference section or use the --help option to see all the available options for each command.

Create an app

Use the nextmv cloud app create command to create a new application.

nextmv cloud app create

⏳ Creating application...
{
  "id": "app-w1mzyb4t",
  "name": "app-w1mzyb4t",
  "description": "",
  "type": "custom",
  "default_instance": "",
  "default_experiment_instance": "",
  "subscription_id": "",
  "locked": false,
  "created_at": "2026-07-22T20:58:07.769903Z",
  "updated_at": "2026-07-22T20:58:07.769903Z"
}

The command above will create a random ID, and use the same identifier for the app's name. The name of the application is used as a human-readable label. You can use the --app-id and/or --name options to specify a custom ID and name for the application. For example:

nextmv cloud app create --app-id quirky-rabbit --name "A quirky rabbit"

⏳ Creating application...
{
  "id": "quirky-rabbit",
  "name": "A quirky rabbit",
  "description": "",
  "type": "custom",
  "default_instance": "",
  "default_experiment_instance": "",
  "subscription_id": "",
  "locked": false,
  "created_at": "2026-07-22T20:58:31.429643Z",
  "updated_at": "2026-07-22T20:58:31.429643Z"
}

When working with Nextpipe and decision worklows, you must specify that an application is of type "workflow" at the time of creation. Use the --is-workflow option to create a workflow application:

nextmv cloud app create --app-id quirky-rabbit-workflow --is-workflow

⏳ Creating application...
{
  "id": "quirky-rabbit-workflow",
  "name": "quirky-rabbit-workflow",
  "description": "",
  "type": "pipeline",
  "default_instance": "",
  "default_experiment_instance": "",
  "subscription_id": "",
  "locked": false,
  "created_at": "2026-07-22T20:59:40.777020Z",
  "updated_at": "2026-07-22T20:59:40.777020Z"
}

In automated workflows, you don't have to check if an application exists before creating it. Use the --exist-ok option to avoid an error if the application already exists:

nextmv cloud app create --app-id quirky-rabbit --exist-ok

⏳ Creating or getting application...
{
  "id": "quirky-rabbit",
  "name": "A quirky rabbit",
  "description": "",
  "type": "custom",
  "default_instance": "",
  "default_experiment_instance": "",
  "subscription_id": "",
  "locked": false,
  "created_at": "2026-07-22T20:58:31.429643Z",
  "updated_at": "2026-07-22T20:58:31.429643Z"
}

Get an app

Use the nextmv cloud app get command to retrieve an existing application by its ID.

nextmv cloud app get --app-id quirky-rabbit

⏳ Getting application...
{
  "id": "quirky-rabbit",
  "name": "A quirky rabbit",
  "description": "",
  "type": "custom",
  "default_instance": "",
  "default_experiment_instance": "",
  "subscription_id": "",
  "locked": false,
  "created_at": "2026-07-22T20:58:31.429643Z",
  "updated_at": "2026-07-22T20:58:31.429643Z"
}

You can list all applications in the account using the nextmv cloud app list command. The same information is displayed as for the individual applications, but as an array of objects.

nextmv cloud app list

⏳ Listing applications...    
[
  {
    "id": "quirky-rabbit-workflow",
    "name": "quirky-rabbit-workflow",
    "description": "",
    "type": "pipeline",
    "default_instance": "",
    "default_experiment_instance": "",
    "subscription_id": "",
    "locked": false,
    "created_at": "2026-07-22T20:59:40.777020Z",
    "updated_at": "2026-07-22T20:59:40.777020Z"
  },
  ...
  {
    "id": "quirky-rabbit",
    "name": "A quirky rabbit",
    "description": "",
    "type": "custom",
    "default_instance": "",
    "default_experiment_instance": "",
    "subscription_id": "",
    "locked": false,
    "created_at": "2026-07-22T20:58:31.429643Z",
    "updated_at": "2026-07-22T20:58:31.429643Z"
  }
]

For automated workflows, you can check if an application exists with the nextmv cloud app exists command. The command will return a zero exit code if the application exists, and a non-zero exit code if it does not.

nextmv cloud app exists --app-id quirky-rabbit

⏳ Checking if application exists...
{
  "exists": true
}

Update an app

You can update different attributes of an application using the nextmv cloud app update command, such as its:

  • Name
  • Description
  • Default instance ID
  • Default experiment instance ID

Please note that you cannot update the type of an application or its ID after it has been created.

nextmv cloud app update --app-id quirky-rabbit --description "This application inspects the quirks of rabbits"

⏳ Updating application...
✅ Application quirky-rabbit updated successfully.
{
  "id": "quirky-rabbit",
  "name": "A quirky rabbit",
  "description": "This application inspects the quirks of rabbits",
  "type": "custom",
  "default_instance": "",
  "default_experiment_instance": "",
  "subscription_id": "",
  "locked": false,
  "created_at": "2026-07-22T20:58:31.429643Z",
  "updated_at": "2026-07-22T21:14:19.399410Z"
}

Delete an app

Warning

Deleting an application is irreversible. All the app's data, such as its runs, instances, and experiments, will be permanently deleted.

Delete an application using the nextmv cloud app delete command. The CLI will prompt you to confirm the deletion but you can override it with the --yes option.

nextmv cloud app delete --app-id quirky-rabbit

Are you sure you want to delete application quirky-rabbit? This action cannot be undone.
💡 Confirm Yes
✅ Application quirky-rabbit deleted successfully.