Reference

Cloud API endpoints

Technical reference for the Nextmv Cloud API.

The format for timestamps should be RFC3339, e.g.: "2023-01-01T00:00:00Z".

The applications API endpoints can be used to manage, run, and deploy applications to Nextmv Cloud. They are also used to create and manage experiments for each application.

Note, all requests must be authenticated with Bearer Authentication. Make sure your request has a header containing your Nextmv Cloud API key, as such:

  • Key: Authorization
  • Value: Bearer <YOUR-API-KEY>
Authorization: Bearer <YOUR-API-KEY>
Copy

We strongly encourage you to see the list of available endpoints directly in Console. The endpoints are tailored to your specific application. You will find the same collection of endpoints in this page, but with the correct parameters already filled in.

Endpoints

Run execution

POSThttps://api.cloud.nextmv.io/v1/applications/{application_id}/runs

New application run.

Create new application run.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/runs/{run_id}

Get run result.

Get the result of a run.

Run management

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/runs

List past runs.

List past runs for application (50 max per request).

PUThttps://api.cloud.nextmv.io/v1/applications/{application_id}/runs/{run_id}

Update name and description of run.

Update the name and/or description of a run.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/runs/{run_id}/metadata

Get run status without output.

Get the status of a run without the output.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/runs/{run_id}/input

Get run input.

Gets the input used for a run.

POSThttps://api.cloud.nextmv.io/v1/applications/{application_id}/runs/uploadurl

Retrieve unique upload URL and ID.

Retrieve a unique URL and ID for uploading run input (for large input files).

Versions

POSThttps://api.cloud.nextmv.io/v1/applications/{application_id}/versions

Create new version.

Create new application version using the current dev binary.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/versions

List versions.

List all versions for an application.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/versions/{version_id}

Get version information.

Get application version information specified by application and version ID.

PUThttps://api.cloud.nextmv.io/v1/applications/{application_id}/versions/{version_id}

Update version information.

Update application version information with defined data, specified by application and version ID.

DELETEhttps://api.cloud.nextmv.io/v1/applications/{application_id}/versions/{version_id}

Delete version.

Delete version, specified by application and version ID.

Instances

POSThttps://api.cloud.nextmv.io/v1/applications/{application_id}/instances

Create new instance.

Create new application instance for a specified version.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/instances

List instances.

List all instances for an application.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/instances/{instance_id}

Get instance information.

Get application instance information specified by application and instance ID.

PUThttps://api.cloud.nextmv.io/v1/applications/{application_id}/instances/{instance_id}

Update an instance.

Update application instance information with defined data, specified by application and instance ID.

DELETEhttps://api.cloud.nextmv.io/v1/applications/{application_id}/instances/{instance_id}

Delete instance.

Delete application instance, specified by application and instance ID.

Input sets

POSThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/inputsets

Create new input set.

Create new application input set for experiments.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/inputsets

List input sets.

List all input sets for an application.

PUThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/inputsets/{input_set_id}

Update input set metadata.

Update input set metadata with defined data, specified by application and input set ID.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/inputsets/{input_set_id}

Get input set information.

Get input set information specified by application and input set ID.

Batch Experiments

POSThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/batch

Create and start batch experiment.

Create and start batch experiment.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/batch

List batch experiments.

List batch experiments for an application.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/batch/{batch_id}

Get batch experiment status and results.

Get batch experiment status and results specified by application and batch ID.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/batch/{batch_id}/runs

List batch experiment runs.

List runs used for batch experiment specified by application and batch ID.

Shadow Tests

POSThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/shadow

Create a shadow test in draft mode.

Create a shadow test in draft mode.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/shadow

List shadow tests.

List shadow tests for an application.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/shadow/{shadow_id}

Get shadow test status and results.

Get shadow test status and results specified by application and shadow ID.

PUThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/shadow/{shadow_id}/start

Start shadow test.

Start shadow test.

PUThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/shadow/{shadow_id}/stop

Stop shadow test.

Stop shadow test.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/shadow/{shadow_id}/runs

List shadow test runs.

List runs part of a shadow test.

Switchback Tests

POSThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/switchback

Create a switchback experiment in draft mode.

Create a switchback experiment in draft mode.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/switchback

List switchback experiments.

List shadow tests for an application.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/switchback/{switchback_id}

Get switchback experiment status and results.

Get switchback experiment status and results specified by application and switchback experiment ID.

PUThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/switchback/{switchback_id}/start

Start switchback experiment.

Start switchback experiment.

PUThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/switchback/{switchback_id}/stop

Stop switchback experiment.

Stop switchback experiment.

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}/experiments/switchback/{switchback_id}/runs

List switchback experiment runs.

List runs part of a switchback experiment.

Admin

GEThttps://api.cloud.nextmv.io/v1/applications/{application_id}

Get application information.

Get application information specified by application ID.

PUThttps://api.cloud.nextmv.io/v1/applications/{application_id}

Update application information.

Update application information with defined data, specified by application ID.

DELETEhttps://api.cloud.nextmv.io/v1/applications/{application_id}

Delete application.

Delete application, specified by application ID.

Page last updated

Go to on-page nav menu