POST
/
v1
/
apps
/
{id}
/
commit
Upload Commit for Application
curl --request POST \
  --url https://api.vertracloud.app/v1/apps/{id}/commit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "message": "<string>",
  "version": "<string>",
  "version_increment": "<string>"
}'
{
  "status": "success",
  "response": {
    "id": "app_123",
    "owner_id": "user_456",
    "name": "My Application",
    "description": "Sample description",
    "cluster": 1,
    "status": "running",
    "ram": 1024,
    "type": 1,
    "language": "nodejs",
    "domain": "myapp.vertraweb.app",
    "custom_domain": null,
    "auto_restart": true,
    "created_at": "2025-08-14T20:00:00.000Z",
    "updated_at": "2025-08-14T20:30:00.000Z",
    "last_commit": "2025-08-14T20:30:00.000Z"
  }
}
​
id
string
required
The ID of the application to upload a commit for. If the application belongs to an organization, include the organization ID in the format appId-orgId.
​
restart
string
If set to “true”, the application will automatically restart after the commit is uploaded.
​
file
file
required
The commit file to be uploaded in zip format.
​
message
string
Optional commit message describing the changes.
​
version
string
Optional version to assign to the commit.
​
version_increment
string
Increment type for versioning. Possible values: major, minor, patch.

​
Response

​
status
string
Indicates whether the call was successful. success if successful, error if not.
​
response
object
Information about the application after the commit upload.
{
  "status": "success",
  "response": {
    "id": "app_123",
    "owner_id": "user_456",
    "name": "My Application",
    "description": "Sample description",
    "cluster": 1,
    "status": "running",
    "ram": 1024,
    "type": 1,
    "language": "nodejs",
    "domain": "myapp.vertraweb.app",
    "custom_domain": null,
    "auto_restart": true,
    "created_at": "2025-08-14T20:00:00.000Z",
    "updated_at": "2025-08-14T20:30:00.000Z",
    "last_commit": "2025-08-14T20:30:00.000Z"
  }
}

​
Error Responses

​
status
string
Indicates whether the call was successful. error if not.
​
code
string
The error code indicating the reason for failure. Possible values:
  • UNAUTHORIZED: The user is not authenticated or lacks sufficient permissions.
  • FORBIDDEN: The user does not have access to the project.
  • APP_NOT_FOUND: The application was not found.
  • NO_FILE_UPLOADED: No file was provided for the commit.
  • FILE_TOO_LARGE: Uploaded file exceeds the maximum allowed size.
  • UPLOAD_COMMIT_FAILED: Failed to upload the commit.
  • OWNER_APP_WITHOUT_LIMITS: The owner has no resource limits defined.
{
  "status": "error",
  "code": "UNAUTHORIZED"
}