Start Application
curl --request POST \
--url https://api.vertracloud.app/v1/apps/{id}/startimport requests
url = "https://api.vertracloud.app/v1/apps/{id}/start"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.vertracloud.app/v1/apps/{id}/start', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vertracloud.app/v1/apps/{id}/start",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/apps/{id}/start"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.vertracloud.app/v1/apps/{id}/start")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vertracloud.app/v1/apps/{id}/start")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_body{
"response": {
"status": "success"
}
}
Applications
Start Application
Starts an application by its ID.
POST
/
v1
/
apps
/
{id}
/
start
Start Application
curl --request POST \
--url https://api.vertracloud.app/v1/apps/{id}/startimport requests
url = "https://api.vertracloud.app/v1/apps/{id}/start"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.vertracloud.app/v1/apps/{id}/start', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.vertracloud.app/v1/apps/{id}/start",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/apps/{id}/start"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.vertracloud.app/v1/apps/{id}/start")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.vertracloud.app/v1/apps/{id}/start")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_body{
"response": {
"status": "success"
}
}
string
required
The application ID to start. If the application belongs to a workspace, pass its ID in the
workspace_id query parameter.string
If the application belongs to a workspace, the workspace’s ID. Required for workspace members acting on an application they don’t own.
Response
object
The response containing the operation status.
Show Toggle object
Show Toggle object
string
The operation status (
success).{
"response": {
"status": "success"
}
}
Error Responses
string
The error code indicating the reason for the failure. Possible values:
APP_NOT_FOUND: The specified application does not exist.ACCESS_DENIED: The user does not have permission to act on the application.APPLICATION_SHIELD_COOLDOWN: Vertra Shield temporarily paused the application; retry after the cooldown (403).OPERATION_IN_PROGRESS: Another lifecycle operation on the same application is already running (409). The container was not touched — wait a few seconds and retry. See Common Error Codes.
{
"code": "OPERATION_IN_PROGRESS"
}
This route shares a budget of 10 requests per minute per application with
restart and stop. See Rate Limiting.