NInixopus
Deploy

Update application

Changed on

Update application.

Auth: Required (bearer token). Scope: Organization-scoped in authenticated context. Side effects: May mutate server state.

put/api/v1/deploy/application

Request

  • Base URL
    http://:8080
  • URL
    http://:8080/api/v1/deploy/application
  • Auth
    none declared

Headers

Acceptstring

Request body */*

base_pathstring nullable

Base path for the application

build_packstring nullable

Build strategy. Must be valid if provided

build_variablesobject nullable

Key-value pairs passed as build arguments to Docker

dockerfile_pathstring nullable

Path to the Dockerfile relative to the repository root

domainsstring[] nullable

Custom domains for the application. Maximum 5 allowed

environmentstring nullable

Deployment environment. Must be valid if provided

environment_variablesobject nullable

Key-value pairs set as runtime environment variables

forceboolean nullable

Force the update even if a deployment is in progress

idstring uuid

Application ID to update

namestring nullable

Application name. Minimum 3 characters if provided

portinteger nullable

Port the application listens on

post_run_commandstring nullable

Command to run after the application starts

pre_run_commandstring nullable

Command to run before the application starts

routing_strategystring nullable

Routing strategy for multi-server deployments

Example request

{
  "base_path": "/",
  "build_pack": "dockerfile",
  "compose_domains": [
    {
      "domain": "app.example.com",
      "port": 8080,
      "service_name": "web"
    }
  ],
  "dockerfile_path": "Dockerfile",
  "environment": "production",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "my-web-app",
  "port": 3000,
  "post_run_command": "npm run seed",
  "pre_run_command": "npm run migrate",
  "routing_strategy": "round-robin"
}

Response

OK

messagestring
statusstring

Changes

  • 09f18af670c4Revision changes
    • breaking

      the request property // became required

    • breaking

      the request property's minLength was increased from 0 to 3

    • warning

      the / request property's maxLength was set to 5

    • warning

      the request property's max was set to 65535.00

    • warning

      the request property's min was set to 1.00

    • info

      api tag Deploy added

    • info

      api tag api/v1/deploy removed

    • info

      api tag application removed

  • 7dc7276cdc50Revision changes
    • info

      added the optional property /////// to the response with the status (media type: application/json)

    • info

      added the optional property /////// to the response with the status (media type: application/xml)

    • info

      added the optional property //// to the response with the status (media type: application/json)

    • info

      added the optional property //// to the response with the status (media type: application/xml)

    • info

      added the optional property ////// to the response with the status (media type: application/json)

    • info

      added the optional property ////// to the response with the status (media type: application/xml)

    • info

      added the optional property / to the response with the status (media type: application/json)

    • info

      added the optional property / to the response with the status (media type: application/xml)