Get workflow error analytics
curl --request GET \
--url https://api.cloudcruise.com/runs/workflow/{workflow_id}/errors \
--header 'cc-key: <api-key>'import requests
url = "https://api.cloudcruise.com/runs/workflow/{workflow_id}/errors"
headers = {"cc-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'cc-key': '<api-key>'}};
fetch('https://api.cloudcruise.com/runs/workflow/{workflow_id}/errors', 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.cloudcruise.com/runs/workflow/{workflow_id}/errors",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"cc-key: <api-key>"
],
]);
$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.cloudcruise.com/runs/workflow/{workflow_id}/errors"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("cc-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.cloudcruise.com/runs/workflow/{workflow_id}/errors")
.header("cc-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cloudcruise.com/runs/workflow/{workflow_id}/errors")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["cc-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"workflow_id": "d4e5f6a7-89ab-45cd-ef01-456789012abc",
"timeframe": {
"start": "2025-10-01T00:00:00Z",
"end": "2025-10-29T23:59:59Z"
},
"total_errors": 15,
"error_groups": {
"ELEMENT_NOT_FOUND": {
"count": 8,
"errors": [
{
"session_id": "e5f6a7b8-9abc-4def-0123-56789abcdef0",
"created_at": "2025-10-29T10:00:00Z",
"error_code": "ELEMENT_NOT_FOUND",
"error_category": "RECOVERABLE_ERROR",
"message": "Element not found on page",
"error_details": "The selector did not match any elements on the page"
}
]
},
"NETWORK_TIMEOUT": {
"count": 7,
"errors": [
{
"session_id": "f6a7b8c9-abcd-4ef0-1234-6789abcdef01",
"created_at": "2025-10-29T11:00:00Z",
"error_code": "NETWORK_TIMEOUT",
"error_category": "RECOVERABLE_ERROR",
"message": "Request timed out",
"error_details": "The network request exceeded the timeout limit"
}
]
}
}
}Run API
Get workflow error analytics
Retrieves error analytics for a specific workflow within a time range. This endpoint provides:
- Aggregated error counts grouped by error code
- Detailed error information including session IDs, timestamps, and descriptions
- Support for filtering by time range to analyze error trends
- Configurable result limits for large error sets
GET
/
runs
/
workflow
/
{workflow_id}
/
errors
Get workflow error analytics
curl --request GET \
--url https://api.cloudcruise.com/runs/workflow/{workflow_id}/errors \
--header 'cc-key: <api-key>'import requests
url = "https://api.cloudcruise.com/runs/workflow/{workflow_id}/errors"
headers = {"cc-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'cc-key': '<api-key>'}};
fetch('https://api.cloudcruise.com/runs/workflow/{workflow_id}/errors', 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.cloudcruise.com/runs/workflow/{workflow_id}/errors",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"cc-key: <api-key>"
],
]);
$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.cloudcruise.com/runs/workflow/{workflow_id}/errors"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("cc-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.cloudcruise.com/runs/workflow/{workflow_id}/errors")
.header("cc-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cloudcruise.com/runs/workflow/{workflow_id}/errors")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["cc-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"workflow_id": "d4e5f6a7-89ab-45cd-ef01-456789012abc",
"timeframe": {
"start": "2025-10-01T00:00:00Z",
"end": "2025-10-29T23:59:59Z"
},
"total_errors": 15,
"error_groups": {
"ELEMENT_NOT_FOUND": {
"count": 8,
"errors": [
{
"session_id": "e5f6a7b8-9abc-4def-0123-56789abcdef0",
"created_at": "2025-10-29T10:00:00Z",
"error_code": "ELEMENT_NOT_FOUND",
"error_category": "RECOVERABLE_ERROR",
"message": "Element not found on page",
"error_details": "The selector did not match any elements on the page"
}
]
},
"NETWORK_TIMEOUT": {
"count": 7,
"errors": [
{
"session_id": "f6a7b8c9-abcd-4ef0-1234-6789abcdef01",
"created_at": "2025-10-29T11:00:00Z",
"error_code": "NETWORK_TIMEOUT",
"error_category": "RECOVERABLE_ERROR",
"message": "Request timed out",
"error_details": "The network request exceeded the timeout limit"
}
]
}
}
}Authorizations
API key-based authentication. Provide your CloudCruise API key in the cc-key header.
Path Parameters
Unique identifier for the workflow
Query Parameters
Start of the time range (ISO 8601 format)
Example:
"2025-10-01T00:00:00Z"
End of the time range (ISO 8601 format)
Example:
"2025-10-29T23:59:59Z"
Maximum number of errors to retrieve
Required range:
1 <= x <= 5000Response
Workflow error analytics successfully retrieved
Aggregated error analytics for a workflow within a specific time range
Unique identifier for the workflow
Example:
"d4e5f6a7-89ab-45cd-ef01-456789012abc"
Time range for the error analytics
Show child attributes
Show child attributes
Total number of errors in the time range
Example:
15
Errors grouped by error code
Show child attributes
Show child attributes
Example:
{ "ELEMENT_NOT_FOUND": { "count": 8, "errors": [ { "session_id": "e5f6a7b8-9abc-4def-0123-56789abcdef0", "created_at": "2025-10-29T10:00:00Z", "error_code": "ELEMENT_NOT_FOUND", "error_category": "RECOVERABLE_ERROR", "message": "Element not found on page", "error_details": "The selector did not match any elements on the page" } ] }, "NETWORK_TIMEOUT": { "count": 7, "errors": [ { "session_id": "f6a7b8c9-abcd-4ef0-1234-6789abcdef01", "created_at": "2025-10-29T11:00:00Z", "error_code": "NETWORK_TIMEOUT", "error_category": "RECOVERABLE_ERROR", "message": "Request timed out", "error_details": "The network request exceeded the timeout limit" } ] } }
Was this page helpful?

