---
title: "Deploy application"
method: POST
path: "/api/v1/deploy/application"
tags: ["Deploy"]
---

# Deploy application

`POST /api/v1/deploy/application`

Deploy application.

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

## Headers

- `Accept` string

## Response `201`

Created

- ApplicationResponse — ApplicationResponse schema
  - `data` object
    - `base_path` string
    - `branch` string
    - `build_pack` string
    - `build_variables` string
    - `compose_services` object[], nullable
      - `application_id` string, uuid
      - `created_at` string, date-time
      - `domains` object[], nullable
        - `application_id` string, uuid
        - `compose_service` ComposeService
          - `application_id` string, uuid
          - `created_at` string, date-time
          - `domains` object[], nullable
            - `application_id` string, uuid
            - `compose_service` ComposeService — recursive
            - `compose_service_id` string, uuid
            - `created_at` string, date-time
            - `domain` string
            - `id` string, uuid
            - `port` integer, nullable
          - `id` string, uuid
          - `port` integer
          - `service_name` string
          - `updated_at` string, date-time
        - `compose_service_id` string, uuid
        - `created_at` string, date-time
        - `domain` string
        - `id` string, uuid
        - `port` integer, nullable
      - `id` string, uuid
      - `port` integer
      - `service_name` string
      - `updated_at` string, date-time
    - `created_at` string, date-time
    - `deployments` object[], nullable
      - `application` Application, nullable
        - `base_path` string
        - `branch` string
        - `build_pack` string
        - `build_variables` string
        - `compose_services` object[], nullable
          - `application_id` string, uuid
          - `created_at` string, date-time
          - `domains` object[], nullable
            - `application_id` string, uuid
            - `compose_service` ComposeService
              - …
            - `compose_service_id` string, uuid
            - `created_at` string, date-time
            - `domain` string
            - `id` string, uuid
            - `port` integer, nullable
          - `id` string, uuid
          - `port` integer
          - `service_name` string
          - `updated_at` string, date-time
        - `created_at` string, date-time
        - `deployments` ApplicationDeployment[], nullable
          - `application` object, nullable
            - `base_path` string
            - `branch` string
            - `build_pack` string
            - `build_variables` string
            - `compose_services` object[], nullable
              - …
            - `created_at` string, date-time
            - `deployments` ApplicationDeployment[], nullable
            - `dockerfile_path` string
            - `domains` object[], nullable
              - …
            - `environment` string
            - `environment_variables` string
            - `family_id` string, uuid
            - `id` string, uuid
            - `is_live_deployment` boolean
            - `labels` string[], nullable
            - `logs` object[], nullable
              - …
            - `name` string
            - `organization_id` string, uuid
            - `port` integer
            - `post_run_command` string
            - `pre_run_command` string
            - `proxy_server` string
            - `repository` string
            - `routing_strategy` string
            - `servers` object[], nullable
              - …
            - `source` string
            - `status` object, nullable
              - …
            - `template_id` string, uuid
            - `updated_at` string, date-time
            - `user_id` string, uuid
          - `application_id` string, uuid
          - `children` ApplicationDeployment[], nullable
          - `commit_hash` string
          - `container_id` string, uuid
          - `container_image` string
          - `container_name` string
          - `container_status` string
          - `created_at` string, date-time
          - `id` string, uuid
          - `image_s3_key` string
          - `image_size` integer
          - `logs` object[], nullable
            - `application_deployment_id` string, uuid
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `id` string, uuid
            - `log` string
            - `updated_at` string, date-time
          - `parent_deployment_id` string, uuid
          - `server_id` string, uuid
          - `status` object, nullable
            - `application_deployment_id` string, uuid
            - `created_at` string, date-time
            - `id` string, uuid
            - `status` string
            - `updated_at` string, date-time
          - `updated_at` string, date-time
        - `dockerfile_path` string
        - `domains` object[], nullable
          - `application_id` string, uuid
          - `compose_service` object, nullable
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `domains` ApplicationDomain[]
              - …
            - `id` string, uuid
            - `port` integer
            - `service_name` string
            - `updated_at` string, date-time
          - `compose_service_id` string, uuid
          - `created_at` string, date-time
          - `domain` string
          - `id` string, uuid
          - `port` integer, nullable
        - `environment` string
        - `environment_variables` string
        - `family_id` string, uuid
        - `id` string, uuid
        - `is_live_deployment` boolean
        - `labels` string[], nullable
        - `logs` object[], nullable
          - `application_deployment_id` string, uuid
          - `application_id` string, uuid
          - `created_at` string, date-time
          - `id` string, uuid
          - `log` string
          - `updated_at` string, date-time
        - `name` string
        - `organization_id` string, uuid
        - `port` integer
        - `post_run_command` string
        - `pre_run_command` string
        - `proxy_server` string
        - `repository` string
        - `routing_strategy` string
        - `servers` object[], nullable
          - `application_id` string, uuid
          - `created_at` string, date-time
          - `id` string, uuid
          - `is_primary` boolean
          - `server` object, nullable
            - `auth_method` string
            - `created_at` string, date-time
            - `deleted_at` string, date-time, nullable
            - `description` string, nullable
            - `fingerprint` string, nullable
            - `host` string, nullable
            - `id` string, uuid
            - `is_active` boolean
            - `is_default` boolean
            - `key_size` integer, nullable
            - `key_type` string, nullable
            - `last_used_at` string, date-time, nullable
            - `name` string
            - `organization_id` string, uuid
            - `port` integer, nullable
            - `proxy_host` string, nullable
            - `public_key` string, nullable
            - `updated_at` string, date-time
            - `user` string, nullable
          - `server_id` string, uuid
        - `source` string
        - `status` object, nullable
          - `application_id` string, uuid
          - `created_at` string, date-time
          - `id` string, uuid
          - `status` string
          - `updated_at` string, date-time
        - `template_id` string, uuid
        - `updated_at` string, date-time
        - `user_id` string, uuid
      - `application_id` string, uuid
      - `children` ApplicationDeployment[]
        - `application` object, nullable
          - `base_path` string
          - `branch` string
          - `build_pack` string
          - `build_variables` string
          - `compose_services` object[], nullable
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `domains` object[], nullable
              - …
            - `id` string, uuid
            - `port` integer
            - `service_name` string
            - `updated_at` string, date-time
          - `created_at` string, date-time
          - `deployments` ApplicationDeployment[], nullable
          - `dockerfile_path` string
          - `domains` object[], nullable
            - `application_id` string, uuid
            - `compose_service` object, nullable
              - …
            - `compose_service_id` string, uuid
            - `created_at` string, date-time
            - `domain` string
            - `id` string, uuid
            - `port` integer, nullable
          - `environment` string
          - `environment_variables` string
          - `family_id` string, uuid
          - `id` string, uuid
          - `is_live_deployment` boolean
          - `labels` string[], nullable
          - `logs` object[], nullable
            - `application_deployment_id` string, uuid
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `id` string, uuid
            - `log` string
            - `updated_at` string, date-time
          - `name` string
          - `organization_id` string, uuid
          - `port` integer
          - `post_run_command` string
          - `pre_run_command` string
          - `proxy_server` string
          - `repository` string
          - `routing_strategy` string
          - `servers` object[], nullable
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `id` string, uuid
            - `is_primary` boolean
            - `server` object, nullable
              - …
            - `server_id` string, uuid
          - `source` string
          - `status` object, nullable
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `id` string, uuid
            - `status` string
            - `updated_at` string, date-time
          - `template_id` string, uuid
          - `updated_at` string, date-time
          - `user_id` string, uuid
        - `application_id` string, uuid
        - `children` ApplicationDeployment[], nullable
        - `commit_hash` string
        - `container_id` string, uuid
        - `container_image` string
        - `container_name` string
        - `container_status` string
        - `created_at` string, date-time
        - `id` string, uuid
        - `image_s3_key` string
        - `image_size` integer
        - `logs` object[], nullable
          - `application_deployment_id` string, uuid
          - `application_id` string, uuid
          - `created_at` string, date-time
          - `id` string, uuid
          - `log` string
          - `updated_at` string, date-time
        - `parent_deployment_id` string, uuid
        - `server_id` string, uuid
        - `status` object, nullable
          - `application_deployment_id` string, uuid
          - `created_at` string, date-time
          - `id` string, uuid
          - `status` string
          - `updated_at` string, date-time
        - `updated_at` string, date-time
      - `commit_hash` string
      - `container_id` string, uuid
      - `container_image` string
      - `container_name` string
      - `container_status` string
      - `created_at` string, date-time
      - `id` string, uuid
      - `image_s3_key` string
      - `image_size` integer
      - `logs` object[], nullable
        - `application_deployment_id` string, uuid
        - `application_id` string, uuid
        - `created_at` string, date-time
        - `id` string, uuid
        - `log` string
        - `updated_at` string, date-time
      - `parent_deployment_id` string, uuid
      - `server_id` string, uuid
      - `status` object, nullable
        - `application_deployment_id` string, uuid
        - `created_at` string, date-time
        - `id` string, uuid
        - `status` string
        - `updated_at` string, date-time
      - `updated_at` string, date-time
    - `dockerfile_path` string
    - `domains` object[], nullable
      - `application_id` string, uuid
      - `compose_service` object, nullable
        - `application_id` string, uuid
        - `created_at` string, date-time
        - `domains` ApplicationDomain[]
          - `application_id` string, uuid
          - `compose_service` ComposeService
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `domains` object[], nullable
              - …
            - `id` string, uuid
            - `port` integer
            - `service_name` string
            - `updated_at` string, date-time
          - `compose_service_id` string, uuid
          - `created_at` string, date-time
          - `domain` string
          - `id` string, uuid
          - `port` integer, nullable
        - `id` string, uuid
        - `port` integer
        - `service_name` string
        - `updated_at` string, date-time
      - `compose_service_id` string, uuid
      - `created_at` string, date-time
      - `domain` string
      - `id` string, uuid
      - `port` integer, nullable
    - `environment` string
    - `environment_variables` string
    - `family_id` string, uuid
    - `id` string, uuid
    - `is_live_deployment` boolean
    - `labels` string[], nullable
    - `logs` object[], nullable
      - `application_deployment_id` string, uuid
      - `application_id` string, uuid
      - `created_at` string, date-time
      - `id` string, uuid
      - `log` string
      - `updated_at` string, date-time
    - `name` string
    - `organization_id` string, uuid
    - `port` integer
    - `post_run_command` string
    - `pre_run_command` string
    - `proxy_server` string
    - `repository` string
    - `routing_strategy` string
    - `servers` object[], nullable
      - `application_id` string, uuid
      - `created_at` string, date-time
      - `id` string, uuid
      - `is_primary` boolean
      - `server` object, nullable
        - `auth_method` string
        - `created_at` string, date-time
        - `deleted_at` string, date-time, nullable
        - `description` string, nullable
        - `fingerprint` string, nullable
        - `host` string, nullable
        - `id` string, uuid
        - `is_active` boolean
        - `is_default` boolean
        - `key_size` integer, nullable
        - `key_type` string, nullable
        - `last_used_at` string, date-time, nullable
        - `name` string
        - `organization_id` string, uuid
        - `port` integer, nullable
        - `proxy_host` string, nullable
        - `public_key` string, nullable
        - `updated_at` string, date-time
        - `user` string, nullable
      - `server_id` string, uuid
    - `source` string
    - `status` object, nullable
      - `application_id` string, uuid
      - `created_at` string, date-time
      - `id` string, uuid
      - `status` string
      - `updated_at` string, date-time
    - `template_id` string, uuid
    - `updated_at` string, date-time
    - `user_id` string, uuid
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request _(validation or deserialization error)_
- `500` — Internal Server Error _(panics)_
- `default`

---

[API](https://skmtc.net/nixopus/apis/openapi.md) · [All operations](https://skmtc.net/nixopus/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nixopus/openapi/revisions/c5bacaea7239/schema)