Applications | Discloud Docs

Upload application

post

Upload a new application to Discloud

Authorizations

api-tokenstringRequired

Body

filestring · binaryRequired

Application file to upload (.ZIP format)

Responses

200

Upload response

application/json

Responseone of

or

401

Authentication error

application/json

404

Missing required file

application/json

post

/upload

POST /v2/upload HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}

No content

Get application information

get

Retrieves information about a specific application or all applications

Authorizations

api-tokenstringRequired

Path parameters

appIDstringRequired

ID of the application or "all" to retrieve all applications

Responses

200

Application information retrieved successfully

application/json

401

Authentication error

application/json

404

Application not found

application/json

get

/app/{appID}

GET /v2/app/{appID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "The information of your application has been loaded.",
  "apps": {
    "id": "1745338954955",
    "avatarURL": "https://i.ibb.co/xSxd0Hv1/Uma105.png",
    "name": "Temp2 - JS",
    "type": 0,
    "online": true,
    "ramKilled": false,
    "exitCode": 0,
    "ram": 100,
    "mainFile": "src/index.js",
    "lang": "javascript",
    "mods": [],
    "autoDeployGit": "no",
    "autoRestart": false
  }
}

Get application status

get

Retrieves status information about a specific application or all applications

Authorizations

api-tokenstringRequired

Path parameters

appIDstringRequired

ID of the application or "all" to retrieve status for all applications

Responses

200

Application status retrieved successfully

application/json

401

Authentication error

application/json

404

Application not found

application/json

get

/app/{appID}/status

GET /v2/app/{appID}/status HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "The status of your applications were loaded",
  "apps": {
    "id": "1745338954955",
    "container": "Online",
    "cpu": "0.00%",
    "memory": "39.9MB/100MB",
    "ssd": "1.999GB",
    "netIO": {
      "down": "61KB",
      "up": "16KB"
    },
    "last_restart": "30 minutes",
    "startedAt": "2025-04-22T16:24:55.978921501Z"
  }
}

Get application logs

get

Retrieves logs for a specific application or all applications

Authorizations

api-tokenstringRequired

Path parameters

appIDstringRequired

ID of the application or "all" to retrieve logs for all applications

Responses

200

Application logs retrieved successfully

application/json

401

Authentication error

application/json

404

Application not found

application/json

get

/app/{appID}/logs

GET /v2/app/{appID}/logs HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "The logs of your applications were loaded",
  "apps": {
    "id": "1745338954955",
    "terminal": {
      "big": "2025-04-22T14:30:00.123Z Application starting...\n2025-04-22T14:30:01.234Z Environment: production\n2025-04-22T14:30:01.567Z Loading configuration files...\n2025-04-22T14:30:02.123Z Database connection established\n2025-04-22T14:30:02.456Z Initializing server modules\n2025-04-22T14:30:03.678Z Server listening on port 8080\n2025-04-22T14:30:04.123Z WebSocket service initialized\n2025-04-22T14:30:04.567Z Cache warming up\n2025-04-22T14:30:05.234Z Application startup complete\n2025-04-22T14:30:06.123Z Processing initial requests",
      "small": "2025-04-22T14:30:00.123Z Application starting...\n2025-04-22T14:30:02.123Z Database connection established\n2025-04-22T14:30:03.678Z Server listening on port 8080\n2025-04-22T14:30:05.234Z Application startup complete",
      "url": "discloud.app"
    }
  }
}

Get application backup

get

Generates and retrieves backup for a specific application or all applications

Authorizations

api-tokenstringRequired

Path parameters

appIDstringRequired

ID of the application or "all" to retrieve backups for all applications

Responses

200

Application backup generated successfully

application/json

401

Authentication error

application/json

404

Application not found

application/json

get

/app/{appID}/backup

GET /v2/app/{appID}/backup HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "The backup of your application will be generated successfully",
  "backups": {
    "id": "1745338954955",
    "url": "https://discloud.app/backup/A1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6Q7R8S9T0U1V2W3X4Y5Z6.zip"
  }
}

Start application

put

Starts a specific application or all applications

Authorizations

api-tokenstringRequired

Path parameters

appIDstringRequired

ID of the application or "all" to start all applications

Responses

200

Application started successfully

application/json

401

Authentication error

application/json

404

Application not found

application/json

put

/app/{appID}/start

PUT /v2/app/{appID}/start HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Its application was connected.",
  "appStatus": {
    "online": true,
    "ramKilled": false,
    "exitCode": 0
  }
}

Restart application

put

Restarts a specific application or all applications

Authorizations

api-tokenstringRequired

Path parameters

appIDstringRequired

ID of the application or "all" to restart all applications

Responses

200

Application restarted successfully

application/json

401

Authentication error

application/json

404

Application not found

application/json

put

/app/{appID}/restart

PUT /v2/app/{appID}/restart HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Its application was restarted."
}

Stop application

put

Stops a specific application or all applications

Authorizations

api-tokenstringRequired

Path parameters

appIDstringRequired

ID of the application or "all" to stop all applications

Responses

200

Application stop response

application/json

401

Authentication error

application/json

404

Application not found

application/json

put

/app/{appID}/stop

PUT /v2/app/{appID}/stop HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Your application has been turned off."
}

Update application RAM

put

Updates the RAM allocation for a specific application

Authorizations

api-tokenstringRequired

Path parameters

appIDstringRequired

ID of the application to update RAM for

Body

ramMBintegerRequired

The amount of RAM in MB to allocate to the application

Example: 200

Responses

200

RAM update response

application/json

401

Authentication error

application/json

404

Application not found or plan limitation

application/json

put

/app/{appID}/ram

PUT /v2/app/{appID}/ram HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "ramMB": 200
}

{
  "status": "ok",
  "statusCode": 200,
  "message": "The memory of your application has been successfully changed."
}

Update application code

put

Updates an existing application by uploading a new version of the code

Authorizations

api-tokenstringRequired

Path parameters

appIDstringRequired

ID of the application to update

Body

filestring · binaryRequired

Application file to upload (.ZIP format)

Responses

200

Commit response

application/json

401

Authentication error

application/json

404

Application not found

application/json

put

/app/{appID}/commit

PUT /v2/app/{appID}/commit HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}

{
  "summary": "Successful commit (may timeout)",
  "description": "When successful, the request may timeout without returning a response"
}

Update application profile

put

Updates the profile information (avatar and name) for a specific application

Authorizations

api-tokenstringRequired

Path parameters

appIDstringRequired

ID of the application to update profile for

Body

avatarURLstringRequired

URL to the application's avatar image

Example: https://i.ibb.co/0yJhZw92/Uma01.png

namestringRequired

Name of the application

Example: Discloud App

Responses

200

Profile updated successfully

application/json

401

Authentication error

application/json

404

Application not found

application/json

put

/app/{appID}/profile

PUT /v2/app/{appID}/profile HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "avatarURL": "https://i.ibb.co/0yJhZw92/Uma01.png",
  "name": "Discloud App"
}

{
  "status": "ok",
  "statusCode": 200,
  "message": "Profile successfully modified!"
}

List files and directories

get

List files and directories in the application's directory

Authorizations

api-tokenstringRequired

Path parameters

appIDstringRequired

ID of the application

Query parameters

cPathstringOptional

Directory path (defaults to app workDir)

Responses

200

Files and directories listed successfully

application/json

401

Authentication error

application/json

403

No permission or insufficient plan

application/json

404

Application not found or invalid path

application/json

get

/app/{appID}/explorer

GET /v2/app/{appID}/explorer HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "path": "/root/app",
  "dir": [
    {
      "name": "index.js",
      "type": "file",
      "size": 1024
    },
    {
      "name": "src",
      "type": "directory"
    }
  ]
}

Create file or directory

post

Create a new file or directory in the application

Authorizations

api-tokenstringRequired

Path parameters

appIDstringRequired

ID of the application

Body

typeFilestring · enumRequired

Type to create

Possible values:

cPathstringRequired

Full path for new file or directory

Responses

200

File or directory created successfully

application/json

400

Bad request - missing required fields

application/json

401

Authentication error

application/json

403

No permission or insufficient plan

application/json

404

Application not found or invalid path

application/json

post

/app/{appID}/explorer

POST /v2/app/{appID}/explorer HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "typeFile": "file",
  "cPath": "text"
}

{
  "status": "ok",
  "path": "/root/app/newfile.js"
}

Open/read file

get

Read the contents of a file in the application

Authorizations

api-tokenstringRequired

Path parameters

appIDstringRequired

ID of the application

Query parameters

cPathstringRequired

Full file path

Responses

200

File opened successfully

application/json

401

Authentication error

application/json

403

No permission or insufficient plan

application/json

404

File not found or invalid path

application/json

get

/app/{appID}/explorer/open

GET /v2/app/{appID}/explorer/open?cPath=text HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "path": "/root/app/index.js",
  "name": "index.js",
  "content": "console.log('Hello World');",
  "message": ""
}

Edit file

put

Edit the contents of a file in the application

Authorizations

api-tokenstringRequired

Path parameters

appIDstringRequired

ID of the application

Body

fileContentstringRequired

New file content

cPathstringRequired

Full file path

Responses

200

File edited successfully

application/json

400

Bad request - missing required fields

application/json

401

Authentication error

application/json

403

No permission or insufficient plan

application/json

404

File not found or invalid path

application/json

put

/app/{appID}/explorer/edit

PUT /v2/app/{appID}/explorer/edit HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "fileContent": "text",
  "cPath": "text"
}

{
  "status": "ok",
  "path": "/root/app/index.js"
}

Execute command in container

put

Execute a command inside the application container

Authorizations

api-tokenstringRequired

Path parameters

appIDstringRequired

ID of the application

Body

cmdstringRequired

Command to execute in the container

Responses

200

Command executed successfully

application/json

401

Authentication error

application/json

403

No permission - only app owner can execute commands

application/json

404

Application not found or offline

application/json

put

/app/{appID}/exec

PUT /v2/app/{appID}/exec HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "cmd": "ls -la"
}

{
  "status": "ok",
  "statusCode": 200,
  "message": "ok",
  "exec": {
    "stdout": "total 48\ndrwxr-xr-x 5 user user 4096 Dec 17 10:30 .\n...",
    "stderr": "",
    "exitCode": 0
  }
}

Delete application

delete

Permanently deletes an application

Authorizations

api-tokenstringRequired

Path parameters

appIDstringRequired

ID of the application to delete

Responses

200

Application deleted successfully

application/json

401

Authentication error

application/json

404

Application not found

application/json

delete

/app/{appID}/delete

DELETE /v2/app/{appID}/delete HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Your application has been removed."
}