Skip to main content
POST
/
v1
/
apps
/
create
cURL
curl --request POST \
  --url https://api.camposcloud.com/v1/apps/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'appName=My Application' \
  --form mainFile=index.py \
  --form exposedViaWeb=false \
  --form memoryMB=256 \
  --form autoRestartEnabled=true \
  --form startupCommand= \
  --form runtimeEnvironment=python \
  --form teamId=60c72b2f9b1e8d001c8e4f3b \
  --form file=@example-file
{
  "_id": "60c72b2f9b1e8d001c8e4f3a",
  "currentResourceMetrics": {
    "timestamp": "2025-07-19T17:57:05.069Z",
    "online": true,
    "uptime": 35980,
    "cpuUsagePercent": 0,
    "memoryUsageBytes": 43671552,
    "memoryLimitBytes": 268435456,
    "networkRxBytes": 228961,
    "networkTxBytes": 228190
  },
  "containerId": "da886ad3-88e9-4012-b893-130e87f6b747",
  "teamId": "60c72b2f9b1e8d001c8e4f3b",
  "restartRequired": false,
  "name": "My Application",
  "userId": "60c72b2f9b1e8d001c8e4f3a",
  "allocatedMemoryMB": 256,
  "allocatedVCpu": 8,
  "workerNodeId": {
    "_id": "60c72b2f9b1e8d001c8e4f3c",
    "nodeName": "ODIN"
  },
  "containerImage": "kevencampos/camposcloud-python",
  "exposedViaWeb": false,
  "startupCommand": "python -u index.py",
  "installDependenciesCmd": "pip install -r requirements.txt",
  "runtimeEnvironment": "python",
  "autoRestartEnabled": false,
  "status": "active",
  "createdAt": "2025-07-19T00:02:54.455Z",
  "updatedAt": "2025-07-19T17:57:05.069Z"
}
This endpoint has a rate limit of 1 request every 3 seconds.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data

Application data to create

​
file
file
required

Application file to upload (.zip only!!)

​
appName
string
required

The name of the application

Example:

"My Application"

​
mainFile
string
required

The main file of the application

Example:

"index.py"

​
memoryMB
integer
required

The amount of memory allocated to the application in MB

Example:

256

​
runtimeEnvironment
enum<string>
required

The runtime environment of the application

Available options:
python,
nodejs
Example:

"python"

​
exposedViaWeb
boolean
default:false

Indicates if the application is exposed via the web

Example:

false

​
autoRestartEnabled
boolean
default:false

Indicates if auto-restart is enabled for the application

Example:

true

​
startupCommand
string

The command used to start the application

Example:

""

​
teamId
string

The unique identifier of the team associated with the application, if you want to create the application in a team

Example:

"60c72b2f9b1e8d001c8e4f3b"

Response

Application created successfully

​
_id
string

The unique identifier of the application

Example:

"60c72b2f9b1e8d001c8e4f3a"

​
currentResourceMetrics
object | null

Current resource metrics of the application

​
containerId
string

The unique identifier of the container

Example:

"da886ad3-88e9-4012-b893-130e87f6b747"

​
teamId
string | null

The unique identifier of the team associated with the application

Example:

"60c72b2f9b1e8d001c8e4f3b"

​
restartRequired
boolean

Indicates if a restart is required for the application

Example:

false

​
name
string

The name of the application

Example:

"My Application"

​
userId
string

The unique identifier of the user who owns the application

Example:

"60c72b2f9b1e8d001c8e4f3a"

​
allocatedMemoryMB
integer

The amount of memory allocated to the application in MB

Example:

256

​
allocatedVCpu
integer

The number of virtual CPUs allocated to the application

Example:

8

​
workerNodeId
object
​
containerImage
string

The Docker image used for the application

Example:

"kevencampos/camposcloud-python"

​
exposedViaWeb
boolean

Indicates if the application is exposed via the web

Example:

false

​
startupCommand
string

The command used to start the application

Example:

"python -u index.py"

​
installDependenciesCmd
string

The command used to install dependencies for the application

Example:

"pip install -r requirements.txt"

​
runtimeEnvironment
string

The runtime environment of the application

Example:

"python"

​
autoRestartEnabled
boolean

Indicates if auto-restart is enabled for the application

Example:

false

​
status
string

The current status of the application

Example:

"active"

​
createdAt
string<date-time>

The date and time when the application was created

Example:

"2025-07-19T00:02:54.455Z"

​
updatedAt
string<date-time>

The date and time when the application was last updated

Example:

"2025-07-19T17:57:05.069Z"