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

# POST /application.delete

`POST /application.delete`

## Request body

- object
  - `applicationId` string, required

## Response `200`

Successful response

- object
  - `appName` string
  - `applicationId` string
  - `applicationStatus` 'idle' | 'running' | 'done' | 'error'
  - `autoDeploy` boolean, nullable
  - `bitbucket` object, nullable, required
    - `appPassword` string, nullable, required
    - `bitbucketId` string, required
    - `bitbucketUsername` string, nullable, required
    - `bitbucketWorkspaceName` string, nullable, required
    - `gitProviderId` string, required
  - `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
  - `deployments` object[], required
    - `applicationId` string, nullable, required
    - `backupId` string, nullable, required
    - `composeId` string, nullable, required
    - `createdAt` string, required
    - `deploymentId` string, required
    - `description` string, nullable, required
    - `errorMessage` string, nullable, required
    - `finishedAt` string, nullable, required
    - `isPreviewDeployment` boolean, nullable, required
    - `logPath` string, required
    - `pid` string, nullable, required
    - `previewDeploymentId` string, nullable, required
    - `rollbackId` string, nullable, required
    - `scheduleId` string, nullable, required
    - `serverId` string, nullable, required
    - `startedAt` string, nullable, required
    - `status` 'running' | 'done' | 'error', nullable, required
    - `title` string, required
    - `volumeBackupId` string, nullable, required
  - `description` string, nullable
  - `dockerBuildStage` string, nullable
  - `dockerContextPath` string, nullable
  - `dockerImage` string, nullable
  - `dockerfile` string, nullable
  - `domains` object[], required
    - `applicationId` string, nullable, required
    - `certificateType` 'letsencrypt' | 'none' | 'custom', required
    - `composeId` string, nullable, required
    - `createdAt` string, required
    - `customCertResolver` string, nullable, required
    - `domainId` string, required
    - `domainType` 'compose' | 'application' | 'preview', nullable, required
    - `host` string, required
    - `https` boolean, required
    - `internalPath` string, nullable, required
    - `path` string, nullable, required
    - `port` number, nullable, required
    - `previewDeploymentId` string, nullable, required
    - `serviceName` string, nullable, required
    - `stripPath` boolean, required
    - `uniqueConfigKey` number, required
  - `dropBuildPath` string, nullable
  - `enableSubmodules` boolean
  - `enabled` boolean, nullable
  - `env` string, nullable
  - `environment` object, required
    - `createdAt` string, required
    - `description` string, nullable, required
    - `env` string, required
    - `environmentId` string, required
    - `name` string, required
    - `project` object, required
      - `createdAt` string, required
      - `description` string, nullable, required
      - `env` string, required
      - `name` string, required
      - `organizationId` string, required
      - `projectId` string, required
    - `projectId` string, required
  - `environmentId` string, required
  - `gitea` object, nullable, required
    - `accessToken` string, nullable, required
    - `clientId` string, nullable, required
    - `clientSecret` string, nullable, required
    - `expiresAt` number, nullable, required
    - `gitProviderId` string, required
    - `giteaId` string, required
    - `giteaUrl` string, required
    - `lastAuthenticatedAt` number, nullable, required
    - `redirectUri` string, nullable, required
    - `refreshToken` string, nullable, required
    - `scopes` string, nullable, required
  - `giteaBranch` string, nullable
  - `giteaBuildPath` string, nullable
  - `giteaId` string, nullable
  - `giteaOwner` string, nullable
  - `giteaRepository` string, nullable
  - `github` object, nullable, required
    - `gitProviderId` string, required
    - `githubAppId` number, nullable, required
    - `githubAppName` string, nullable, required
    - `githubClientId` string, nullable, required
    - `githubClientSecret` string, nullable, required
    - `githubId` string, required
    - `githubInstallationId` string, nullable, required
    - `githubPrivateKey` string, nullable, required
    - `githubWebhookSecret` string, nullable, required
  - `githubId` string, nullable
  - `gitlab` object, nullable, required
    - `accessToken` string, nullable, required
    - `applicationId` string, nullable, required
    - `expiresAt` number, nullable, required
    - `gitProviderId` string, required
    - `gitlabId` string, required
    - `gitlabUrl` string, required
    - `groupName` string, nullable, required
    - `redirectUri` string, nullable, required
    - `refreshToken` string, nullable, required
    - `secret` string, nullable, required
  - `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
  - `mounts` object[], required
    - `applicationId` string, nullable, required
    - `composeId` string, nullable, required
    - `content` string, nullable, required
    - `filePath` string, nullable, required
    - `hostPath` string, nullable, required
    - `mariadbId` string, nullable, required
    - `mongoId` string, nullable, required
    - `mountId` string, required
    - `mountPath` string, required
    - `mysqlId` string, nullable, required
    - `postgresId` string, nullable, required
    - `redisId` string, nullable, required
    - `serviceType` 'application' | 'postgres' | 'mysql' | 'mariadb' | 'mongo' | 'redis' | 'compose', required
    - `type` 'bind' | 'volume' | 'file', required
    - `volumeName` string, nullable, required
  - `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
  - `ports` object[], required
    - `applicationId` string, required
    - `portId` string, required
    - `protocol` 'tcp' | 'udp', required
    - `publishMode` 'ingress' | 'host', required
    - `publishedPort` number, required
    - `targetPort` number, required
  - `previewBuildArgs` string, nullable
  - `previewCertificateType` 'letsencrypt' | 'none' | 'custom'
  - `previewCustomCertResolver` string, nullable
  - `previewDeployments` object[], required
    - `appName` string, required
    - `applicationId` string, required
    - `branch` string, required
    - `createdAt` string, required
    - `domainId` string, nullable, required
    - `expiresAt` string, nullable, required
    - `previewDeploymentId` string, required
    - `previewStatus` 'idle' | 'running' | 'done' | 'error', required
    - `pullRequestCommentId` string, required
    - `pullRequestId` string, required
    - `pullRequestNumber` string, required
    - `pullRequestTitle` string, required
    - `pullRequestURL` string, required
  - `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
  - `redirects` object[], required
    - `applicationId` string, required
    - `createdAt` string, required
    - `permanent` boolean, required
    - `redirectId` string, required
    - `regex` string, required
    - `replacement` string, required
    - `uniqueConfigKey` number, required
  - `refreshToken` string, nullable
  - `registry` object, nullable, required
    - `createdAt` string, required
    - `imagePrefix` string, nullable, required
    - `organizationId` string, required
    - `password` string, required
    - `registryId` string, required
    - `registryName` string, required
    - `registryType` 'selfHosted' | 'cloud', required
    - `registryUrl` string, required
    - `username` string, required
  - `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
  - `security` object[], required
    - `applicationId` string, required
    - `createdAt` string, required
    - `password` string, required
    - `securityId` string, required
    - `username` string, required
  - `server` object, nullable, required
    - `appName` string, required
    - `command` string, required
    - `createdAt` string, required
    - `description` string, nullable, required
    - `enableDockerCleanup` boolean, required
    - `ipAddress` string, required
    - `metricsConfig` union, required
      - string
      - number
      - boolean
      - 'null', nullable
      - unknown[]
        - unknown
      - object
    - `name` string, required
    - `organizationId` string, required
    - `port` number, required
    - `serverId` string, required
    - `serverStatus` 'active' | 'inactive', required
    - `sshKeyId` string, nullable, required
    - `username` string, 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)