POST
/
v1
/
apps
Create Application
curl --request POST \
  --url https://api.vertracloud.app/v1/apps \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "memory": "<string>",
  "autorestart": "<string>",
  "start": "<string>",
  "main": "<string>",
  "version": "<string>",
  "name": "<string>",
  "description": "<string>",
  "organization_id": "<string>",
  "subdomain": "<string>",
  "envs": "<string>"
}'
{
  "status": "success",
  "response": {
    "id": "v111d4af8cd74272a284831fbae14a8v",
    "owner_id": "993591427428790342",
    "owner_plan_id": 1,
    "name": "Simple API",
    "description": "I have a description :)",
    "cluster": 1,
    "status": "up",
    "ram": 128,
    "type": 2,
    "language": "nodejs",
    "subdomain": "myapp.vertraweb.app",
    "custom_domain": null,
    "created_at": "2025-08-14T19:58:00Z",
    "updated_at": "2025-08-14T19:58:00Z",
    "last_commit": "2025-08-14T19:58:00Z",
    "last_backup": null
  }
}
​
file
file
required
The ZIP file containing the application code (max size: 100 MB).
​
memory
string
required
The amount of RAM to allocate for the application in MB.
​
autorestart
string
Whether the application should automatically restart (true or false). Requires plan support for auto-restart.
​
start
string
The start command for the application.
​
main
string
required
The main file of the application.
​
version
string
required
The version of the application runtime (recommended or latest).
​
name
string
required
The name of the application.
​
description
string
A description of the application.
​
organization_id
string
The ID of the organization to associate the application with, if applicable.
​
subdomain
string
The subdomain for the application (e.g., myapp). Requires plan support for web publishing.
​
envs
string
A JSON string containing an array of environment variables, each with key and value properties (max 25 variables, key max length 100, value max length 1000).

​
Response

​
status
string
Indicates whether the call was successful. success if successful, error if not.
​
response
object
The details of the created application.
{
  "status": "success",
  "response": {
    "id": "v111d4af8cd74272a284831fbae14a8v",
    "owner_id": "993591427428790342",
    "owner_plan_id": 1,
    "name": "Simple API",
    "description": "I have a description :)",
    "cluster": 1,
    "status": "up",
    "ram": 128,
    "type": 2,
    "language": "nodejs",
    "subdomain": "myapp.vertraweb.app",
    "custom_domain": null,
    "created_at": "2025-08-14T19:58:00Z",
    "updated_at": "2025-08-14T19:58:00Z",
    "last_commit": "2025-08-14T19:58:00Z",
    "last_backup": null
  }
}

​
Error Responses

​
status
string
Indicates whether the call was successful. error if not successful.
​
code
string
The error code indicating the reason for failure. Possible values:
  • UNAUTHORIZED: The user is not authenticated or lacks sufficient permissions.
  • USER_NOT_FOUND: The user’s plan could not be found.
  • NO_FILE_UPLOADED: No file was uploaded.
  • FILE_TOO_LARGE: The uploaded file exceeds the 100 MB limit.
  • INVALID_VERSION: The specified version is not recommended or latest.
  • TOO_MANY_ENV_VARIABLES: More than 25 environment variables were provided.
  • ENV_VARIABLE_TOO_LONG: An environment variable key or value exceeds length limits.
  • INVALID_MEMORY: The requested memory is invalid or exceeds plan limits.
  • SUBDOMAIN_ALREADY_IN_USE: The specified subdomain is already in use.
  • INVALID_SUBDOMAIN_LENGTH: The subdomain length is invalid (must be 5-63 characters).
  • FORBIDDEN_SUBDOMAIN: The specified subdomain is restricted.
{
  "status": "error",
  "code": "UNAUTHORIZED"
}