---
title: "POST /application.create"
method: POST
path: "/application.create"
tags: ["application"]
---

# POST /application.create

`POST /application.create`

## Request body

- object
  - `appName` string
  - `description` string, nullable
  - `environmentId` string, required
  - `name` string, required
  - `serverId` string, nullable

## Response `200`

Successful response

- object
  - `appName` string
  - `applicationId` string
  - `applicationStatus` 'idle' | 'running' | 'done' | 'error'
  - `autoDeploy` boolean, nullable
  - `bitbucketBranch` string, nullable
  - `bitbucketBuildPath` string, nullable
  - `bitbucketId` string, nullable
  - `bitbucketOwner` string, nullable
  - `bitbucketRepository` string, nullable
  - `branch` string, nullable
  - `buildArgs` string, nullable
  - `buildPath` string, nullable
  - `buildType` 'dockerfile' | 'heroku_buildpacks' | 'paketo_buildpacks' | 'nixpacks' | 'static' | 'railpack'
  - `cleanCache` boolean, nullable
  - `command` string, nullable
  - `cpuLimit` string, nullable
  - `cpuReservation` string, nullable
  - `createdAt` string
  - `customGitBranch` string, nullable
  - `customGitBuildPath` string, nullable
  - `customGitSSHKeyId` string, nullable
  - `customGitUrl` string, nullable
  - `description` string, nullable
  - `dockerBuildStage` string, nullable
  - `dockerContextPath` string, nullable
  - `dockerImage` string, nullable
  - `dockerfile` string, nullable
  - `dropBuildPath` string, nullable
  - `enableSubmodules` boolean
  - `enabled` boolean, nullable
  - `env` string, nullable
  - `environmentId` string, required
  - `giteaBranch` string, nullable
  - `giteaBuildPath` string, nullable
  - `giteaId` string, nullable
  - `giteaOwner` string, nullable
  - `giteaRepository` string, nullable
  - `githubId` string, nullable
  - `gitlabBranch` string, nullable
  - `gitlabBuildPath` string, nullable
  - `gitlabId` string, nullable
  - `gitlabOwner` string, nullable
  - `gitlabPathNamespace` string, nullable
  - `gitlabProjectId` number, nullable
  - `gitlabRepository` string, nullable
  - `healthCheckSwarm` object, nullable
    - `Interval` number
    - `Retries` number
    - `StartPeriod` number
    - `Test` string[]
    - `Timeout` number
  - `herokuVersion` string, nullable
  - `isPreviewDeploymentsActive` boolean, nullable
  - `isStaticSpa` boolean, nullable
  - `labelsSwarm` object, nullable
  - `memoryLimit` string, nullable
  - `memoryReservation` string, nullable
  - `modeSwarm` object, nullable
    - `Global` object
    - `GlobalJob` object
    - `Replicated` object
      - `Replicas` number
    - `ReplicatedJob` object
      - `MaxConcurrent` number
      - `TotalCompletions` number
  - `name` string, required
  - `networkSwarm` object[], nullable
    - `Aliases` string[]
    - `DriverOpts` object
    - `Target` string
  - `owner` string, nullable
  - `password` string, nullable
  - `placementSwarm` object, nullable
    - `Constraints` string[]
    - `MaxReplicas` number
    - `Platforms` object[]
      - `Architecture` string, required
      - `OS` string, required
    - `Preferences` object[]
      - `Spread` object, required
        - `SpreadDescriptor` string, required
  - `previewBuildArgs` string, nullable
  - `previewCertificateType` 'letsencrypt' | 'none' | 'custom'
  - `previewCustomCertResolver` string, nullable
  - `previewEnv` string, nullable
  - `previewHttps` boolean
  - `previewLabels` string[], nullable
  - `previewLimit` number, nullable
  - `previewPath` string, nullable
  - `previewPort` number, nullable
  - `previewRequireCollaboratorPermissions` boolean, nullable
  - `previewWildcard` string, nullable
  - `publishDirectory` string, nullable
  - `railpackVersion` string, nullable
  - `refreshToken` string, nullable
  - `registryId` string, nullable
  - `registryUrl` string, nullable
  - `replicas` number
  - `repository` string, nullable
  - `restartPolicySwarm` object, nullable
    - `Condition` string
    - `Delay` number
    - `MaxAttempts` number
    - `Window` number
  - `rollbackActive` boolean, nullable
  - `rollbackConfigSwarm` object, nullable
    - `Delay` number
    - `FailureAction` string
    - `MaxFailureRatio` number
    - `Monitor` number
    - `Order` string, required
    - `Parallelism` number, required
  - `serverId` string, nullable
  - `sourceType` 'github' | 'docker' | 'git' | 'gitlab' | 'bitbucket' | 'gitea' | 'drop'
  - `subtitle` string, nullable
  - `title` string, nullable
  - `triggerType` 'push' | 'tag', nullable
  - `updateConfigSwarm` object, nullable
    - `Delay` number
    - `FailureAction` string
    - `MaxFailureRatio` number
    - `Monitor` number
    - `Order` string, required
    - `Parallelism` number, required
  - `username` string, nullable
  - `watchPaths` string[], nullable

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/charliedevelops/apis/dokploy-api.md) · [All operations](https://skmtc.net/charliedevelops/apis/dokploy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charliedevelops/dokploy-api/versions/50e2e470fdd0/schema)