Exit Documentation

Applications Endpoints

Upload application

post

Upload a new application to Discloud

Authorizations
Body
filestring · binaryRequired

Application file to upload (.ZIP format)

Responses
200

Upload response

application/json
Responseone of
or
post
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
Path parameters
appIDstringRequired

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

Responses
200

Application information retrieved successfully

application/json
get
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
Path parameters
appIDstringRequired

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

Responses
200

Application status retrieved successfully

application/json
get
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
Path parameters
appIDstringRequired

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

Responses
200

Application logs retrieved successfully

application/json
get
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
Path parameters
appIDstringRequired

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

Responses
200

Application backup generated successfully

application/json
get
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
Path parameters
appIDstringRequired

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

Responses
200

Application started successfully

application/json
put
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
Path parameters
appIDstringRequired

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

Responses
200

Application restarted successfully

application/json
put
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
Path parameters
appIDstringRequired

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

Responses
200

Application stop response

application/json
put
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
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
put
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
Path parameters
appIDstringRequired

ID of the application to update

Body
filestring · binaryRequired

Application file to upload (.ZIP format)

Responses
200

Commit response

application/json
put
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
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
put
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!"
}

Delete application

delete

Permanently deletes an application

Authorizations
Path parameters
appIDstringRequired

ID of the application to delete

Responses
200

Application deleted successfully

application/json
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 EndpointsNextTeam Management

Last updated