Ctrlk
Exit Documentation
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Applications

Upload application

post

Upload a new application to Discloud

Authorizations
api-tokenstringRequired
Body
filestring · binaryRequired

Application file to upload (.ZIP format)

projectIdstringOptional

Project ID to link the application to on upload (optional).

Responses
200

Upload response

application/json
or
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: 36

{
  "file": "binary",
  "projectId": "text"
}
{
  "status": "ok",
  "statusCode": 200,
  "message": "Your application has been successfully uploaded.",
  "app": {
    "id": "1745338954955",
    "type": 0,
    "name": "Bot javascript",
    "avatarURL": "https://i.imgur.com/bWhx7OT.png",
    "ram": 100,
    "apts": "",
    "clusterName": "fenrir",
    "exitCode": 0,
    "online": true,
    "ramKilled": false,
    "syncGit": null,
    "mainFile": "index.js",
    "lang": "javascript",
    "version": "latest",
    "addedAtTimestamp": 1719010867306,
    "autoRestart": false
  }
}

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
statusstringOptional
messagestringOptional
appsone ofOptional
or
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",
    "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
statusstringOptional
messagestringOptional
appsone ofOptional
or
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
statusstringOptional
messagestringOptional
appsone ofOptional
or
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
statusstringOptional
messagestringOptional
backupsone ofOptional
or
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
statusstringOptional
messagestringOptional
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
statusstringOptional
messagestringOptional
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
statusstringOptional
messagestringOptional
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
statusstringOptional
statusCodeintegerOptional
messagestringOptional
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
statusstringOptional
messagestringOptional
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
statusstringOptional
statusCodeintegerOptional
messagestringOptional
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
statusstringOptionalExample: ok
pathstringOptional

Current directory path

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
statusstringOptionalExample: ok
pathstringOptional

Operation target path

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
statusstringOptionalExample: ok
pathstringOptional

Full file path

namestringOptional

File name

contentstringOptional

File content

messagestringOptional
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
statusstringOptionalExample: ok
pathstringOptional

Operation target path

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
statusstringOptional
statusCodeintegerOptional
messagestringOptional
execone ofOptional
or
object · nullableOptional
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
statusstringOptional
messagestringOptional
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."
}
PreviousUser
NextEnvironment variable

Last updated