NInixopus
Deploy

Create project

Changed on

Create project.

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

post/api/v1/deploy/application/project

Request

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

Headers

Acceptstring

Request body */*

base_pathstring nullable

Base path for the application. Defaults to / if not specified

branchstring nullable

Git branch to deploy. Defaults to main if not specified

build_packstring nullable

Build strategy. Defaults to dockerfile if not specified

build_variablesobject nullable

Key-value pairs passed as build arguments to Docker

dockerfile_pathstring nullable

Path to the Dockerfile. Defaults to Dockerfile if not specified

domainsstring[] nullable

Custom domains for the project

environmentstring nullable

Deployment environment. Defaults to production if not specified

environment_variablesobject nullable

Key-value pairs set as runtime environment variables

namestring required

Project name

portinteger nullable

Port the application listens on. Defaults to 3000 if not specified

post_run_commandstring nullable

Command to run after the application starts

pre_run_commandstring nullable

Command to run before the application starts

primary_server_idstring uuid

Primary server ID for routing

repositorystring required

Numeric GitHub repository ID (get from GET /github-connector/repositories). Do NOT pass owner/repo slug — it will fail at parse time.

routing_strategystring nullable

Routing strategy for multi-server deployments

server_idsstring[] nullable

Server IDs to deploy the application to

sourcestring nullable

Source type of the repository

Example request

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

Response

Created

messagestring
statusstring

Changes

  • 09f18af670c4Revision changes
    • breaking

      the request property // became required

    • breaking

      the request property // became required

    • breaking

      the request property // became required

    • breaking

      the request property became required

    • breaking

      the request property became required

    • breaking

      removed the success response with the status

    • info

      api tag Deploy added

    • info

      api tag api/v1/deploy removed

    • info

      api tag application removed

    • info

      api tag project removed

    • info

      added the success response with the status

  • 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)