Dokploy

Application

POST
/application.create

Application create

/application.create

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

name
Required
string

Minimum length: 1

appNamestring

descriptionstring | null

projectId
Required
string

serverIdstring | null

curl -X POST "http://your-dokploy-instance.com/api/application.create" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "appName": "string",
    "description": "string",
    "projectId": "string",
    "serverId": "string"
  }'

Successful response

GET
/application.one

Application one

/application.one

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Query Parameters

applicationId
Required
string

curl -X GET "http://your-dokploy-instance.com/api/application.one?applicationId=string" \
  -H "Authorization: Bearer <token>"

Successful response

POST
/application.reload

Application reload

/application.reload

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

appName
Required
string

applicationId
Required
string

curl -X POST "http://your-dokploy-instance.com/api/application.reload" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "appName": "string",
    "applicationId": "string"
  }'

Successful response

POST
/application.delete

Application delete

/application.delete

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

applicationId
Required
string

curl -X POST "http://your-dokploy-instance.com/api/application.delete" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "string"
  }'

Successful response

POST
/application.stop

Application stop

/application.stop

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

applicationId
Required
string

curl -X POST "http://your-dokploy-instance.com/api/application.stop" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "string"
  }'

Successful response

POST
/application.start

Application start

/application.start

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

applicationId
Required
string

curl -X POST "http://your-dokploy-instance.com/api/application.start" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "string"
  }'

Successful response

POST
/application.redeploy

Application redeploy

/application.redeploy

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

applicationId
Required
string

curl -X POST "http://your-dokploy-instance.com/api/application.redeploy" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "string"
  }'

Successful response

POST
/application.saveEnvironment

Application save Environment

/application.saveEnvironment

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

applicationId
Required
string

envstring | null

buildArgsstring | null

curl -X POST "http://your-dokploy-instance.com/api/application.saveEnvironment" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "string",
    "env": "string",
    "buildArgs": "string"
  }'

Successful response

POST
/application.saveBuildType

Application save Build Type

/application.saveBuildType

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

applicationId
Required
string

buildType
Required
string

Value in: "dockerfile" | "heroku_buildpacks" | "paketo_buildpacks" | "nixpacks" | "static"

dockerfilestring | null

dockerContextPath
Required
string | null

dockerBuildStage
Required
string | null

publishDirectorystring | null

curl -X POST "http://your-dokploy-instance.com/api/application.saveBuildType" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "string",
    "buildType": "dockerfile",
    "dockerfile": "string",
    "dockerContextPath": "string",
    "dockerBuildStage": "string",
    "publishDirectory": "string"
  }'

Successful response

POST
/application.saveGithubProvider

Application save Github Provider

/application.saveGithubProvider

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

applicationId
Required
string

repositorystring | null

branchstring | null

owner
Required
string | null

buildPathstring | null

githubId
Required
string | null

curl -X POST "http://your-dokploy-instance.com/api/application.saveGithubProvider" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "string",
    "repository": "string",
    "branch": "string",
    "owner": "string",
    "buildPath": "string",
    "githubId": "string"
  }'

Successful response

POST
/application.saveGitlabProvider

Application save Gitlab Provider

/application.saveGitlabProvider

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

applicationId
Required
string

gitlabBranch
Required
string | null

gitlabBuildPath
Required
string | null

gitlabOwner
Required
string | null

gitlabRepository
Required
string | null

gitlabId
Required
string | null

gitlabProjectId
Required
number | null

gitlabPathNamespace
Required
string | null

curl -X POST "http://your-dokploy-instance.com/api/application.saveGitlabProvider" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "string",
    "gitlabBranch": "string",
    "gitlabBuildPath": "string",
    "gitlabOwner": "string",
    "gitlabRepository": "string",
    "gitlabId": "string",
    "gitlabProjectId": 0,
    "gitlabPathNamespace": "string"
  }'

Successful response

POST
/application.saveBitbucketProvider

Application save Bitbucket Provider

/application.saveBitbucketProvider

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

bitbucketBranch
Required
string | null

bitbucketBuildPath
Required
string | null

bitbucketOwner
Required
string | null

bitbucketRepository
Required
string | null

bitbucketId
Required
string | null

applicationId
Required
string

curl -X POST "http://your-dokploy-instance.com/api/application.saveBitbucketProvider" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "bitbucketBranch": "string",
    "bitbucketBuildPath": "string",
    "bitbucketOwner": "string",
    "bitbucketRepository": "string",
    "bitbucketId": "string",
    "applicationId": "string"
  }'

Successful response

POST
/application.saveDockerProvider

Application save Docker Provider

/application.saveDockerProvider

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

dockerImagestring | null

applicationId
Required
string

usernamestring | null

passwordstring | null

curl -X POST "http://your-dokploy-instance.com/api/application.saveDockerProvider" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "dockerImage": "string",
    "applicationId": "string",
    "username": "string",
    "password": "string"
  }'

Successful response

POST
/application.saveGitProdiver

Application save Git Prodiver

/application.saveGitProdiver

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

customGitBranchstring | null

applicationId
Required
string

customGitBuildPathstring | null

customGitUrlstring | null

customGitSSHKeyIdstring | null

curl -X POST "http://your-dokploy-instance.com/api/application.saveGitProdiver" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "customGitBranch": "string",
    "applicationId": "string",
    "customGitBuildPath": "string",
    "customGitUrl": "string",
    "customGitSSHKeyId": "string"
  }'

Successful response

POST
/application.markRunning

Application mark Running

/application.markRunning

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

applicationId
Required
string

curl -X POST "http://your-dokploy-instance.com/api/application.markRunning" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "string"
  }'

Successful response

POST
/application.update

Application update

/application.update

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

applicationId
Required
string

Minimum length: 1

namestring

Minimum length: 1

appNamestring

descriptionstring | null

envstring | null

buildArgsstring | null

memoryReservationnumber | null

memoryLimitnumber | null

cpuReservationnumber | null

cpuLimitnumber | null

titlestring | null

enabledboolean | null

subtitlestring | null

commandstring | null

refreshTokenstring | null

sourceTypestring

Value in: "github" | "docker" | "git"

repositorystring | null

ownerstring | null

branchstring | null

buildPathstring | null

autoDeployboolean | null

gitlabProjectIdnumber | null

gitlabRepositorystring | null

gitlabOwnerstring | null

gitlabBranchstring | null

gitlabBuildPathstring | null

gitlabPathNamespacestring | null

bitbucketRepositorystring | null

bitbucketOwnerstring | null

bitbucketBranchstring | null

bitbucketBuildPathstring | null

usernamestring | null

passwordstring | null

dockerImagestring | null

customGitUrlstring | null

customGitBranchstring | null

customGitBuildPathstring | null

customGitSSHKeyIdstring | null

dockerfilestring | null

dockerContextPathstring | null

dockerBuildStagestring | null

dropBuildPathstring | null

healthCheckSwarmobject | null

restartPolicySwarmobject | null

placementSwarmobject | null

updateConfigSwarmobject | null

rollbackConfigSwarmobject | null

modeSwarmobject | null

labelsSwarmobject | null

networkSwarmarray<object> | null

replicasnumber

applicationStatusstring

Value in: "idle" | "running" | "done" | "error"

buildTypestring

Value in: "dockerfile" | "heroku_buildpacks" | "paketo_buildpacks" | "nixpacks" | "static"

publishDirectorystring | null

createdAtstring

registryIdstring | null

projectIdstring

githubIdstring | null

gitlabIdstring | null

bitbucketIdstring | null

curl -X POST "http://your-dokploy-instance.com/api/application.update" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "string",
    "name": "string",
    "appName": "string",
    "description": "string",
    "env": "string",
    "buildArgs": "string",
    "memoryReservation": 0,
    "memoryLimit": 0,
    "cpuReservation": 0,
    "cpuLimit": 0,
    "title": "string",
    "enabled": true,
    "subtitle": "string",
    "command": "string",
    "refreshToken": "string",
    "sourceType": "github",
    "repository": "string",
    "owner": "string",
    "branch": "string",
    "buildPath": "string",
    "autoDeploy": true,
    "gitlabProjectId": 0,
    "gitlabRepository": "string",
    "gitlabOwner": "string",
    "gitlabBranch": "string",
    "gitlabBuildPath": "string",
    "gitlabPathNamespace": "string",
    "bitbucketRepository": "string",
    "bitbucketOwner": "string",
    "bitbucketBranch": "string",
    "bitbucketBuildPath": "string",
    "username": "string",
    "password": "string",
    "dockerImage": "string",
    "customGitUrl": "string",
    "customGitBranch": "string",
    "customGitBuildPath": "string",
    "customGitSSHKeyId": "string",
    "dockerfile": "string",
    "dockerContextPath": "string",
    "dockerBuildStage": "string",
    "dropBuildPath": "string",
    "healthCheckSwarm": {
      "Test": [
        "string"
      ],
      "Interval": 0,
      "Timeout": 0,
      "StartPeriod": 0,
      "Retries": 0
    },
    "restartPolicySwarm": {
      "Condition": "string",
      "Delay": 0,
      "MaxAttempts": 0,
      "Window": 0
    },
    "placementSwarm": {
      "Constraints": [
        "string"
      ],
      "Preferences": [
        {
          "Spread": {
            "SpreadDescriptor": "string"
          }
        }
      ],
      "MaxReplicas": 0,
      "Platforms": [
        {
          "Architecture": "string",
          "OS": "string"
        }
      ]
    },
    "updateConfigSwarm": {
      "Parallelism": 0,
      "Delay": 0,
      "FailureAction": "string",
      "Monitor": 0,
      "MaxFailureRatio": 0,
      "Order": "string"
    },
    "rollbackConfigSwarm": {
      "Parallelism": 0,
      "Delay": 0,
      "FailureAction": "string",
      "Monitor": 0,
      "MaxFailureRatio": 0,
      "Order": "string"
    },
    "modeSwarm": {
      "Replicated": {
        "Replicas": 0
      },
      "Global": {},
      "ReplicatedJob": {
        "MaxConcurrent": 0,
        "TotalCompletions": 0
      },
      "GlobalJob": {}
    },
    "labelsSwarm": {
      "property1": "string",
      "property2": "string"
    },
    "networkSwarm": [
      {
        "Target": "string",
        "Aliases": [
          "string"
        ],
        "DriverOpts": {}
      }
    ],
    "replicas": 0,
    "applicationStatus": "idle",
    "buildType": "dockerfile",
    "publishDirectory": "string",
    "createdAt": "string",
    "registryId": "string",
    "projectId": "string",
    "githubId": "string",
    "gitlabId": "string",
    "bitbucketId": "string"
  }'

Successful response

POST
/application.refreshToken

Application refresh Token

/application.refreshToken

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

applicationId
Required
string

curl -X POST "http://your-dokploy-instance.com/api/application.refreshToken" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "string"
  }'

Successful response

POST
/application.deploy

Application deploy

/application.deploy

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

applicationId
Required
string

curl -X POST "http://your-dokploy-instance.com/api/application.deploy" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "string"
  }'

Successful response

POST
/application.cleanQueues

Application clean Queues

/application.cleanQueues

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

applicationId
Required
string

curl -X POST "http://your-dokploy-instance.com/api/application.cleanQueues" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "string"
  }'

Successful response

GET
/application.readTraefikConfig

Application read Traefik Config

/application.readTraefikConfig

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Query Parameters

applicationId
Required
string

curl -X GET "http://your-dokploy-instance.com/api/application.readTraefikConfig?applicationId=string" \
  -H "Authorization: Bearer <token>"

Successful response

POST
/application.updateTraefikConfig

Application update Traefik Config

/application.updateTraefikConfig

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Request Body

application/jsonRequired

applicationId
Required
string

traefikConfig
Required
string

curl -X POST "http://your-dokploy-instance.com/api/application.updateTraefikConfig" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationId": "string",
    "traefikConfig": "string"
  }'

Successful response

GET
/application.readAppMonitoring

Application read App Monitoring

/application.readAppMonitoring

The Authorization access token

Authorization

Authorization
Required
Bearer <token>

In: header

Query Parameters

appName
Required
string

curl -X GET "http://your-dokploy-instance.com/api/application.readAppMonitoring?appName=string" \
  -H "Authorization: Bearer <token>"

Successful response