curl --request POST \
--url https://api.getcargo.io/v1/hosting/deployments/count \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"appUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workerUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"userUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"statuses": [],
"createdAfter": "<string>",
"createdBefore": "<string>"
}
'import requests
url = "https://api.getcargo.io/v1/hosting/deployments/count"
payload = {
"appUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workerUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"userUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"statuses": [],
"createdAfter": "<string>",
"createdBefore": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
appUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
workerUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
userUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
statuses: [],
createdAfter: '<string>',
createdBefore: '<string>'
})
};
fetch('https://api.getcargo.io/v1/hosting/deployments/count', 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.getcargo.io/v1/hosting/deployments/count",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'appUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'workerUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'userUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'statuses' => [
],
'createdAfter' => '<string>',
'createdBefore' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.getcargo.io/v1/hosting/deployments/count"
payload := strings.NewReader("{\n \"appUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"workerUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"userUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"statuses\": [],\n \"createdAfter\": \"<string>\",\n \"createdBefore\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
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.getcargo.io/v1/hosting/deployments/count")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"appUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"workerUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"userUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"statuses\": [],\n \"createdAfter\": \"<string>\",\n \"createdBefore\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getcargo.io/v1/hosting/deployments/count")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"appUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"workerUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"userUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"statuses\": [],\n \"createdAfter\": \"<string>\",\n \"createdBefore\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"count": 4503599627370495
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}Count deployments
Count deployments for an app or worker (POST /hosting/deployments/count).
curl --request POST \
--url https://api.getcargo.io/v1/hosting/deployments/count \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"appUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workerUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"userUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"statuses": [],
"createdAfter": "<string>",
"createdBefore": "<string>"
}
'import requests
url = "https://api.getcargo.io/v1/hosting/deployments/count"
payload = {
"appUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workerUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"userUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"statuses": [],
"createdAfter": "<string>",
"createdBefore": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
appUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
workerUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
userUuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
statuses: [],
createdAfter: '<string>',
createdBefore: '<string>'
})
};
fetch('https://api.getcargo.io/v1/hosting/deployments/count', 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.getcargo.io/v1/hosting/deployments/count",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'appUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'workerUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'userUuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'statuses' => [
],
'createdAfter' => '<string>',
'createdBefore' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.getcargo.io/v1/hosting/deployments/count"
payload := strings.NewReader("{\n \"appUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"workerUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"userUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"statuses\": [],\n \"createdAfter\": \"<string>\",\n \"createdBefore\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
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.getcargo.io/v1/hosting/deployments/count")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"appUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"workerUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"userUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"statuses\": [],\n \"createdAfter\": \"<string>\",\n \"createdBefore\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getcargo.io/v1/hosting/deployments/count")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"appUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"workerUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"userUuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"statuses\": [],\n \"createdAfter\": \"<string>\",\n \"createdBefore\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"count": 4503599627370495
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}{
"errorMessage": "<string>",
"reason": "<string>"
}Authorizations
API token from cargo-ai login. Send as Authorization: Bearer <token>.
Headers
Client-generated key that makes this write safe to retry. Reusing the same key with the same request returns the original response instead of creating a second record. Reusing it with a different request returns 422. A concurrent retry while the first request is still running returns 409. Keys expire after 24 hours. Not accepted on multipart file uploads. Optional: a request without one is processed as it always was.
255"8e03978e-40d5-43e8-bc93-6894a57f9324"
Body
Body schema.
Identifier of the app whose deployments to count.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Identifier of the worker whose deployments to count.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Restrict to deployments created by this user.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Deployment statuses to include.
pending, building, success, error, cancelled Include deployments created after this ISO timestamp.
Include deployments created before this ISO timestamp.
Response
Count deployments
Number of deployments matching the filters.
0 <= x <= 9007199254740991Was this page helpful?

