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."
}

hashtagUpload application

hashtagGet application information

hashtagGet application status

hashtagGet application logs

hashtagGet application backup

hashtagStart application

hashtagRestart application

hashtagStop application

hashtagUpdate application RAM

hashtagUpdate application code

hashtagUpdate application profile

hashtagList files and directories

hashtagCreate file or directory

hashtagOpen/read file

hashtagEdit file

hashtagExecute command in container

hashtagDelete application

Upload application

Get application information

Get application status

Get application logs

Get application backup

Start application

Restart application

Stop application

Update application RAM

Update application code

Update application profile

List files and directories

Create file or directory

Open/read file

Edit file

Execute command in container

Delete application